问题标签 [asciidoctor]

本FAQ部分描述了如何设置目录中显示的“section depth”/“TOC level”/toclevel。但是，我不知道如何在我的简单中实现这一点：

命令。有没有人？

我有一个 asciidoctor 页面，例如：

一般配置是在目录中显示 3 级深度。但是例如对于第 2 章，我只想在目录中包含顶层。

是否可以更改每章的 toc 级别？

我正在使用 CMS 发布我的博客文章。我正在寻找一种从简单的文本文件离线创建 HTML 文章的方法。这是我通常用于我的文章的一段 HTML：

如您所见，我使用一些自定义来包装代码（预类等）。使用 Asciidoctor 可以轻松完成吗？我是 Asciidoctor 的新手，只是想知道是否值得为此花时间学习它。
谢谢！

我使用 Maven Site 插件在我们的 Maven 站点中生成并包含基于 AsciiDoctor 的文档。如果 AsciiDoctor 源文件不包含任何其他 AsciiDoctor 文件，这将正常工作。

但是，如果我想包含如下所示的任何其他文件，AsciiDoctor 找不到050-gitworkflow.adoc.

相反，我可以看到 Maven 生成的以下消息

所以看起来 AsciiDoctor 或假定文档的根目录与 Maven 模块基本目录相同。

如何在主 Asciidoctor 文件中使用相对包含？

我的 Maven 站点包含多个 Asciidoctor 文档。我想使用在 Maven Site 插件的配置中声明的属性，但似乎它们并没有过度交给 Asciidoctor。

这是我如何尝试ta在我的 Asciidoctor 文档中使用该属性的示例。

如何在我的 Asciidoctor 文档中使用为 Maven Site 插件定义的属性？

给定带有内容的 asciidoctor 文件my-document.adoc：

included-document.adoc包含

当我渲染时my-document.adoc，我想要可见的内容

此文件的内容无法更改。
此文本已成功替换。

这可能不改变included-document.adoc吗？my-document.adoc可能会改变。

我正在使用 Atom Editor + 关于 asciidoctor 的两个插件/包。

• asciidoc 预览
• 语言-asciidoc

一切都按预期工作。但我有以下情况：

我有以下目录结构：

哪里findOneXml.adoc（在图形文件夹中）有

通过实时预览，我可以看到图像及其各自的描述

现在findOne.adoc（在url文件夹中）包含以下行：

我认为路径参考是可以的。如果我使用其他，实时预览会显示有关无效或错误路径的错误消息。

但是通过实时预览，我看到图像损坏，但我可以看到描述。

有什么问题或遗漏？

即使include::./../figures/findOneXml.adoc[]失败

注意：在子/子文档中，我需要添加其他数据如何注释、提示（警告），该子文档将被其他父母多次重复使用。所以我只需要参考图像。

谢谢

我使用https://github.com/asciidoctor/asciidoctor-epub3为 Kindle 导出到 kf8。结果看起来很漂亮，但错过了提示、注意和重要提示旁边的小图像。我猜这些文件丢失了，或者 CSS 中有错误。我该如何解决？

我使用这个命令来渲染 kf8 版本：

我有这样的asciidoc文档结构：

我正在尝试从 to 创建交叉doc1引用doc2。

我试过类似的东西：

但它不起作用，有人可以暗示什么是错的吗？

谢谢！

我正在尝试使用 asciidoctor-pdf 编写文档，我需要使用以下字符：ă,â,î,ş,ţ。pdf 输出被渲染，但提到的字符被渲染为空。我不确定如何处理这个问题。

例如：

我写了这段代码：

结果是 Introducţie 这个词呈现为 Introduc ie，最后是错误：

• 会不会是系统编码配置问题？
• 我需要在 ruby​​ 中设置不同的编码配置吗？

谢谢你。