DocBook: Especificación de código o marcado

Question

Puede especificar ecuaciones usando <equation> y también varios otros, pero lo que la etiqueta debe ser utilizado para especificar el código? Más específicamente, PHP, HTML, CSS y Javascript? ¿Existe un plugin que se puede utilizar con OxygenXML añadir estas características de forma automática? Necesito salida como PDF.

Answer 1

Estoy trabajando en un proyecto que utiliza docbook, y tiene ejemplos en PHP.

Los ejemplos en PHP están utilizando programlisting etiqueta, como este:

<programlisting language="php"><![CDATA[<?php

// Here goes the PHP code

]]></programlisting>

Tenga en cuenta el atributo de idioma.
Se utiliza más tarde por otra herramienta para añadir sintaxis de coloración, al generar el ouput (para la salida HTML, al menos)

Para ver ejemplos que no son específicos de un lenguaje de programación, al igual que los archivos de configuración, estamos utilizando el rel="noreferrer"> screen etiqueta; Por ejemplo, para una parte de un archivo de configuración relacionados con Apache, un ejemplo sería:

<screen><![CDATA[# Setup Listening Port
NameVirtualHost *:80

# Ensure "localhost" is preserved unchanged pointed
# to the default document root for our system.
<VirtualHost *:80>
    ServerName localhost
    DocumentRoot /var/www
</VirtualHost>]]></screen>

Citando sus documentaciones:

  

A programlisting es un pie de la letra   ambiente para la fuente del programa o   listados de fragmentos de origen. los   programlistings se colocan a menudo en   ejemplos o figuras de manera que puedan   una referencia cruzada a partir del texto.

Y:

  

Una pantalla es un entorno verbatim para   la visualización de texto que el usuario pueda   ver en una terminal de computadora. Está   a menudo se utiliza para mostrar los resultados de una   comandos.

     

Tener menos específico semántica   armónicos, la pantalla se utiliza a menudo   siempre que sea una presentación textual es   deseado, pero la semántica de   programlisting es inapropiada.

Por lo tanto, estos dos parecen bastante apropiado.