0

这个 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 生成的 HTML 中，但我没有对此进行测试）。

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

这可能吗？

4

1 回答 1

0

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

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

[footer]
    </body>
</html>

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

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

于 2014-04-08T14:51:31.370 回答