Как конвертировать AsciiDoc в Perl POD?

Question

Как преобразовать man-страницу , написанную на AsciiDoc облегченный язык разметки, автоматически в Perl POD (Обычная старая документация)?

Возможно, что-то, что преобразуется из DocBook в POD (преобразование из источников AsciiDoc в формат manpage, т.е. troff проходит через DocBook (через XML)).1017 *

Answer 1

Вы сможете выполнить это, используя a2x и 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).