html - DocBook：如何链接到另一个手册页？

Question

我正在 DocBook 中编写几个手册页。我还想将它们转换为 HTML 以在网络上显示。如何插入从一个手册页到另一个手册页的链接，以使其显示man为target(1)但在 Web 上显示为指向另一个手册页的超链接，该手册页也已转换为同一目录中的单独 HTML 文件？

Answer 1

我想我已经想通了。您应该<citerefentry/>在文档中使用 a ，它会按预期出现在手册页中。它不会在 HTML 文档中超链接，除非您提供生成目标 URL 的方法，您在自定义层中执行该方法。

以下是手册页中“另见”部分的示例文档片段：

<refsect1 id="seealso">
    <title>See Also</title>
    <simplelist type="inline">
        <member><citerefentry><refentrytitle>grep</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
        <member><citerefentry><refentrytitle>awk</refentrytitle><manvolnum>1P</manvolnum></citerefentry></member>
    </simplelist>
</refsect1>

再加上这个自定义模板（另存为custom.xsl）

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

    <!-- Ignore spaces between elements (without this, the URL is "grep    .html" -->
    <xsl:strip-space elements="*"/>

    <!-- Turn citerefentry elements into HTML links -->
    <xsl:param name="citerefentry.link" select="1"/>

    <!-- Code to generate the URL for a given citerefentry element -->
    <xsl:template name="generate.citerefentry.link">
        <xsl:value-of select="refentrytitle"/>
        <xsl:text>.html</xsl:text>
    </xsl:template>
</xsl:stylesheet>

使用xmlto程序处理 DocBook XML，为 HTML 指定自定义层：

$ xmlto man input.xml
$ xmlto html-nochunks -m custom.xsl input.xml

在手册页中，这会产生：

SEE ALSO
       grep(1), awk(1P)

在 HTML 中它会产生这个：（<span>为清楚起见，所有元素都被删除了）

<h2>See Also</h2>
<a href="grep.html">grep(1)</a>, <a href="awk.html">awk(1)</a>

生成的实际 URL 可以通过generate.citerefentry.link在custom.xsl. 上面的示例仅使用<refentrytitle>来自 DocBook XML 的值并将“.html”附加到它。