perl - 如何将 AsciiDoc 转换为 Perl POD？

Question

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

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

Answer 1

您应该能够使用a2xand来完成此操作rman，首先将 asciidoc 转换为手册页格式，然后将其转换为 POD：

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

该groff命令用于修复一些格式问题 - 显然rman不理解由a2x（我在此页面上找到这条建议：http ://www.datastat.com/sysadminjournal/misctips.html ）产生的特定宏。