问题标签 [asciidoctor]

我正在使用 asciidoctor 使用 asciidoctor-maven-plugin。在我的文档（实际上是文档）中，我有一个块重复了很多次。有什么办法可以包含参数。

我在伪代码中想要什么，我找不到如何编写它：

模板：

用法

谢谢。

我正在使用 AsciiDoctor 创建 HTML 手册。为了保持现有链接有效，我需要在同一个标​​题中使用多个锚点。

基本上我想要这个输出：

虽然可以像这样创建多个内联锚点

看起来像块前面的附加锚宏被简单地吞噬了：

那么我有哪些选择可以在一个块前面有多个锚点？

我对使用 Gradle 将我的 asciidoc 文件转换为 PDF 的选项有点困惑。有这个GitHub存储库，其中包含一组使用以下 Gradle 构建文件样式（摘录）的示例：

从这里（github）使用 Asciidoctor Gradle 插件。

另一方面，我们在此处（官方文档）或此处（mrhaki）使用此样式对 Asciidoctor Gradle 插件进行了描述：

那么哪一个是当前（和正确）的语法？如果我想生成 PDF 并包含图表，我应该使用哪一个？

（只是说清楚：我只有非常有限的 Gradle 经验；）

在我的 Spring MVC 测试（UTF-8 编码）中，我们发现：

asciidoctor 文件包含

在我渲染它并在我的 Firefox 浏览器中打开生成的 HTML 文件（也是 UTF-8 编码的）之后，我发现

特殊字符如何正确显示？

我想使用 asciidoc 来生成表格。我使用 asciidocfx。我创建了 2 个相同的表，一个加载外部 csv 文件，而另一个是在 asciidoc 中创建的简单表。问题是，加载的 csv 文件中的表会为这些字符“...”生成一个 �。使用 asciidoc 创建的表不会为“...”生成该符号

这里是文字

table.csv 的内容

html 输出的片段。

我正在使用 swagger2 生成我的 api 文档，并且通过 springfox-staticdocs 使用来自 swaggwer 的相同 json 输出来生成 ascii 静态文档。ascii 格式的静态文档在 junit 测试类中生成。现在我想通过 asciidoctor-maven-plugin 从测试阶段生成的 ascii 文档生成 html 文档，但是不知何故 html 文档没有生成，我什至看不到 process-asciidoc 目标被执行。我将“process-asciidoc”目标绑定到准备包阶段，因为 ascii 文档是在测试阶段生成的。我在这里做错什么了吗。

mvn包

pom.xml 片段：

这是使用 springfox-staticdocs lib 生成 ascii 文档的测试方法片段：

I am using AsciiDoc with Asciidoctor Gradle Plugin to generate technical documentation as PDF.

When I used M$ Word, I could easily place forms on an image, for example

1. colored rectangles,
2. boxes with numbers or
3. even links to sections within the document,

to better point out interesting areas within the image.

Example:

On the example image I have placed two rectangles and each one contains a link (starting with the word «Dialogbereich») leading to a other sections within the document.

Is it possible to achieve something like this (directly) in AsciiDoc?

1. Note that the answers to asciidoc: how to add callouts asciidoc to image do not apply here as the Asciidoctor PDF backend does not use DocBook to generate the PDF.
2. I know I could create a layered image in GIMP to at least place the rectangles. However, that wouldn't help me with the links.

我想知道是否存在将 XML xsd 中包含的描述转换为 AsciiDoc 表的工具，以便可以将其包含在整个 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>+++吗？

我已经chm从使用生成的单个html文件创建了一个文件asciidoctor。文件的内容和索引chm指向同一html文件的特定部分。但是，当我使用 时search tab，即使文件中突出显示了所有搜索命中，该'Select topic o display'部分也仅列出了html文件本身的名称。有没有办法可以在搜索选项卡中显示 html 文件中的部分名称？