D.9. 自定义你的 HTML 文件

D.9.1. HTML 文件名

默认情况下,当生成单独的 HTML 文件时,SGML 处理器会为生成的文件分配任意名称。这可能会让读者感到困惑,他们可能为某个页面添加了书签,但该页面却发生了更改。无论您的理由是什么,以下是如何按照您想要的方式命名单独的文件。

在您的第一个<article>标签(应该是唯一的标签)中包含一个id参数并将其命名为 "index"。这将使您的标签看起来像这样

<article id="index"> 

请勿修改第一个<chapter>标签,因为它通常是一个介绍,并且您希望它在第一页上。对于每个其他的<section>标签,包含 id 参数并为其命名。名称应仅包含字母数字字符,并且应足够短以便理解其含义。

 
	<chapter id="tips"> 

Note明智地选择 section ID
 

我们都知道 Cool URIs Don't Change。这意味着您的 id 也不应更改。除非当然 id 的内容已发生重大更改,并且 id 名称不再相关。

Warning使用 Jade 生成 HTML 文件名
 

如果您使用 Jade 将 DocBook 转换为 HTML,则必须使用以下参数-V %use-id-as-filename%.

D.9.2. 页眉和页脚

没有 "简单" 的方法向文档添加页眉和页脚。如果您使用 DocBook XSL 并进行自己的文档转换,您可以自定义 XSL 模板以满足您的需求。有关更多信息,请阅读 http://www.sagehill.net/docbookxsl/HTMLHeaders.html