问题标签 [asciidoctor]

我不得不承认我是 AsciiDoc 和 ASciiDoctor 的新手......

我想要完成的是用 groovy 呈现给定的 AsciiDoc 模板（https://github.com/masch70/arc42-template-asciidoc）。我的解决方案是使用 AsciiDoctor Java 接口，它似乎是对运行 jRuby 的 AsciiDoc 的重写。到目前为止，代码运行良好：

但它似乎忽略了对我来说看起来不错的包含部分：

不是包含文件，而是呈现文件的链接。

AsciiDoctor 手册说支持包含：http ://asciidoctor.org/docs/user-manual/#include-directive ，所以问题是，我做错了什么？

从 CLI 运行 AsciiDoctor 会创建一个带有嵌入式样式表的 HTML 文档：

但是，在 Ruby 文件中运行 Asciidoctor 不会：

该文档并未表明应该有任何区别。我错过了什么？

细节：

• Asciidoctor 0.1.4
• 红宝石 2.0.0p247

在 Windows 上使用 asciidoctor-maven-plugin 时，我们在弹出目标 process-asciidocs 时遇到编码不兼容错误。

我们已经尝试使用插件的 0.1.4 版本和 master 的最新 SNAPSHOT。

将 cruby 与 asciidoctor gem 一起使用时，我们没有收到此错误，因此它认为问题出在 jruby 执行环境上。

在 Mac 上，我们通过设置 JAVA_TOOL_OPTIONS="-DFile=encoding.UTF-8" 解决了同样的错误，但在 Windows 上这不起作用。

我们如何强制 jruby 使用 UTF-8？

我想使用 asciidoctorj 创建一个带有 ID 的外部链接。我在手册中的任何地方都找不到如何做到这一点的方法。

Asciidoctor 来源：

当前结果：

预期结果：

reStructuredText allow you extend/rewrite writer for its markup. So you can add new type of embedded objects or introduce new sub-language by defined API.

Is this possible with Asciidoc (original Python implementation or Ruby asciidoctor)?

我正在尝试在 Google Chrome 上使用 Asciidoctor.js 实时预览，但我看到的不是我的文档

它还会引发一个 JS 错误：

可能我需要将 sth 添加到 manifest.js 文件中，但我不知道是什么。

我无法弄清楚如何解决这个问题。任何意见，将不胜感激。

asciidoctor 允许您通过 template_dir 选项提供自定义模板。文档似乎不足以让我继续使用它，谷歌也无济于事。

有人知道使用自定义模板的好例子吗？

基本上，我想渲染一个这样的块

用我自己的风格。我复制了一种默认样式，将其重命名并指定了一个模板目录，但我目前得到的只是一条错误消息invalid style for example block: custom

我尝试在我的 Rails 应用程序中使用 asciidoctor gem。我将它添加到我的Gemfile并制作了bundle install.

现在我尝试在控制器中使用 asciidoctor：

但我得到一个错误：

使用 rails 使用 asciidoctor-gem 的正确方法是什么？

我将 asciidoc 与此处描述的保护文件一起使用描述的保护文件一起使用。

给定 asciidoctor 选项：asciidoctor -a icons -a iconsdir /foo -a copycss bar.adoc我想将这些选项添加到保护文件中。但我不知道怎么做。

保护文件当前看起来像：

我没有使用 Asciidoctor、Ruby 或 gradle 的经验。我负责一个由其他人开发的项目，该项目使用了所有这三个。代码中是Asciidoctor::HTML5::DocumentTemplate引发错误的函数

我们最近升级到 Asciidoctor 1.5.0，当尝试编译这个项目时，它会抛出以下错误消息：

第 108 行是：<%= ::Asciidoctor::HTML5::DocumentTemplate.outline(self, (attr :toclevels, 2).to_i) %>

据我所见，它从一个文件中填充目录，其中的标题前面带有## 标签。

我从这里做什么？