Python: Установка страниц руководства в проект на основе distutils

У меня есть проект Python, который в основном представляет собой набор сценариев командной строки и вспомогательный пакет. Поскольку в этих сценариях есть несколько параметров командной строки, я решил создать страницу руководства для каждого сценария и использовал ronn ( http://rtomayko.github.com/ronn/ ) для написания руководств в Markdown и создания mdoc от него.

Вопрос такой: как сгенерировать и установить справочные страницы в проекте на основе distutils?

Я пришел к следующему решению: создать простой сценарий install.sh , который генерирует и устанавливает справочные страницы. Я вызываю этот сценарий из перегруженной команды 'install' и передаю ему указанный префикс ... вы можете проверить фактический код здесь: http://github.com/novel/lc-tools .

Мне не очень нравится это решение, поскольку для простой задачи мне нужно добавить несколько хаков в setup.py и также реализовать сценарий оболочки. Более того, я использую $ {PREFIX} / share / man для пути к странице руководства, и это не подходит для всех систем, например, FreeBSD, похоже, устанавливает сторонние страницы руководства в / usr / local / man (т.е. нет share / ]).

Есть ли более элегантные способы сделать это?

17
задан bstpierre 6 October 2011 в 17:33
поделиться