Графический четверг: ManEdit — редактор man-страниц
03.12.2007

maneditНа протяжении долгих лет, Unix и Linux системы для удобного предоставления документации использовали man-страницы. Эти документы предоставляют короткую, сжатую информацию о командах, программах, форматах файлов, API и интерфейсах. Формат таких документов очень простой, такой документ легко вывести на дисплей в консоли или скопировать по сети. Его можно сконвертировать в pdf-формат, распечатать, используя PostScript или выложить на web-сайт.

ManEdit — это редактор man-страниц с графическим интерфейсом. С его помощью очень легко создавать и редактировать man-страницы. Главная форма редактора разделена на две части: в левой части выводится список секций текущей man-страницы (используйте правый клик мышью по ним для вызова контекстного меню). В правой части содержится область для редактирования заголовка и текста выбранной секции. Для оформления текста используется стандартная для man-страниц XML-разметка, включающая такие теги, как bold (жирный шрифт) и underline (подчеркивание текста). Нажав кнопку Preview, можно посмотреть, как будет выглядеть текущая секция после редактирования.

Несмотря на то, что у ManEdit мало возможностей по форматированию текста, он позволяет быстро создать man-страницу, даже если вы не знакомы с языком разметки man-страниц.

Примечание: Текущая версия ManEdit падает при нажатии на кнопку New. По этому поводу открыт баг: 356171. Поэтому, чтобы создать новую man-страницы, откройте уже существующую (из одной из поддиректорий /usr/share/man), отредактируйте и сохраните как новый man-файл.

Использование man-страниц:
Для просмотра man-страниц, используйте графический просмоторщик: в GNOME и KDE это yelp и khelpviewer.
Для просмотра man-страниц из консоли, используйте man command (для того, чтобы узнать, какие man-страницы есть в наличии, используйте man -k keyword или apropos keyword).
Печать man-страниц: man -t command | lpr
Конвертирование man-страниц в PDF-формат: man -t command | ps2pdf — > outputfile.pdf
Для получений html-версии man-страницы: gunzip <$(man --path command) | man2html >outputfile.html

Установка из командной строки: yum install manedit

Установка из графического установщика: Development > Development tools > manedit

Путь в меню после установки: Applications > Programming > ManEdit

Команда запуска: /usr/bin/manedit

Сайт: http://wolfpack.twu.net/ManEdit/