问题标签 [asciidoctor]

如何在 asciidoctor-pdf 中使用自定义样式（字体大小、字体颜色等）。我已阅读主题指南并尝试在 xxx-theme.yml 中添加设置但没有成功。在我的 pdf 示例中，标记的样式（带 #）也不起作用。

我有一个类似于这个的 asciidoctor 模板：

https://github.com/asciidoctor/asciidoctor-backends/blob/asciidoctor-v0.1.4/erb/html5/document.html.erb

我想在我的文档中包含一个链接，该链接指向用于生成文档的 asciidoc 文件。

有没有办法在我的模板中访问 asciidoc 文件名？

我正在使用asciidoctor-maven-plugin来呈现我的文档。

我很好奇，一个好的自动化工作流程如何用于将问题/触摸文件列表自动化到汇合页面的过程。我在这里描述我目前的想法：

• 使用 REST (DONE) 从 JIRA 获取与我的请求匹配的所有问题
• 使用 Fisheye REST 获取与匹配问题相关的所有触摸文件
• 创建一个包含内容的 .adoc 文件
• 使用 asciidoctor-confluence 将其渲染到合流页面

我正在 python 中实现这个（使用请求等），我想知道如何为基于 ruby​​ 的 asciidoctor 提供适当的 .adoc。我打算使用 asciidoctor，因为它可以选择使用asciidocter-confluence.

那么，有人可以详细说明我的想法吗？

当我*.adoc在 awestruct 的文件中有此代码时：

我得到：

但我希望它像这样很好地格式化：

我尝试了这些，但它们不起作用：

这很奇怪，因为#{rubyVariable.someMethod()}在 adoc 文件中调用 Ruby 方法确实有效。

我在 JBake 中使用 asciidoc 格式。我正在使用 2.4.0 版的 JBake。

一切运行良好，但我想对从 asciidoc 内容生成的 HTML 进行一些更改。通常在 Asciidoctor 中，您可以为自定义后端指定 template_dirs 选项。

我尝试通过将以下内容添加到 jbake.properties 文件中来在 JBake 中执行相同的操作。

目录 src/custom-asciidoctor-backends/erb/html5 包含原始后端，我没有任何更改。

这给了我以下错误

发生意外错误：（NoMethodError）asciidoctor：FAILED：：无法解析源，“src/custom-asciidoctor-backends/erb/html5”的未定义方法“每个”：字符串

所以我的问题是如何配置 JBake 以使用自定义后端？

如果结束反引号 (`) 后跟一个字母，则它不会按预期呈现。

例如，`Link`s 将仅呈现 `Link`s 而不是Links。

Using{empty}解决了像 `Link`{empty}s` 这样的问题，但它非常难看。

有更好的方法来实现这一点吗？

更新：

我正在使用asciidoctor-gradle-plugin.

一个简单的示例项目如下：

https://github.com/izeye/samples-spring-boot-branches/tree/asciidoctor

我正在尝试使用 AsciiDoc 轻量级标记语言创建“可点击”图像Asciidoctor。

我尝试了以下（不工作）： image::<url1>[<url2>[]]

例如：

它应该变成大致如下的html：

如何在 AsciiDoc 中完成此操作而不通过原始 HTML？

我正在尝试创建一组可以脱机访问的 HTML 文件，因此避免使用 CDN 来托管 CSS 和 Javascript 文件。不幸的是，在使用-a stem=latexmath. 是否有一些可用的配置值？

我正在遵循 Spring Rest Docs 参考文档中关于构建配置的说明。但是当我尝试做时，'snippets' 属性似乎没有暴露给 Asciidoctor

但我得到一个 asciidoctor “警告：删除包含对缺失属性的引用的行：片段”

如果我删除属性引用并直接放入路径，则会出现包含文件的内容。

这是包含 Rest Docs/Asciidoctor 信息的 build.gradle 文件：

谢谢。

我使用 org.asciidoctor.convert 插件为我的团队生成 API 文档。我包括文件：

并希望将其内容放入扰流板或类似内容中。有没有办法以某种方式隐藏动态 asciidoc 元素？我尝试使用

但它没有被处理包含在它里面。任何想法将不胜感激。在不隐藏片段的情况下，我的文档几乎可以无限滚动 :)。如果 ascii doc 没有这样的方式，其他文档格式的建议，我可以在其中包含文件内容并将其放入扰流板中，也值得赞赏。