Debian GNU/Linux Reference Guide
Prev	Home	Next

13.9.2 SGML

Preparaci�n:

     # apt-get install debiandoc-sgml debiandoc-sgml-doc

Referencias de debiandoc-sgml:

• /usr/share/doc/debiandoc-sgml-doc

• debiandoc-sgml(1)

• DocBook: The Definitive Guide, de Walsh y Muellner, (O'Reilly) (paquete docbook-defguide)

SGML permite la creaci�n de m�ltiples formatos de un mismo documento. Un sistema SGML sencillo es Debiandoc que es el que se us� aqu�. Este requiere de peque�as adaptaciones en los archivos de texto originales para los siguientes caracteres:

• "<" --> &lt;

• ">" --> &gt;

• " " --> &nbsp; (espacio sin ruptura)

• "&" --> &amp;

• "%" --> &percnt;

• "©" --> &copy;

• "–" --> &ndash;

• "—" --> &mdash;

Para marcar una secci�n como comentario, escriba:

     <!-- El tema empieza aqu� ... -->

Para marcar una secci�n que necesita modificarse, escriba:

     <![ %FIXME [ El tema empieza aqu� ... ]]>

En SGML, la primer definici�n de una entidad gana. Por ejemplo:

     <!entity % qref "INCLUDE">
     <![ %qref [ <!entity param "Datos 1"> ]]>
     <!entity param "Datos 2">
     &param;

Esto finaliza como "Datos 1". Si en la primer l�nea figurara "IGNORE" en vez de "INCLUDE" finalizar�a como "Datos 2" (la segunda l�nea es una sentencia condicional). Asimismo, las frases que se repiten se pueden definir de antemano separadas del contexto.

     <!entity esto "mi">
     Hola &esto; amigo.
     Este es &esto; libro.

Esto resulta en lo siguiente:

     Hola mi amigo.
     Este es mi libro.

Vea el peque�o ejemplo en SGML sample.sgml en los ejemplos.

Cuando los documentos SGML aumentan de tama�o TeX, que es utilizado como interfaz del procesador de texto, puede provocar,a veces, errores TeX/LaTeX, Secci�n 13.9.3.

---

Debian GNU/Linux Reference Guide
Prev	Home	Next