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>

引用他们的文件:

程序列表是程序源或源片段列表的逐字环境.程序列表通常放在示例或图中,以便可以从文本中进行交叉引用.

而且:

屏幕是用于显示用户可能在计算机终端上看到的文本的逐字环境.它通常用于显示命令的结果.

具有较少特定的语义泛音,屏幕通常用于需要逐字呈现的任何地方,但是节目列表的语义是不合适的.

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