问题标签 [asciidoc]

Asciidoc支持标注。如何使用reStructuredText编写类似的标注？

我目前使用AsciiDoc来记录我的软件项目，因为它支持 PDF 和 HTML 帮助生成。我目前正在通过 Cygwin 运行它，以便a2x 工具链正常运行。这对我来说效果很好，但在其他 Windows 计算机上设置很痛苦。我一直在寻找替代方法，最近重新访问了 Sphinx。注意到它现在会生成 HTML 帮助文件，我试了一下，它似乎在我执行的小测试中运行良好。

我的问题是，有没有办法在文本中为上下文相关帮助指定地图 ID，以便我的 Windows 程序可以调用正确的帮助 API 并启动文件并将其打开到所需位置？

在我使用的 AsciiDoc 中pass::[<?dbhh topicname="_about" topicid="801"?>]。通过使用这些结构 acontext.h和alias.h与其他 HTML 帮助文件（上下文相关帮助信息）一起生成。

对于我正在编写的 gcc 备忘单，我想创建一个表，该表应该描述 gcc 如何解释不同的文件结尾。到目前为止我创建的表定义如下：

我遇到的问题是表格跨越了总页面宽度，但我想要的是每列的宽度与其最宽的条目一样宽，并且表格将只跨越它需要的宽度。

我想写一个 asciidoc 文档并将其转换为 pdf 文档。但是，我想使用与默认样式不同的格式样式。为此，我使用 asciidoc 将 txt 文件转换为 docbook，然后尝试使用 dblatex 将生成的 docbook xml 转换为 pdf 文件。这个想法是为 dblatex 设置特定的 tex 样式以获得所需的 pdf 结果。我已经复制了现有的 docbook.sty 样式，因为这里建议进行小的样式修改。在 ./docbook 文件中所做的唯一更改是 \setlength{\textwidth}{18cm} 到 \setlength{\textwidth}{12cm}。但是，当我运行命令时

或者命令

两者在样式更改中产生相同的结果：无。我的意思是，无论我对 ./docbook.sty 文件进行何种修改，这些修改都不会应用于输出。我总是获得相同的结果，即默认格式的 pdf。大家知道问题出在哪里吗？

提前致谢。

我在 AsciiDoc 中有以下标记：

[[filter-example]] .Filters 是通过矩阵运算创建的 image::figs/filter_example.png[scaledwidth="90%"]

我想在这张图片上使用 unfloat::[] 宏，但我找不到任何如何做到这一点的例子。有没有人有什么建议？

我正在寻找将 html 转换为AsciiDoc标记的 Python 工具。

谢谢！

这是我的问题，通常我将 asciidoc 文档转换为 HTML（或更准确地说是 asciidoc --> docbook --> html），但在这里我得到了一个 markdown 文档。

我希望能够从该降价文档中生成一个 HTML 文档，该文档看起来就像来自 asciidoc 一样，或者能够以某种方式将此降价转换为 asciidoc？

如何将用AsciiDoc轻量级标记语言编写的手册页自动转换为 Perl 的POD（普通旧文档）？

也许是从 DocBook 转换为 POD 的东西（从 AsciiDoc 源到联机帮助页格式的转换，即 troff 通过 DocBook（通过 XML）进行）。

我使用 asciidoc 来渲染文本。

我很难理解宏。我的目标是进行简单的宏处理（如在 LaTeX 中）。我想写两个宏：

1. FOO应该替换为"bar"
2. MYTEXT(xyz)应该替换为：（"This is my text xyz!"
   可能用不同的方式来传递参数'xyz'）

示例文件 abc.txt：

这应该导致

我希望FOOand的定义MYTEXT必须进入文件abc.conf；可能进入部分[宏]。

附加问题：

模式匹配是否存在问题，是否 FOO应替换为'bar'和？FOOX'barbar'

我偶然发现了 GitHub 拒绝在 AsciiDoc 自述文件或 wiki 页面中保留代码块中的换行符的问题。谷歌搜索该问题在 GitHub 跟踪器上产生了一个错误，该错误将问题标记为已解决而没有很好的解释。

我应该怎么做才能让 GitHub 保留换行符？