问题标签 [asciidoc]

我从 AsciiDoctor 开始，我想输出 HTML。我一直在试图弄清楚如何在部门中创建自定义类，我搜索了谷歌、手册等，但找不到解决方案。我想做的只是写这样的东西：

Type the word [userinput]#asciidoc# into the search bar.

生成 HTML

<span class="userinput">asciidoc</span>

但我想要 div 标签而不是 span。有什么办法可以做到，或者我应该使用类似的东西 +++<div class="userinput">asciidoc</span>+++吗？

我有一个问题，我的标题之前的适当空间，也就是定义项目之后，没有出现。（我想我不能在这里张贴图片。）

这是一些 asciidoc。“== What not to do”是一个标题，但它在前面的文本旁边被压扁了。有人看到我的错误或修复吗？太感谢了！

我正在使用 asciidoctor 写一本书。文档看起来像这样。

书本.asciidoc

第01章.asciidoc

它渲染得很好，结果看起来不错。

现在我正在尝试将Atom与atom-asciidoc-preview一起使用。问题是atom-asciidoc-preview似乎无法正确替换变量。

我试试这个。

变量.asciidoc

第01章.asciidoc

我没有运气。我怎么解决这个问题？

我有一篇文章将有多个翻译，英文和普通话开始。我可以使用两个文档，一个链接另一个，或者我可以一个接一个，并在开始时为每个文档添加一个链接。

有没有更优雅的方法来处理这个？例如，我可以在开始时选择语言并选择内联吗？

我正在使用 spring rest docs 生成 asciidoc 片段。

我可以在我的文档页面中包含生成的片段。但是，我想在单独的 adoc 文件中定义每个部分的结构一次，并在我的索引文件中为每个部分定义一行。

目前我的index.adoc文件如下所示：

我希望它变成这样

索引.adoc

我的模板.adoc

任何人都知道如何做到这样的事情？

我目前正在用 asciidoctor 编写文档，我需要链接文档中的图像和部分。虽然我了解 asciidoctor 中的交叉引用是如何工作的，但我想知道是否有一种方法可以链接部分和图像等元素，同时显示 asciidoctor 使用 :sectnums: 属性生成的元素编号。在此示例中，您可以更好地查看我希望实现的目标，而无需手动输入：

如何在 asciidoc/asciidoctor 中定义宏？

我将在文档的许多部分使用重复模式，因此我想进行参数化替换以避免多次输入相同的内容。

特别是，我有以下 asciidoc 片段：

我需要将它放在文档的几个部分中，用不同的文本替换来代替 X 和 Y。我该如何实现呢？

我安装了 AsciiDoctor 以从我的 ASCII-Doc 文件生成 html5-Websites。

到目前为止，我没有找到一个选项可以生成像http://www.asciidocfx.com/或http://asciidoctor.org/docs/user-manual/这样的文件（即（1）没有页脚日期，（2）左侧的菜单和（3）链接的标题。）

（如何）我必须为此使用模板吗？

我需要编写和构建易于维护、美观、易于更改 pdf 和 html 5 格式的文档。源格式必须易于编辑。这个 maven 插件必须支持我的公司组织（字体、颜色、图片等）、TOC 生成、不同文件中的章节分离、图像文件的集成、将代码片段放入文档中的简单方法。我有 Maven 构建，我想知道目前最好的决定是什么？

我正在调查两个选项：

• Doxia - 使用 md(markdown) 作为输入格式。有 WSWG md 免费编辑器，支持很多前面提到的东西等。它的工件需要外部 repo。
• Asciidoctor - 使用 asdcii doc 作为输入格式。支持使用片段等进行模板化。

使用这个插件有什么好处和坏处？还有其他好的解决方案吗？

我正在手动将旧的 MS Word 文档转换为新的 asciidoc 格式。

通过这样做，我遇到了一个我还无法解决的问题。

有一个例子，我想向读者展示文件链接的语法应该是什么样子。

所以我以此为例：

Asciidoc现在将此伪链接呈现为实际链接，并在将我的 asciidoc 文档转换为 html 和 pdf 时警告我。

通常我会简单地使用 [source] 元素来防止链接呈现。但是文件链接是表格的一部分。

有没有办法防止文件链接的渲染/转换？