| |
Nuevas |
Páginas cambiadas o recientemente agregadas
|
| []
[ ] |
|
|
| 237 |
Formato de contenido |
PaGEN guarda internamente en una base de datos el contenido de las páginas, pero este mismo contenido es
alimentado por medio de archivos de texto escritas en un formato especial que es facil de usar y modificar. La sintaxis es
como sigue:
...
...
...
x-content: tipo_de_contenido
x-tags: valor_del_tag
x-tags: valor_del_tag
...
...
...
|
Un archivo se divide por medio de pedazos de texto, conteniendo un identificador por línea. Muchos
pedazos de texto pueden ser incluidos en un mismo archivo de entrada, pero preferentemente hay que incluir uno solo.
Cada pedazo de texto comienza siempre con el identificador x-content:,
seguido de los tags correspondientes a este tipo de contenido. Estos tipos son tres:
- x-content: page. Identificando una página.
- x-content: text. Identificando un bloque de texto.
- x-content: category. Identificando una nueva categoría de páginas. (esta característica no
está plenamente desarrollada).
Después de los dos puntos del nombre del tag, no es necesario poner un espacio en blanco. Asimismo, todos los espacios o
tabuladores al final del renglon son ignorados.
Las lineas en blanco (que contengan solamente el retorno de carro, espacios en blanco o tabuladores) son borradas e ignoradas.
|
| [05/12/2001 19:57]
[ ] |
|
| 238 |
Formato de Página |
Para introducir una nueva página en PaGEN es necesario crear un archivo de texto que siga la siguiente sintaxis:
x-content: page
x-name: nombre_corto
x-category: directorio
x-file: archivo
x-parent: pagina_madre
x-icon: icono
x-title: titulo
|
Los tags content, name, category, file son obligatorias. Mientras que parent, icon y
title no lo son y tomarán valores por defecto en caso de no encontrarse presentes.
El siguiente ejemplo es una copia exacta del archivo que generó esta misma página.
x-content: page
x-name: pagen-manual-1
x-category: pagen-cat
x-file: man1
x-parent: pagen
x-icon: document.png
x-title: Manual de PaGEN
x-render: yes
|
Donde:
- x-name: pagen-manual-1, es el nombre corto que se le asigna a esta pagina dentro de la base de datos. Dicho en otras
palabras, es el identificador de la página y todos las referencias se hacen en base a este nombre. También
es la llave primaria de esta tabla.
- x-category: pagen-cat, indica la categoria a la que esta página pertenece. El manual y la descripción
(en este ejemplo) pertenecen a la misma categoría, porque están físicamente en el mismo directorio.
- x-file: man1, es el nombre real del archivo que se va a generar. Siempre se agrega .html al final del nombre al tiempo de
la generación.
- x-icon: document.png, esta característica no está plenamente desarrollada y todavía se encuentra en
prueba. No es obligatoria.
- x-title: Manual de PaGEN, es el título completo que se muestra finalmente. No es obligatoria y se pueden usar todo
tipo de caracteres.
- x-render: no, indica a PaGEN si la pagina se debe generar. Esta característica es útil cuando se quiere
incluir en el sitio páginas que fueron generadas por otros sistemas. Si se indica no, la página
será incluída en el mapa del sitio, en la lista de lo nuevo, en la navegación y otras referencias,
pero el archivo no será generado ni modificado. No es obligatoria.
|
| [05/12/2001 20:14]
[ ] |
|
|
Página principal | Programación | PaGEN | Generador Automático de Páginas | Manual de PaGEN 
