如何将AsciiDoc转换为Perl POD？

Question

如何将用 AsciiDoc 轻量级标记语言编写的联机帮助页自动转换为Perl的 {{3 } （普通旧文档）？

也许是从DocBook转换为POD的东西（从AsciiDoc源转换为手册页格式，即troff通过DocBook（通过XML））。

Answer 1

您应该可以使用a2x和rman完成此操作，首先将asciidoc转换为手册页格式，然后将其转换为POD：

a2x -f manpage foo.1.txt
groff -e -mandoc -Tascii foo.1 | rman -f POD > foo.pod

groff命令用于解决一些格式问题 - 显然rman无法理解a2x生成的特定宏（我在此页面上发现了这条建议：{{ 3}}）。