首页 > 解决方案 > 有没有办法在文章末尾将元数据添加到 docbook 文章中

问题描述

我正在从上到下呈现文档文章,如果遇到某些错误,我需要在元数据中添加一个标志。我可以在最后添加代表此标志的最佳标签是什么?我正在写文章信息作为文章中的第一个标签,所以我不能使用它。对此有最佳做法吗?

标签: docbook

解决方案


我建议你对 DocBook 有一些误解。

注意:我假设您使用 DocBook 4.5,因为articleinfo提到了。此元素在 DocBook 5.x 中已弃用,取而代之的info是作为所有顶级结构类型( 、 等)的通用元数据根元素的books元素articles

以下是您需要注意的几点。

类型或错误

  1. 您可能会遇到几种类型的错误(假设您有格式良好的 xml 文件 - 这可能是另一种基本类型的错误):

    • 结构错误 - 即再次验证 DocBook 模式。
    • 版面错误——即您不喜欢您的文章在印刷品上的呈现方式。
    • 与文本有关的基于逻辑的错误 - 即您不想有长句子等。

根据错误类型,有不同的修复方法:

  • 结构错误 - 您不能在目标 DocBook 文件中放置此类错误的标志,因为结构错误会阻止目标 DocBook 被处理和/或生成。
  • 布局错误 - 这完全取决于您的最终目的地(打印、html 或只是 xml)所以答案是 -这取决于
  • 基于逻辑的错误 - 在这里,您完全有资格做您想做的事情并将您想要的任何信息放入您的 DocBook 文件中(请参阅下面的用例 1)。

DocBook 作为文档词汇

DocBook 是基于 XML 的词汇表,因此您可以使用除 DocBook XSLT 样式表(及其定制)之外的 xslt 样式表进行任何 XML -> XML 处理。

用例 1:您想检查您的文章是否包含某些元素(即guimenu)。如果是,您想在您的 articleinfo 元素中放置一个标志。您编写自己的 xsl 样式表以根据您的条件生成带有符号的最终 DocBook 文件。此样式表不必与默认的 DocBook XSL 样式表有任何联系。


推荐阅读