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>

引用他们的文档：

程序清单是用于程序源或源代码片段清单的逐字环境。节目单通常放在例子或图中，这样它们就可以从文本中交叉引用。

和：

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

由于具有较少的特定语义含意，屏幕通常用于需要逐字演示的地方，但节目清单的语义是不合适的。

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