问题标签 [asciidoctor]

Asciidoctor将处理包含以下内容的文件simple.adoc：

使用pygments生成许多语法类别

我们可以确认生成的 HTML 确实相当丰富：

但是默认样式表很难区分语法类别。

如何自定义输出，可能是通过插入新的 CSS 样式表或修改现有样式表中的值？

更新 （感谢 LightGuard）如果我们保存文件simple-docinfo.html，其名称与我们正在处理的文件匹配，但具有后缀-docinfo和扩展名.html，包含一行：

然后运行asciidoctor simple.adoc，应该会看到basejump.css出现在simple.html。但没有这样basejump.css的出现。为什么？

我不知道任何 Ruby，但我喜欢asciidoctor（和 gradle 插件）。有没有一种简单的方法可以让插件生成植物图？

我查看了基本的asciidoctor-diagrams功能，它似乎特定于使用本机/ruby asciidoctor 扩展（我没有也不想安装，因为我喜欢使用 gradle 插件）。

做得很好的 asciidoctor-gradle-plugin文档页面显示它接受requiresRuby 模块的选项，但没有任何 Ruby 基础，我不确定这是否是我需要的。

我尝试了阻力最小的路径，即：

针对我的基本植物测试：

但得到：

在配置阶段。

如何配置asciidoctor-gradle-plugin以处理植物？

我尝试指定

对于表格单元格内容，但它不起作用。它呈现[#abc] MyText为我的单元格的内容。

我正在尝试创建一个Sublime Text 3构建系统来使用AsciiDoctor呈现和 Asciidoc 格式的文档。

AsciiDoc.sublime 构建：

当我执行 build Ctrl+B时，我收到一个错误：

我能够通过 Windows 命令处理器、PowerShell 和 Ruby 提示符成功呈现文档。

此构建脚本会导致相同的错误：

我错过了什么？

我正在使用“jekyll-asciidoc”插件导入一个外部文件。

Jekyll 不想包含该文件，因为它位于我网站的文件夹之外。那是消息：

如何从 Jekyll 配置文件中禁用 asciidoctor“安全模式”？

文档和谷歌搜索结果的前三页都没有说明 AsciiDoc 文档中图像的度量单位是什么。这是一个重要的话题，因为 AsciiDoc 既可以转换为 HTML（原始单位是像素）也可以转换为 PDF（原始单位是 cm 或 pt）。

因此，有人可以回答和/或在文档中添加有关以下内容的部分：

• 当我写的时候image::path/to/image.png["Caption",300,200]，那些300和是200什么？像素？
• 当我从 AsciiDoc 文档生成 PDF 时，如果我们使用像素，它使用什么 DPI？我可以在某些配置设置中控制它吗？
• 如果这些尺寸是在一些抽象单位中，那么在这些单位中 HTML 和 PDF 页面的宽度是多少？
• 有没有办法用图像制作与输出无关的 AsciiDoc 文档？我不希望两种格式的像素完美相同的布局，但至少保留图像的相对大小会很棒。

我asciidoctor -b html用于 HTML 输出和asciidoctor-fopubPDF。asciidoctor-pdf在它至少支持与 fopub 相同的功能集之前，我不会使用它。

事先谢谢你。

我正在尝试将 deck.js 后端与 asciidoctor 一起使用。我按照http://asciidoctor.org/docs/install-and-use-deckjs-backend/的说明进行操作。我收到以下错误：

我的文档 - deckjs-example - 看起来像：

我的目录包含我似乎需要安装的所有东西：

我认为是配置问题。搜索还没有找到解决方案，尽管我确实在 AsciiDoctor 讨论组上发现了一个类似的问题，不幸的是，它似乎没有提供解决方案，至少不是我理解的解决方案。

在我的 Rails 视图中，我使用

我希望得到

但我得到的不是那个（在页面源代码中）

我究竟做错了什么？如何显示 asciidoc 转换为 html 而不是<tags>像现在一样全部？

总结。我如何（如果？）如何获得 vim 折叠以自动将在节标题行之前找到的asciidoc [id='']行与为该节创建的折叠关联？

详情。asciidoc内容支持部分标题识别（除其他外，映射到呈现的 HTML 锚标记名称，还支持文档内交叉引用），也称为（我认为？）作为块标识符。但是，[id='']行简介必须放在节标题行之前，即使它是节的一部分。例如：

这使得 asciidoc 文件的 vim 折叠更难管理，因为 folded-section 移动“丢失”前一行（并且所有 section 都id被打乱了），因为在 vim 折叠的眼中，前一行属于上一节。

我正在尝试并排放置两个图像，并且理想情况下将整个块置于 Asciidoctor 项目的中心。下面的代码适用于 HTML5 输出，但在呈现为 PDF 时会堆叠图像。

是否可以 1）在 PDF 中并排渲染图像和 2）将图像块居中？如果可以指定它们之间的空间，那也很棒。

谢谢，

马特