Pandoc and Manual Pages

[lionet]

Итак, надоело мне рисовать мануальные страницы через nroff. Как в asn1c, например:

Comments

[maxim]

А я после того, как ты мне показал HeVeA, так и остался на ней.

[lionet]

Из хевеи манов не сваришь.

[oleyka]

// До сих пор не понимаю, как отключить двойные пробелы в предложениях...

Я уж было подумала, ты сдался и так теперь и надо ;)

[tzirechnoy]

>что я тут копролитофагские проблемы

Фига заявочки. Запахло каким-то хипстерством.

[lionet]

Вот один из первых моих манов: http://lionet.info/ipcad/man-ipcad.html (сконвертированный в html, разумеется).

За пятнадцать-то лет можно было что-то более удобноее придумать в плане ауторинга? Ну вот и пробую хипстерские технологии. Pandoc на Хаскеле написан, если что.

[tzirechnoy]

Я, если чо, совсем не про pandoc, а тем более не про markdown.

Я про то, что ты по непонятной причине наезжаешь на вполне рабочую, более того, во многих аспектах превосходящую всех конкурентов технологию. Притом единственным аргументом наезда -- то, что её придумали 45 лет назад.

[lionet]

Причина понятна: nroff - это барьер на создание манов. Их же не каждый день пишешь, детали забываются. Я даже макросы писал на нём время от времени. Но сейчас этот барьер не нужен, потому что уже есть технологии, которые покрывают 99% современной нужды в nroff. (Мы же на тайпсеттеры не выводим вывод от nroff, правда? Только маны и пишем.) Покрывают так, что тебе не приходится напрягаться каждый раз, когда нужно что-то добавить ли поправить. Nroff как первичный формат уже является impeding фактором для создания приличного софта, а не enabling. Я год назад начал писать tcpkali, и вот только-только руки до манов дошли. А всё почему? Потому что лениво восстанавливать контекст того, как это делается, если не делать это каждый день

[angry_elf]

Лучше юзать commonmark.

[lionet]

Для чего?

[angry_elf]

Ну, CommonMark вроде как наследник Markdown, чётко специфицированный, в отличии от.

[lionet]

Отличаешь формат (markdown) от тулзы (pandoc) и воркфлоу?

[sheremetyev]

Следующий этап - писать мануальные страницы в визивиг-редакторе. Попробовал поредактировать tcpkali.man.md в Texts (бессовестная реклама :) и перегенерировать tcpkali.1. Вроде даже не сильно портится - только ширина столбцов в таблицах немного меняется и емайл в авторе перестаёт быть ссылкой.