Question

此AsciiDoc块将创建标题和当前修订信息：

Writing Documentation using AsciiDoc
====================================
v2.0, February 2003:
Rewritten for version 2 release.

docinfo_generator将从AsciiDoc格式的文档中的注释块中提取此信息，然后将其嵌入docinfo.xml文件中：

////
:revinfo:
v1.0.3, Joseph HERLANT, 2013-08-18:
  It matched only the last group. Correcting this to get only the first of each groups
  to avoid getting data in the content of the document if defined in the header
v1.0.2, Joseph HERLANT, 2013-07-05: Adding a verbose flag to show more informations while processing data.
v1.0.1, Laurent LICOUR, 2013-06-05:
  Correcting documentation.
  If attributes were absent, the document did not generate. This is corrected now.
////

虽然有用，但修订历史记录不会包含在asciidoc生成的HTML中（它可能是在a2x-gerneated HTML中，但我没有对此进行过测试）。

我想找到一种方法将整个修订历史记录嵌入到asciidoc格式的文档中，然后将其显示（理想情况下）作为表格显示在所述文档的末尾。

这可能吗？

Answer 1

您可以在[header]或单独的文件中定义[footer]和asciidoc.conf部分，然后将其插入-f命令行开关。这些部分包含HTML代码，插入{attr-name}您需要插入信息的位置。例如

[header]
<html>
    <head>
        <title>{title}</title>
    </head>
    <body>

[footer]
    </body>
</html>

在标题标记中设置文档标题。

实际上我将这些部分用作HTML模板，因此在那里定义了所有HTML页面，AsciiDoc编译的代码将插入两个部分之间。

AsciiDoc文档的自动，表格格式的修订历史记录

1 个答案: