![]() | ![]() | Programación en el entorno GNOME | ![]() |
---|
Tabla de contenidos
Para la creacin de articulos/libros/tutoriales/etc se hace necesario utilizar un medio de documentacin estandar de manera que la modificacin de los documentos fuentes sea ms sencilla al igual que la generacin de estos en diferentes formatos sea un paso trivial.
La documentacin estructurada se construye sobre elementos estructurados: captulos, secciones, prrafos, etc. donde los elementos se etiquetan claramente para que son: referencias, salida de programas, etc. No se da ningna informacin explcita sobre como el documento debe ser escrito, solamente sobre su estructura y contenido.
Esto permite el proceso automtico de los documentos, animando a los autores a que se concentren en el contenido de los documentos y no en el como generarlos.
Asi, el preguntarse "como colocar una palabra en negrilla con SGML?" tiene poca importancia, lo que uno se pregunta es como poner mas nfasis en un cierto texto.
El SGML (Standard Generalized Markup Languaje) es un lenguaje estandarizado prevista para facilitar la escritura de documentacin estructurada. Mas especificamente es un metalenguaje. Realmente no se escribe el documento en SGML, El SGML se utiliza para describir un lenguaje estructurado especifico para un tipo de documento, llamado DTD (Document Type Definition), que especifica como los documentos pueden ser escritos.
Por lo tanto decir que un documento est escrito en formato SGML es tcnicamente correcto, pero engaoso. Podra decir que un documento est escrito con el formato DocBook u otro formato definido en SGML.
SGML es un lenguaje de marcas. Todos los documentos incluyen texto mezclados con etiquetas que delimita los elementos. En el Ejemplo 1, “Uso de Etiquetas” se muestra el uso de las etiquetas.
Ejemplo 1. Uso de Etiquetas
<article> <title>Proyecto GNOME Chile</title> <para>Vamos que se puede!</para>
Se parace a HTML, pues HTML es tericamente un DTD de SGML. Los elementos tienen un contenido, por ejemplo el contenido del elemento "para" tiene "Vamos que se puede!".
Los elementos pueden tener cualidades, para indicar ms informacin, por ejemplo:
<example id="ejemplo1"> ..... </example>
Un elemento es especial, el elemento de la "raiz" que es el elemento global, que contiene a todo el documento. En XML, la linea DOCTYPE indica que elemento es la raiz. En el Ejemplo 2, “Elemento raiz de un documento” se muestra una linea de este tipo.
Como no es el propsito de este documento el hablar explcitamente sobre XML, slo diremos que los archivos XML comienzan primero con una "instruccin de proceso", que comienzan con <?, y en este caso indica que es un archivo XML, adems de cierta meta-informacin. Esto o vemos en el Ejemplo 3, “Encabezado de un archivo XML”.
Los archivos XML deben ser "bien formateados", es decir, las etiquetas de comienzo deben siempre tener una etiqueta de trmino. Tambin puede tener "elementos vacios" donde la etiqueta de inicio con la de trmino se convinan en una sola etiqueta escrita:
<etiqueta/>
Un DTD (Document Type Definicion) es la descripcin (en SGML) de un lenguaje especfico. Puede escribir su propio DTD o puede usar un DTD ya existente, con la ventaja de poder intercambiar documentos con otras personas. Existe varios DTDs, tipicamente para propsitos de un grupo de gente dado (astronomos, qumicos,etc).
El DTD enumera los elementos y sus relaciones permitidas, por ejemplo, un "capitulo" debe tener por lo menos una "seccin". Algunos DTDs que puede encontrar utiles son:
DocBook: Utilizado para la documentacin tcnica especialmente sobre software.
LinuxDoc: Utilizado por el proyecto de documentacin de Linux, por ejemplo para el Linux-COMO.
DebianDoc: Utilizado en parte por el proyecto de documentacin de Debian.
HTML: en teora es un DTD pero muy poca pginas actuales respetan su definicin.
<< libgnomedb | El DTD DocBook >> |