Question

我有一个Asciidoc文档foo.1.txt，并按照here的说明，尝试使用a2x进行编译，如下所示：

a2x --doctype manpage --format manpage foo.1.txt

在此之后，我收到以下错误：

a2x: ERROR: "/usr/bin/asciidoc.py" --backend docbook -a 
"a2x-format=manpage"  --doctype manpage  --out-file 
"/home/koz/Documents/foo.1.xml" 
"/home/koz/Documents/foo.1.txt" returned non-zero exit status 1

我不确定发生了什么，或者我怎么能诊断出错了什么。作为此过程的一部分，在同一文件夹（标题为foo.1.xml）中生成xml文件。所有帮助表示赞赏。

编辑：基于--verbose标志的使用，问题似乎在本节中：

COPYING
----------
 Copyright \(C) 2015, Koz Ross <koz.ross@runbox.com>. Free use of this software
is granted under the terms of the GNU General Public License (GPL) version 3, or
any later version.

投诉是[blockdef-listing] missing closing delimiter在COPYING所在的行。

Answer 1

COPYING
----------
 Copyright \(C) 2015, Koz Ross <koz.ross@runbox.com>. Free use of this software
is granted under the terms of the GNU General Public License (GPL) version 3, or
any later version.
----------

作品见http://asciidoctor.org/docs/asciidoc-writers-guide/#delimited-blocks 并成为：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<?asciidoc-toc?>
<?asciidoc-numbered?>

<article lang="en">
<articleinfo>
    <date>2015-10-08</date>
</articleinfo>
<simpara>COPYING</simpara>
<screen> Copyright \(C) 2015, Koz Ross &lt;koz.ross@runbox.com&gt;. Free use of this software
is granted under the terms of the GNU General Public License (GPL) version 3, or
any later version.</screen>
</article>

a2x无法编译我的联机帮助页

1 个答案: