问题标签 [asciidoc]

我想用 asciidoc 动态生成一个表，它看起来像这样：

也就是说，一个文本可能有多个参数，它们的值可能跨越多行。我正在寻找一种自动对齐这些的方法。我有一个程序可以收集发生变化的数据，所以我无法手动修复。

我目前所做的：我在 Parameter、Value1 和 Value2 列中有框架和无网格嵌套表。这样做的问题是它们仅在每个值不跨越多行时才对齐。

我还尝试将 Parameter、Value1 和 Value2 一起制作为嵌套表，有网格但没有框架。

它在对齐方面起作用，但看起来不太好，因为网格线不接触外部表格的网格线。添加框架也看起来很枯燥，因为它强调多参数条目。

如果有额外的参数，我真正想要做的是在外部表中添加一条额外的线（没有表嵌套），中间没有水平线。

我看不到如何用 AsciiDoc 做到这一点。这有可能吗？关于如何解决这个问题的任何其他建议？

我在一篇文章中使用 asciid。在我的文件的末尾，我想要一个数字列表。如何创建人物列表？在文档中没有找到对我有用的东西。

尝试使用 asciidoc 生成手册页时，如下所示：

我得到错误manpage document title is mandatory。我该如何解决？

我们正在考虑使用 Asciidoc 来创建用户指南，我们打算只在 github 上对单个文件进行版本控制。

然而，我们看到，像 ProGit ( https://github.com/progit/progit2/tree/master/book ) 这样的已建立项目，虽然也生成了一个文档，但将 Asciidoc 拆分为多个文件。

将一个逻辑文档拆分为多个文件有什么好处？

我是 asciidoc 的新手。我想从 java 文件中的注释 javadoc（asciidoc 格式）生成 HTML 文档。

例如java文件

我可以从 .ad 文件生成 html 文件，但我不知道如何从 javadoc 生成 .ad（或任何 asciidoc 格式文件）。
所以我想生成 .ad（asciidoc 文件），我用它来使用 asciidoctor-maven-plugin 生成 html 文档。asciidoctor-maven-plugin 将检查 sourceDirectory 中的 .ad 文件并在 outputDirectory 中生成 html 文件。

依赖

我引用了 asciidoclet，但我无法获得任何有用的信息。所有示例项目也用于生成 html、pdf、epub 等。
谢谢...

更新
我更改了我的 maven-javadoc-plugin 配置如下并执行mvn org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar，但它生成正常的 html java 文档，它应该生成 .adoc 文件。谁能帮助我我做错了什么？
谢谢...

我正在使用以下依赖项。

• asciidoctor-maven-插件
• asciidoctorj
• asciidoclet

我想将最终结果输出到特定目录中。我已经检查了命令的帮助，但没有运气。

我也搜索过互联网，但也没有运气。

我该如何做到这一点？

编辑：

看来我忽略了这个-o选项...

我可以包含完整的Greet.java文件

从 asciidoc 文件中

制作文件

但是假设我只想包含由标签分隔的代码的摘录。在上面的代码中，假设我只想包含该main函数。

我在文档中没有看到符号标签，但是这个页面表明它足以编写

和

那只会产生：

你能建议一种只包括摘录的方法吗？我正在使用 asciidoc 8.6.9。

似乎没有办法在 Asciidoc 的文字文本中解析变量（属性、替换），否则我会遗漏一些东西。我希望能够设置一个变量，然后在代码块或文字字符串中调用它，如下所示：

并让它解析为：

这不可能是不可能的，对吧？

有没有办法在AsciiDoc中执行内联条件包含宏？

我希望能够做类似的事情：

控件的数据源属性是 ifdef::wpf[ DataContext] ifdef::web[ dataSource] 并接受视图模型对象的集合。

是否有语法变化可以使这样的事情成为可能？

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

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

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

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