问题标签 [asciidoctor]

我正在尝试将 .adoc 文件转换为 .docx

实际上我正在使用：

我在 .adoc 中的数学方程式或符号等于：

它在转换为 docx 后返回 .docx 中的奇怪行：

有什么提示吗？

我有一个两段文字，经常重复。我怎样才能避免重复？

现在我有：

接着：

有没有办法可以将两段都放在一个属性中？如果我也可以将块放入属性中会更好。

这不起作用：

空行上的加号和第二段不被解析为属性定义的一部分。

另一种选择是将两个段落放在单独的文件中并使用include:宏。但是每次我遇到这个问题时创建一个单独的文件会造成一些混乱。这也使得从 1 段定义变为 2 段定义变得比必要更难。我宁愿有一个包含所有这些重复术语定义的“词汇表”部分（或文档）。

我有很多用 AsciiDoc 编写的文档并正确地分成文件夹。我使用带有自定义 CSS 的 asciidoctor 将我的文档呈现为 HTML。这样做的问题是它会生成一个很长的HTML 页面。我在网上冲浪，发现 atom docs 也是用 AsciiDoc 编写的，但是这些 docs 并没有将所有信息放在一起，实际上它们被分成不同的部分。

这里是原子文档：https ://atom.io/docs/v0.201.0/getting-started-why-atom

我想知道是否有一个工具可以生成这个，一个标志或一个特定的语法。

我认为将所有信息放在一个长长的单页中并不是真正的用户友好。

如果我用 处理以下asciidoc文件asciidoctor，

结果如下所示：

但通常（如上面的代码中所暗示的）有趣的关键是简短的。

在这种情况下，我可以通过仅引用有趣的行并添加指向完整源文件的链接来保持整个 HTML 简洁。这会使读者脱离上下文，并迫使他们在 HTML 导航中前进/后退。

相反，我正在寻找一种方法来保持通过在 html 页面中滚动来访问完整代码，同时只显示有趣的部分。这可能与 asciidoctor 吗？

嘿，在 asciidoc 中存在一种创建预处理器宏的方法吗？

asciidoc 中的宏允许我为不同的输出格式生成自定义命令。我的目标是创建有效的 asciidoc。

例如：

预处理器宏：#define pair() %1 and %2

利用：i think pair("a", "b") are the same

结果：i think a and b are the same

我希望你能明白。属性、特殊词和替换不满足此要求。还是我错了？

感谢您提供任何帮助。

如果 C++ 在一个句子中只出现一次， asciidoctor 就可以很好地解析字符串。

如果 C++ 出现两次，则 asciidoctorbar在下面的示例中匹配。

防止替换的各种尝试都不起作用。

如何使用 asciidoctor 在一个句子中排版 C++ 两次或多次？

我需要一种从 Asciidoc 文件中提取标签并将它们保存到 python 字典中的方法。我通常会写，Asciidoc但我不知道如何在 Asciidoc 中创建变量名，我可以将其提取为创建 python 字典的键。我一直在寻找文档，但无济于事。

所以我需要一种方法来将这个 asciidoc 标记转换成一个看起来像的字典

我试图将 asciidoc 文件转换为 xml，然后 xmltodict 将其转换为字典。但这并没有很好地工作，因为我在字典中得到了很多 xml 格式的东西。我查看了诸如 beautifulsoup 之类的各种解析器，但由于 asciidoc 不使用关闭标签，因此不确定它是否会起作用。有什么建议么。

我看到asciidoctor.org本身有一个导航（顶部）栏。我猜该网站是使用 asciidoctor 源文件编写的。无论哪种方式，如何使用 asciidoctor 添加导航栏？

更新

这可能是一个错误的问题。也许正确的方法是使用 awestruct、Middleman 或 Jekyll。欢迎提供意见/建议。

我的 Maven 构建基于 Asciidoc 源生成静态 HTML。我想将此文件作为我的 Jersey 2 应用程序的欢迎页面。

请注意，我没有任何 servlet 配置，因为spring-boot-starter-jersey它自己处理。

我已经挣扎了一段时间，我不确定是否有优雅的方法可以做到这一点。

在我当前的 Asciidoctor 文档中，我有一个要在代码块中使用的属性。有没有办法在代码块中进行字符串插值？

标题中的属性..

代码块

我似乎无法进行字符串替换，在代码块中进行字符串替换的任何提示或提示？