perl - AsciiDoc を Perl POD に変換するには?

Question

AsciiDoc軽量マークアップ言語で書かれたマンページを Perl のPOD (Plain Old Documentation)に自動的に変換するには?

おそらく、DocBook から POD に変換するもの (AsciiDoc ソースからマンページ形式への変換、つまり troff は DocBook (XML 経由) 経由で行われます)。

Answer 1

a2xandを使用してこれを達成できるはずですrman。最初に asciidoc を man ページ形式に変換し、次にそれを 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）。