Hipo Info Manager

Una extensión de VS Code para gestionar proyectos de información estructurada con templates y documentos compartidos.

Características

• Gestión de proyectos: Crea y organiza proyectos de información.
• Sistema de templates: Define templates reutilizables para el formato de tus documentos.
• Documentos globales: Crea documentos compartidos accesibles desde cualquier proyecto.
• Detección de enlaces: Procesa automáticamente URLs y las convierte en documentos.
• Composición modular: Importa secciones específicas de documentos locales o globales.
• Previsualización de salida: Procesa templates y visualiza el resultado.

Tipos de archivos

Hipo Info Manager trabaja con varios tipos de archivos especializados:

• .hipo: Archivos principales que definen la estructura y composición del documento.
• .rhipo: Archivos de contenido que contienen secciones de texto estructuradas.
• .thipo: Archivos de template que definen el formato y la estructura visual.
• .shipo: Archivos de salida generados al procesar templates.

Comenzando

1. Crear un proyecto

1. Abre la vista del explorador de Hipo (icono de Hipo en la barra de actividad)
2. Haz clic en "+" para crear un nuevo proyecto
3. Dale un nombre a tu proyecto

2. Trabajar con documentos globales

Los documentos globales te permiten compartir contenido entre proyectos:

1. Navega a la carpeta "Documents" en el explorador de Hipo
2. Haz clic derecho y selecciona "Create New Document"
3. Edita el documento con secciones usando la sintaxis ## NombreSeccion

3. Crear y usar templates

1. Navega a la carpeta "Templates" en el explorador de Hipo
2. Haz clic derecho y selecciona "Create New Template"
3. Define tu template con placeholders como [[titulo]], [[cuerpo]], etc.

4. Importar y componer documentos

En tus archivos .hipo, puedes importar secciones de documentos:

// Importar secciones de un archivo local
import {Section1, Section2} from "./content";

// Importar secciones de un documento global
import {Co, Es} from "countries";

// Usar un template
use GetTree

// Definir variables para el template
$ title: Países
$ content: {{ Co }}
$ tree: data [[ Section1 ]] ...

Sintaxis de los archivos

Archivo .rhipo (Contenido)

## Section1
Este es el contenido de la primera sección.

## Section2
Este es el contenido de la segunda sección.

Archivo .thipo (Template)

template MiTemplate
--------------------------------
[[titulo]]
--------------------------------
[[cuerpo]]
--------------------------------
[[pie]]
--------------------------------

Archivo .hipo (Principal)

import {Section1, Section2} from "./content";
import {Co} from "countries";

use TemplateBase

$ titulo: Mi Título
$ cuerpo: 
{{ Section1 }}
{{ Co }}
$ pie: {{ Section2 }}

Cómo usar documentos globales

Los documentos globales permiten compartir contenido entre proyectos:

1. Crea un documento en la carpeta "Documents"

2. En cualquier proyecto, importa secciones con:

   import {SeccionA, SeccionB} from "nombreDocumento";
   

3. Usa las secciones importadas en tus templates con la sintaxis {{ SeccionA }}