默认情况下,当生成单独的 HTML 文件时,SGML 处理器会为生成的文件分配任意名称。这可能会让读者感到困惑,他们可能为某个页面添加了书签,但该页面却发生了更改。无论您的理由是什么,以下是如何按照您想要的方式命名单独的文件。
在您的第一个<article>标签(应该是唯一的标签)中包含一个id参数并将其命名为 "index"。这将使您的标签看起来像这样
<article id="index"> |
请勿修改第一个<chapter>标签,因为它通常是一个介绍,并且您希望它在第一页上。对于每个其他的<section>标签,包含 id 参数并为其命名。名称应仅包含字母数字字符,并且应足够短以便理解其含义。
<chapter id="tips"> |
![]() | 明智地选择 section ID |
---|---|
我们都知道 Cool URIs Don't Change。这意味着您的 id 也不应更改。除非当然 id 的内容已发生重大更改,并且 id 名称不再相关。 |
![]() | 使用 Jade 生成 HTML 文件名 |
---|---|
如果您使用 Jade 将 DocBook 转换为 HTML,则必须使用以下参数-V %use-id-as-filename%. |
没有 "简单" 的方法向文档添加页眉和页脚。如果您使用 DocBook XSL 并进行自己的文档转换,您可以自定义 XSL 模板以满足您的需求。有关更多信息,请阅读 http://www.sagehill.net/docbookxsl/HTMLHeaders.html。