问题标签 [asciidoc]

在我的 Rails 视图中，我使用

我希望得到

但我得到的不是那个（在页面源代码中）

我究竟做错了什么？如何显示 asciidoc 转换为 html 而不是<tags>像现在一样全部？

总结。我如何（如果？）如何获得 vim 折叠以自动将在节标题行之前找到的asciidoc [id='']行与为该节创建的折叠关联？

详情。asciidoc内容支持部分标题识别（除其他外，映射到呈现的 HTML 锚标记名称，还支持文档内交叉引用），也称为（我认为？）作为块标识符。但是，[id='']行简介必须放在节标题行之前，即使它是节的一部分。例如：

这使得 asciidoc 文件的 vim 折叠更难管理，因为 folded-section 移动“丢失”前一行（并且所有 section 都id被打乱了），因为在 vim 折叠的眼中，前一行属于上一节。

我正在尝试并排放置两个图像，并且理想情况下将整个块置于 Asciidoctor 项目的中心。下面的代码适用于 HTML5 输出，但在呈现为 PDF 时会堆叠图像。

是否可以 1）在 PDF 中并排渲染图像和 2）将图像块居中？如果可以指定它们之间的空间，那也很棒。

谢谢，

马特

我正在尝试将 .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

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

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

我正在为一个文档项目做一个构建系统，我需要帮助来尝试在生成 PDF 输出时限制图像的宽度。

我a2x --fop用来生成工作正常的 PDF 输出，但我需要为所有图像启用scale-down-to-fit选项（缩小以适应 FOP 中的图像）。

如何在使用时启用此功能a2x --fop？

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

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

例如：

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

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

结果：i think a and b are the same

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

感谢您提供任何帮助。

我是否能够以与当前查看降价文件相同的方式在 github 上显示 asciidoc 文件？根据这个博客条目，我应该能够做到这一点：

如果您对使用 AsciiDoc 感兴趣，请前往 GitHub 并使用文件扩展名 .asciidoc 或 .adoc 在您的存储库或 gist 中创建一个新文件。

但是我试图这样做，但没有奏效。谁能告诉我如何获取 asciidoc 文档以在 Github 上显示格式良好的文本？

这是我试图用 Asciidoc 测试的文档。 https://github.com/00krishna/proj_blog/blob/master/test.adoc

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

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

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