Как разобрать man-страницы в Windows?

Question

Вот сырая справочная страница. Есть ли способ, как я могу разобрать его под Windows, чтобы сделать его более читабельным?

Answer 1

Похоже, этот набор инструментов для маникюра manioc вам:

Страницы руководства, также называемые справочными страницами, являются хорошо поддерживаемым и популярным способом документирования программного обеспечения в операционных системах Unix, BSD и GNU/Linux. Программа для форматирования текста необходима для обработки внутренних форматов man-страниц в других форматах, подходящих для просмотра. Системы GNU/Linux обычно используют groff, а некоторые системы BSD, например OpenBSD, используют набор программ mandoc в качестве средства форматирования текста. Однако для просмотра справочных страниц в Windows вам все еще нужна программа форматирования. Поэтому мы решили собрать для Windows основные программы пакета mandoc и собрать двоичные файлы для загрузки с кратким объяснением использования и сборки из исходных кодов.

Answer 2

Я связан с веб-страницей, которую JakeGould опубликовал в своем ответе. Я перенес суть Mandoc Suite в Windows (MinGW/MSYS) и создал эту страницу. Спасибо авторам и участникам Mandoc Suite и MinGW/MSYS! Итак, у вас есть 3 варианта:

1. Перейти на мою страницу Просмотр справочных страниц в Windows и MinGW/MSYS, прочитать заявление об отказе от ответственности :) пожалуйста, загрузите zip-файл с предварительно собранными двоичными файлами, например, mdocml-1.13.1-win32-embedeo-02.zip, извлеките локально а затем выполните одну из следующих команд в командной строке Windows (cmd.exe), указав в качестве аргумента свою страницу руководства:

   mandoc.exe openvpn.8 | more
   

   или, мой предпочтительный способ, преобразовать в HTML-страницу:

   mandoc.exe -Thtml -Oman=%N.%S.html openvpn.8 > openvpn.8.html
   

   Кроме того, это хорошая идея, чтобы знать о мандок, если вы когда-либо сталкивались с идеей написания своих собственных man-страниц. На мой взгляд, пакет mandoc превосходит набор инструментов только для roff и лучший "общий знаменатель" с точки зрения автора.

2. Однако, если ваша man-страница слишком "традиционная" roff, или если вы недовольны форматированием mandoc, вы можете отформатировать / просмотреть man-страницу с помощью GNU troff (groff). Например, вы можете получить готовые двоичные файлы groff для Windows из ezwinports.

3. Вы можете искать онлайн HTML-вариант вашей man-страницы. Однако я бы не рекомендовал этот вариант, поскольку всегда существует риск того, что онлайновый документ может охватывать версию программного обеспечения, отличную от версии, имеющейся у вас локально.