4.5. Dando información adicional

Una vez escrito un documento, es útil incluirle anexos en los cuales se profundiza algunos de los temas tratados en la estructura principal. A continuación presentamos dos anexos que serán parte de nuestro pequeño documento.

4.5.1. Incluyendo listados de programas

En nuestro pequeño documento vamos a incluir un apéndice con un listado del archivo hola.txt, para ello basta que usemos las marquillas programlisting. Es usual además que dichas listados vayan incluidas dentro de ejemplos, para lo cuál es útil usar la marquilla example o informalexample. A continuación presentamos un ejemplo usado en este documento y como es mostrado.

Atención

Note que la marquilla programlisting está justificada a la izquierda, es necesario hacer esto pues los espacios dentro de programlisting son significativos.

En caso de querer incluir un listado que incluya caracteres como < o &, el contenido dentro de programlisting se incluye dentro de CDATA, como se muestra a continuación

4.5.2. Preguntas Frecuentes

La sección de preguntas frecuentes o faq (Frequently Asked Questions) es quizás una de las más populares y leídas dentro de un documento técnico. A continuación presentamos un ejemplo de esto, como un apéndice de herramientas.sgml

Sugerencia

En caso de querer cambiar la numeración de las preguntas frecuentes, se utiliza el atributo defaultlabel. Las posibles opciones para dicho atributo son number, qanda y none.