我怎样才能在 asciidoctor 中命名实体？

Question

我将 asciidoctor 与 docbook 后端一起用于书籍。过去我写了 DocBook，它允许我声明我在整本书中使用的命名实体：

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE book [
<!ENTITY class     "Galactic TOP SECRET">
<!ENTITY project   "World Domination">
<!ENTITY product   "Illuminati Mind Control Chemtrail Spray System CSS-2020">
]>
<book ...>
     ...
     What about our &class; &project;?
     Is our &product; working?
     ...
</book>

:-) 我还没有找到告诉 asciidoctor 在 XML 处理指令和 <book> 元素之间插入 DOCTYPE 声明的方法。所以我求助于 --no-header-footer 并在页眉和页脚行前面加上。有一个更好的方法吗？类似命名实体定义指令的东西？包含机制？

Answer 1

您必须使用 Docbook 实体声明吗？ Asciidoctor 有 "attributes" 可以达到同样的目的：https://asciidoctor.org/docs/user-manual/#attributes

例如，您可以在文档中定义一个属性：

:class: Galactic TOP SECRET

然后在您的文档中，您可以使用属性：

"Billy, come up to the front and address the {class}." said the teacher.

将文档转换为 Docbook 时，您会看到：

<simpara>"Billy, come up to the front and address the Galactic TOP SECRET."
said the teacher.</simpara>

如果您确实必须使用 Docbook 实体声明，您可以使用一些 XSL 将您获得的 XML 转换为您想要的 XML。

我怎样才能在 asciidoctor 中命名实体？

How can I have named entities in asciidoctor?

doctype

entity

asciidoctor