Блог

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

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

Вы должны быть в состоянии выполнить это с помощью a2x и 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 ).