问题标签 [asciidoctor]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
2082 浏览

java - 如何将 Maven 变量传递给 asciidoctor-maven-plugin?

我有使用 AsciiDoc 的用户指南,尽管我没有花太多时间,但它非常漂亮。

AsciiDoc 插件很棒。所以我想在用户指南中传递我的 Maven 最终名称。

问题:如何做到这一点?

我的asciidoctor-maven-plugin配置是:

0 投票
1 回答
1118 浏览

java - Spring restdocs conditionally highlight optional parameters with asciidoc

I am using spring restdocs to produce documentation on my REST webapi; I have integrated the thing and my html gets generated (maven + asciidoc plugin, restassured apis). The only problem I have is that ifeval either doesn't work as advertised or I got it wrong.

My custom request-fields.snippet looks like this:

The 'optional' value in the tablecellcontent is rendered correctly ('true' or 'false' depending on the case), but the ifeval is not parsed (and thus shows itself unparsed on the final html, with no error).

I tried different syntaxes for the expression but none seem to work; any hints on what may be the correct syntax, if any? I am thinking about defining a custom attribute and use ifndef to get the same result, but I would prefer to use the existing optional() support if possible.

As requested I am adding the resulting .adoc

0 投票
2 回答
316 浏览

ruby - 在 osx 10.11.5 上为新手安装 asciidoctor?

我尝试遵循在以下位置定义的安装过程:http: //asciidoctor.org/docs/install-asciidoctor-macosx/#rvm-procedure-recommended但失败并显示错误消息

运行“requirements_osx_brew_update_system ruby​​-2.3.0”时出错,显示 /Users/richardcoffre/.rvm/log/1466510618_ruby-2.3.0/update_system.log 的最后 15 行

因为我是新手,但是想用asciidoc格式,需要更新详细的安装流程来安装asciidoctor

最好的问候理查德

0 投票
1 回答
246 浏览

asciidoctor - 使用 Asciidoctor 的可重用标记片段

我正在为我们公司编写 Asciidoctor 指南。在本指南中,我想定义可在文档中使用的可重复使用的标记片段,如下所示:

尽管内容被逐字复制到生成的文档中。有谁知道如何用 Asciidoctor 定义可重复使用的标记片段?

0 投票
1 回答
926 浏览

java - Asciidoctor 将多个 adocs 转换为 pdf

我在测试方法中使用 asciidoctorj 来生成我的 pdf

将为每个文件生成一个pdf,但我希望它们都在一个pdf中,我该怎么做?

我正在使用 asasciidoctorj 版本 1.5.4 和 asciidoctorj-pdf 版本 1.5.0-alpha.11

0 投票
2 回答
5493 浏览

maven - AsciiDoctor 表格单元格中的多个段落

编辑:由于我的问题似乎特定于我的设置,我在这里提供了一个完整的最小工作示例。

这是我的 Maven 设置(pom.xml):

这是我的 AsciiDoc 源代码(src/test.adoc):

AsciiDoc 文件编译时使用:

这是生成的输出 ( target/generated-docs/test.pdf)

为什么 AsciiDoc 不呈现两个段落?

其他无法按预期工作的事情(每个示例都将整个单元格内容推送到一个段落中):

  • 明确指定a单元格:
  • 列表:
  • 作为非标题:
0 投票
1 回答
235 浏览

asciidoctor - 如何使用 AsciiDoctor 剪辑/裁剪图像

是否有某种方法(除了编写插件)来剪辑/裁剪插入到 AsciiDoc 文档中的图像?

我在文档中找不到这样的功能,但可能有一个我不知道的插件......

0 投票
1 回答
1039 浏览

asciidoctor - 自定义(多列)
在 AsciiDoctor 中?

我想布局(也许打印)我的 AsciiDoctor 文档,这是一个主要包含表格的备忘单。

获得多列 HTML 输出并获得多列 PDF 进行打印的最佳方法是什么?

我发现

可以在带有 . 的 HTML 中使用<div>,但到目前为止我手动修改了 HTML。(我只是在猜测该怎么做,因为我不是网络开发人员。)

有没有办法在 AsciiDoctor 源文件中包含这种样式和 div?

获取多列 PDF 的最佳方法是什么?

0 投票
1 回答
1173 浏览

libreoffice - asciidoc:有没有办法创建一个在 libreoffice writer 中可见的锚点?

Tl;博士;

在 docbook 中创建锚点的正确方法是什么?有没有办法让锚在作家中可见?

背景

我正在尝试将以前在单个open office文档中的文档拆分为较小的文档,这些文档既包含在主要的开放式办公文档中,也转换为&asciidoc中的一个或两个。我有这个主要工作。我用来创建html。创建 pdf 和 asciidoctor 的组合并创建 .odt 文件。我也尝试了 python 的实现,但发现接口不太好用。htmlpdfasciidoctorasciidoctor-pdfpandocasciidoc

asciidoc 和 odt 之间的往返显然是不可能的。这是一种融合,其中主文档是文字处理的,但包含可以独立生成的内容片段(想想手册页 - 实际上这是几个用例之一)。

asciidoc 到 html:

asciidoctor -b html5 foo.adoc -o foo.html

asciidoc转pdf:

asciidoctor-pdf -b pdf foo.adoc -o foo.pdf

asciidoc 到 odt

asciidoctor -b docbook foo.adoc -o foo.docbook pandoc --base-header-level=3 -V date:"" -V title:"" -f docbook foo.docbook -o foo.odt

使用 pandoc 我必须取消日期和标题,并根据需要设置标题级别,以便将要插入的部分作为额外的复杂功能插入。

insert section我使用内部开放式办公室将生成的 .odt 插入到主文档中。请注意,主文档不是主文档,因为我找不到创建主文档的方法,而无需在 h1 边界上自动拆分文件。

我有两个主要问题要解决这个设置。我想在 asciidoc 文档中添加标题作为交叉引用,并在字母索引中为它们创建条目(实际上第一个标题就足够了)。有没有办法做到这一点?asciidoc 中的索引标记不会导致在 .odt 文件中创建条目。

我可以使用“插入引用/标题”交叉引用插入部分中的内容并引用唯一命名的标题。但是,每当我使用“全部更新”时,这些交叉引用都会失效。它们显示为“错误:未找到参考源”。

[在单独的说明中,我还想要一种自动查找损坏的交叉引用的方法]

我目前正在使用 libreoffice - 版本:4.3.7.2

如果一个表现得比另一个好,我不反对切换版本或风格(即 apache)。

我不确定答案是否在链的 asciidoc 或 docbook 部分。我会接受一个答案,它会自动在插入部分的开头(.adoc/docbook 文件的顶部)插入一个索引条目。

我也愿意将我的工具链更改为可行的东西。例如,我尝试了 asciidoc-odt 后端并与https://github.com/dagwieers/asciidoc-odf/issues/47发生冲突,这并不能激发信心。使用 asciidoc-odt 我避免了创建中间文档文件的需要。但是,我仍然无法让锚出现。

我可以获得一个宏来创建一个锚点,但目前我还没有弄清楚如何从命令行运行宏。

0 投票
4 回答
8197 浏览

asciidoc - 如何在 asciidoc 中进行删除线(换行)?

如何在adoc文件中呈现删除线(或换行)?

假设我想写“那项技术是-废话-不完美”。