问题标签 [asciidoctor]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
asciidoc - 使用 AsciiDoc，如何在标题之前强制额外的回车空格？
我有一个问题，我的标题之前的适当空间，也就是定义项目之后，没有出现。（我想我不能在这里张贴图片。）
这是一些 asciidoc。“== What not to do”是一个标题，但它在前面的文本旁边被压扁了。有人看到我的错误或修复吗？太感谢了！
asciidoc - 如何将变量分隔到外部 asciidoc 文档中？
我正在使用 asciidoctor 写一本书。文档看起来像这样。
书本.asciidoc
第01章.asciidoc
它渲染得很好，结果看起来不错。
现在我正在尝试将Atom与atom-asciidoc-preview一起使用。问题是atom-asciidoc-preview似乎无法正确替换变量。
我试试这个。
变量.asciidoc
第01章.asciidoc
我没有运气。我怎么解决这个问题？
groovy - 在 asciidoctorj 插件中创建多个块
asciidoctorj groovy 插件中的 blockProcessor 能够返回一个块。因此，很容易将一个块转换为另一个块。
我找不到有关如何在一个 blockProcessor 中创建多个块以及可用的块类型的文档。
关于如何返回两个而不是一个块的任何想法？我已经尝试过使用该parent参数，但无法获得结果。
header - Asciidoctor如何在标题页中添加页眉和页脚并忽略边距
我想知道是否有人知道如何在您的服装 Asciidoctor 主题的标题页上制作页眉和页脚。
就我而言，我有一个想要放在左上角的徽标。问题是我已经为文档设置了边距，所以我的徽标不会出现在标题页的正确位置。
你们中有人知道如何忽略页边距或只是如何在标题页中添加页眉和页脚吗？
asciidoc - 在 asciidoctor 中交叉引用元素及其标签
我目前正在用 asciidoctor 编写文档，我需要链接文档中的图像和部分。虽然我了解 asciidoctor 中的交叉引用是如何工作的，但我想知道是否有一种方法可以链接部分和图像等元素，同时显示 asciidoctor 使用 :sectnums: 属性生成的元素编号。在此示例中，您可以更好地查看我希望实现的目标，而无需手动输入：
asciidoc - 如何定义自己的 asciidoc 宏
如何在 asciidoc/asciidoctor 中定义宏？
我将在文档的许多部分使用重复模式，因此我想进行参数化替换以避免多次输入相同的内容。
特别是，我有以下 asciidoc 片段：
我需要将它放在文档的几个部分中，用不同的文本替换来代替 X 和 Y。我该如何实现呢？
compilation - 如何从 ASCII-Doc 文件生成带有菜单的网站？
我安装了 AsciiDoctor 以从我的 ASCII-Doc 文件生成 html5-Websites。
到目前为止，我没有找到一个选项可以生成像http://www.asciidocfx.com/或http://asciidoctor.org/docs/user-manual/这样的文件（即（1）没有页脚日期，（2）左侧的菜单和（3）链接的标题。）
（如何）我必须为此使用模板吗？
asciidoc - 如何防止图像重置 asciidoctor 中的有序列表编号
我正在使用 asciidoctor 生成 html。我有以下列表：
当转换为 html 时，它看起来像这样：
在 html 中，我想看看：
我不想在插入图像后手动重置计数器，因为我有数百个类似的情况。
gradle - 如何使用 Gradle 构建脚本模拟 AsciidocFX 的 PDF 输出？
我有以下 Asciidoc 文档：
使用 asciidoctor 生成 PDF 时，输出如下：
问题是：
- 脚注显示为内联（参见：https ://github.com/asciidoctor/asciidoctor-pdf/issues/73 ）
- 表格单元格中的 Asciidoc-content 不会被解释：https ://github.com/asciidoctor/asciidoctor-pdf/issues/6
- 链接目标不显示为脚注（这将是很好的）
使用https://github.com/asciidocfx/AsciidocFX可以正确显示所有内容：
现在，我想拥有与 AsciidocFX 产生的相同的输出，但仍然喜欢使用我的 Gradle 构建脚本。
从https://github.com/asciidoctor/asciidoctor-pdf/issues/73#issuecomment-224327058我了解到，AsciidoctorFX 在后台使用https://github.com/asciidoctor/asciidoctor-fopub[asciidoctor-fopub]。但是我怎么能在我的 build.gradle 这个管道。我是否必须在第一个任务中生成 epub 并在另一个任务中使用输出？还是有直接的方法？
image - 不能包含来自部分的图像
我写了一个包含包含和以下结构的 asciidoctor 文档：
我使用以下命令生成我的 PDF：
mydoc.adoc 看起来像这样：
chap1.adoc 看起来像这样：
最后 section1.adoc 看起来像这样：
如果我为 section1.adoc (asciidoctor-pdf -b pdf section1.adoc) 生成 PDF，它将包含图像。但是，如果我从根目录生成 mydoc.adoc (asciidoctor-pdf -b pdf mydoc.adoc) 的 PDF，则它不包含图像。
我收到以下错误：
我看起来好像这一代人不关心路径......
有人能帮我吗 ？
钍。