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

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

我不确定发生了什么，或者我什至如何诊断出了什么问题。作为此过程的一部分，xml 文件 是在同一文件夹（标题为 foo.1.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 无法编译我的联机帮助页

a2x fails to compile my manpage

manpage

asciidoc