在文章末尾有没有一种方法可以将元数据添加到docbook文章中

时间:2018-07-12 19:37:12

标签: docbook

我从上至下呈现了docbook文章,如果遇到某些错误,我需要在元数据中添加一个标记。我可以在末尾添加代表该标志的最佳标签是什么?我正在写articleinfo作为文章中的第一个标签,所以我不能使用它。有最佳实践吗?

1 个答案:

答案 0 :(得分:1)

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

注意::由于提到了articleinfo,我假设您使用DocBook 4.5。 DocBook 5.x中不推荐使用此元素,而推荐使用info元素,它是所有顶级结构类型(booksarticles等)的通用元数据根元素。

这里有一些需要引起您注意的地方。

类型或错误

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

    • 结构错误-即再次验证DocBook模式。
    • 布局错误-也就是说,您不喜欢文章在印刷品上的显示方式。
    • 与文本有关的
    • 基于逻辑的错误-也就是说,您不想长句子等。

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

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

DocBook作为文档词汇

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

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