xml - DocBook:指定代码或标记

Question

您可以使用 <equation> 指定方程式还有其他几个，但是必须使用什么标签来指定代码？更具体地说，PHP、HTML、CSS 和 Javascript？有没有可以与 OxygenXML 一起使用的插件来自动添加这些功能？我需要输出为 PDF。

Answer 1

我正在开发一个使用 docbook 并有 PHP 示例的项目。

PHP 中的示例使用的是 programlisting标签，像这样:

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

// Here goes the PHP code

]]></programlisting>

注意语言属性。
稍后在生成输出时(至少对于 HTML 输出)，另一个工具会使用它来添加语法着色

对于不特定于一种编程语言的示例，如配置文件，我们使用 screen标签 ;例如，对于与 Apache 相关的配置文件的一部分，示例如下:

<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>

引用他们的文档:

A programlisting is a verbatim environment for program source or source fragment listings. The programlistings are often placed in examples or figures so that they can be cross-referenced from the text.

和:

A screen is a verbatim environment for displaying text that the user might see on a computer terminal. It is often used to display the results of a command.

Having less specific semantic overtones, screen is often used wherever a verbatim presentation is desired, but the semantic of programlisting is inappropriate.

所以，这两个似乎很合适。