问题标签 [asciidoctor]

我正在尝试将 Spring Rest Docs 包含在 Spring Boot 应用程序中，并设法生成了一个简单的 asciidoc HTML 文件，该文件显示了应用程序根目录“/”的请求路径。问题是代码段中的请求 URL 不包含应用程序名称？例如，我的应用程序被称为“myservice”，所以我希望根“/”请求路径记录为

$ curl ' http://localhost:8080/myservice/ '

相反，我只能生成

$ curl ' http://localhost:8080/ '

我是 Spring Rest Docs 的新手，无法弄清楚如何在记录的 URL 中包含应用程序名称。它是在 asccidoctor 的 maven 插件中、在测试类的 @before 或 @Test 方法中还是在 .adoc 文件中作为“包含”标签的一部分设置的？

我在网页中嵌入了一些 adoc 文件，所以我不想拥有完整的header_footer东西（使用html/ body/etc...），但这似乎是我可以让目录显示的唯一方法使用 asciidoctor gem 转换它时在 adoc 文件中。有没有办法两者兼得？我尝试查看源代码，但没有看到任何手头的东西。

默认情况下，asciidoctor创建一个静态目录。这非常酷，但是对于长文档，如果目录可以更紧凑并突出显示阅读器当前在文档中的位置，那就太好了。

此时，tocify出现了。Tocify 是一个很好的 Javascript 解决方案，正好涵盖了这一点。

现在的问题是：如何将 tocify 与 asciidoctor 一起使用？

Asciidoctor问题 699与此相关。

有一些 AsciiDoc 有一个像...这样的块

...我希望文本显示为...

...“一些”这个词是粗体的。

假设我有一个自定义阻止角色：

是否可以在 Asciidoctor PDF 中为此块角色设置自定义样式（例如背景颜色）？我在Asciidoctor PDF Theming Guide中找不到答案。

Asciidoctor 正确呈现以下行。

当我像这样添加一个硬中断时，

第二行根本不渲染。

我该如何解决这个问题？

更新

到目前为止，我发现一个领先的空间确实需要工作。我不确定这是理想的效果。

请帮助我解决我在使用 Spring Rest 文档时遇到的问题。我已经从 Spring 手册中进行了所有必需的设置。我写了 Spring MVC 测试。这是代码。奇怪的符号是俄语。

问题是当我从 IDE (Intellij IDEA) 开始这个测试时，它工作正常并生成所有片段。但是当我运行 maven "package" 任务测试失败并显示结果：

我已检查问题出在字段描述中。如果我删除这部分包目标执行得很好。

我的项目和所有输出文件的编码都是 UTF-8。在 Maven 中我明确指定

任何帮助和想法将不胜感激。

PlantUML 是 Asciidoc 的一个很好的扩展，但我无法从我的 groovy 代码中弄清楚如何使用。

据我所知，该asciidoctorj-diaram模块应该是当前asciidoctorj-Release 的一部分，所以我想我不需要额外的依赖。但是我的代码可以很好地呈现 asciidoc，但不能呈现 PlantUML 图。它说：

知道有什么问题吗？我在网上找到的asciidoctorj-diagram例子都使用了 gradle-plugin :-|

我真的很喜欢 asciidoctor 的标注，请参阅http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/，并在页面“带有标注的代码块”中搜索，单击“查看结果”。但是我使用 Ipython notebook 来写，Markdown 是不二之选。（通过“原始NBconvert”在Ipython Notebook中尝试了Asciidoctor，结果混乱。）看来我只需要Asciidoctor的源代码标注。所以我的问题是如何从Markdown获得类似的结果？

我正在尝试自定义我们的开发人员指南 pdf以使其首页看起来不错。我完全可以在 Photoshop 中将所有内容作为图像进行处理，因为 asciidoc 在这里的能力似乎非常有限。

不幸的是，尽管到处寻找，我似乎找不到一种方法来自定义封面或将其替换为适用于 asciidoctor-fopub 的图像。

烦人的是，这个用例在项目的自述文件中特别提到了https://github.com/asciidoctor/asciidoctor-fopub（在自定义 XSL 模板下），但除了“它在 XSL 中”。作为不熟悉 docbook 的人，我不知道从哪里开始。

asciidoctor-pdf有一个包含图像的标签，但它会在我们的文档上显示并生成垃圾（ToC 会覆盖所有内容）。