DocBook:指定代码或标记

我正在开发一个使用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>

引用文件:

程序列表是逐字的。 程序源环境或 源片段列表。这个 节目表通常放在 示例或数字以便 从文本中交叉引用。

还有:

屏幕是用于 显示用户可能 请参见计算机终端上的。它是 通常用于显示 命令。

不太具体的语义 泛音,通常使用屏幕 无论口头陈述在哪里 期望,但语义 程序列表不正确。

所以,这两个看起来很合适。