Man pages ru linux mint

man page (Русский)

man-страницы (от англ. manual — руководство) — справочные страницы, которые предоставляются почти всеми *nix-дистрибутивами, включая Arch Linux. Для их отображения служит команда man .

man-страницы изначально подразумевались как самодостаточные документы. Они ограничены в возможностях ссылаться друг на друга, в отличие от поддерживающих гиперссылки info-файлов — попытки GNU создать замену традиционному формату man-страниц.

Contents

Доступ к man-страницам

Чтобы отобразить man-страницу, наберите

Все страницы разделены на несколько категорий:

1. Основные команды
2. Системные вызовы (функции, предоставляемые ядром linux)
3. Библиотечные вызовы (функции стандартной библиотеки языка Си)
4. Специальные файлы (обычно расположенные в /dev ) и драйверы
5. Форматы файлов и соглашения
6. Игры
7. Прочие страницы (также включая соглашения)
8. Команды для системного администрирования (для которых обычно требуются права суперпользователя) и демоны

На man-страницы принято ссылаться по имени, с указанием номера категории в скобках. Часто существуют сразу несколько man-страниц с одинаковыми именами, но в разных категориях, например man(1) и man(7). В таком случае, команде man необходимо передать номер конкретной категории перед именем man-страницы, например:

отобразит man-страницу по файлу /etc/passwd вместо утилиты passwd .

Вместо того, чтобы отображать man-страницу целиком, вы можете вывести лишь ее краткое описание, используя команду whatis . Например,

выведет краткое описание команды ls: «list directory contents» («отобразить содержимое каталога»).

Формат страниц

Для удобства навигации, все man-страницы соответствуют единому стандартному формату. Вот список некоторых разделов, которые часто используются на страницах:

• NAME — имя команды и краткое однострочное описание ее назначения.
• SYNOPSIS — список опций и аргументов командной строки, которые принимает команда, либо параметры функции и ее заголовочный файл.
• DESCRIPTION — более подробное описание назначения и принципов работы команды или функции.
• EXAMPLES — типовые примеры использования, обычно от самых простых к более сложным.
• OPTIONS — описания для каждой из опций, которые принимает команда.
• EXIT STATUS — коды возврата и их значения.
• FILES — связанные с командой или функцией файлы.
• BUGS — вероятные проблемы, связанные с работой команды или функции и ожидающие решения. Также известны как KNOWN BUGS.
• SEE ALSO — список связанных команд и функций.
• AUTHOR, HISTORY, COPYRIGHT, LICENSE, WARRANTY — информация о программе: ее история, условия использования, создатели программы.

Поиск по страницам

Хотя команда man позволяет отображать man-страницы, возникает сложность, когда вы не знаете точного названия желаемой страницы. К счастью, вы можете воспользоваться опциями -k или —apropos , для поиска по ключевому слову в описаниях man-страниц.

Поиск работает только по индексированным страницам. Кеш индекса может устареть или вовсе отсутствовать, и на попытки поиска вы не будете получать ожидаемых результатов. Вы можете создать индекс или обновить его, выполнив

Индексация страниц должна запускаться при каждом добавлении man-страниц.

Теперь вы можете воспользоваться поиском. Например, чтобы найти man-страницы, связанные с паролями («password»), введите:

С тем же успехом, вы также можете воспользоваться командой apropos :

По-умолчанию, ключевое слово интерпретируется как регулярное выражение.

Если вы хотите произвести более углубленный поиск по всему содержимому страниц, используйте опцию -K :

Просмотр локальных страниц

Кроме утилиты man, для чтения man-страниц вы также можете использовать веб-браузер, например lynx или Firefox. Просмотр страниц в браузере позволяет воспользоваться основным преимуществом info-страниц — гиперссылками. Пользователи KDE могут читать man-страницы в Konqueror, используя URL вида:

Кроме того, вы можете установить следующие пакеты из официальных репозиториев:

1. xorg-xman для просмотра страниц в X.

2. yelp — Help Browser из состава GNOME.

Конвертирование страниц в HTML

mandoc

Установите пакет mandoc . Чтобы конвертировать страницу, для примера, free(1) , наберите:

Получившийся файл free.html теперь можно открыть в любом веб-браузере.

man2html

Сконвертируйте страницу командой:

Другая полезная функция man2html — экспорт в обычный текстовый файл, который можно распечатать:

man -H

Реализация утилиты man от GNU, также позволяет открыть страницу в веб-браузере:

Команда запустит браузер, установленный в переменной окружения BROWSER . Вы можете указать браузер явно, передав путь до исполняемого файла сразу после опции -H .

roffit

Для конвертирования страницы выполните:

Конвертирование в PDF

Man-страницы всегда были удобны для печати: они написаны в формате troff, который является типографским языком. Если у вас установлен ghostscript, конвертирование man-страниц в PDF выполнить очень просто:

По этой ссылке вы можете посмотреть, как будет выглядеть получившийся PDF-документ.

Обратите внимание, что шрифты главным образом ограничены набором Times и имеют жестко заданные размеры. Документ не будет содержать гиперссылок. Некоторые man-страницы форматировались так, чтобы выглядеть хорошо в терминале, однако могут отображаться некорректно в форме PostScript или PDF-документов.

Следующий perl-скрипт конвертирует man-страницы в PDF, кэшируя файлы в каталоге $HOME/.manpdf/ , и открывает программу для просмотра документа mupdf .

Просмотр онлайн-страниц

Существуют множество онлайн-хранилищ man-страниц; вот небольшой список:

Полезные страницы

Здесь приведен небольшой список полезных man-страниц, которые могут помочь вам получить более углубленные знания о множестве полезных вещей. Некоторые из них могут служить хорошими справочниками (например, таблица ASCII).

Вам могут быть интересны также и другие страницы седьмой категории:

А также страницы, относящиеся непосредственно к Arch Linux:

Источник

Локализация -Как русифицировать страницы MAN в Linux mint?

Как русифицировать страницы MAN в Linux mint?

2 ответа 2

надеюсь, я правильно понял вопрос, что интересует отображение уже готовых, а не написание новых man-страниц.

man-страницы обычно входят в пакеты с программами.

например, в пакет gnupg входят такие файлы с man-страницами:

если есть соответствующий файл в каталогах /usr/share/man/ru/*/ ( ru — это и есть «на русском»), то и man-страницу «по-русски» можно посмотреть.

согласно man man (man-страница о самой программе man ), по умолчанию на выбор языка влияет значение переменных окружения LANG , LC_MESSAGES и других, имеющих отношение к локали. (насколько мне известно, список, в порядке приоритета от большего к меньшему — LC_ALL, LANG, LC_MESSAGES, LANGUAGE ).

собственно, если у вас правильно настроены эти переменные для отображения русского языка в интерфейсе (посмотреть их все «разом» можно командой locale ), то и man-страницы будут отображаться (при наличии) — русскоязычные.

если по каким-то причинам вам не нужна перенастройка локали (или, хотя бы, переопределение какой-нибудь из перечисленных переменных), то вы можете вызвать программу man с опцией -L язык . например:

на всякий случай приведу и примеры с переназначением переменных:

для LANGUAGE имеет смысл указывать именно так — только язык ( ru ), без территории ( RU ) и набора символов ( UTF-8 ).

Источник

man page (Русский)

man-страницы (от англ. manual — руководство) — справочные страницы, которые предоставляются почти всеми *nix-дистрибутивами, включая Arch Linux. Для их отображения служит команда man .

man-страницы изначально подразумевались как самодостаточные документы. Они ограничены в возможностях ссылаться друг на друга, в отличие от поддерживающих гиперссылки info-файлов — попытки GNU создать замену традиционному формату man-страниц.

Contents

Доступ к man-страницам

Чтобы отобразить man-страницу, наберите

Все страницы разделены на несколько категорий:

1. Основные команды
2. Системные вызовы (функции, предоставляемые ядром linux)
3. Библиотечные вызовы (функции стандартной библиотеки языка Си)
4. Специальные файлы (обычно расположенные в /dev ) и драйверы
5. Форматы файлов и соглашения
6. Игры
7. Прочие страницы (также включая соглашения)
8. Команды для системного администрирования (для которых обычно требуются права суперпользователя) и демоны

На man-страницы принято ссылаться по имени, с указанием номера категории в скобках. Часто существуют сразу несколько man-страниц с одинаковыми именами, но в разных категориях, например man(1) и man(7). В таком случае, команде man необходимо передать номер конкретной категории перед именем man-страницы, например:

отобразит man-страницу по файлу /etc/passwd вместо утилиты passwd .

Вместо того, чтобы отображать man-страницу целиком, вы можете вывести лишь ее краткое описание, используя команду whatis . Например,

выведет краткое описание команды ls: «list directory contents» («отобразить содержимое каталога»).

Формат страниц

Для удобства навигации, все man-страницы соответствуют единому стандартному формату. Вот список некоторых разделов, которые часто используются на страницах:

• NAME — имя команды и краткое однострочное описание ее назначения.
• SYNOPSIS — список опций и аргументов командной строки, которые принимает команда, либо параметры функции и ее заголовочный файл.
• DESCRIPTION — более подробное описание назначения и принципов работы команды или функции.
• EXAMPLES — типовые примеры использования, обычно от самых простых к более сложным.
• OPTIONS — описания для каждой из опций, которые принимает команда.
• EXIT STATUS — коды возврата и их значения.
• FILES — связанные с командой или функцией файлы.
• BUGS — вероятные проблемы, связанные с работой команды или функции и ожидающие решения. Также известны как KNOWN BUGS.
• SEE ALSO — список связанных команд и функций.
• AUTHOR, HISTORY, COPYRIGHT, LICENSE, WARRANTY — информация о программе: ее история, условия использования, создатели программы.

Поиск по страницам

Хотя команда man позволяет отображать man-страницы, возникает сложность, когда вы не знаете точного названия желаемой страницы. К счастью, вы можете воспользоваться опциями -k или —apropos , для поиска по ключевому слову в описаниях man-страниц.

Поиск работает только по индексированным страницам. Кеш индекса может устареть или вовсе отсутствовать, и на попытки поиска вы не будете получать ожидаемых результатов. Вы можете создать индекс или обновить его, выполнив

Индексация страниц должна запускаться при каждом добавлении man-страниц.

Теперь вы можете воспользоваться поиском. Например, чтобы найти man-страницы, связанные с паролями («password»), введите:

С тем же успехом, вы также можете воспользоваться командой apropos :

По-умолчанию, ключевое слово интерпретируется как регулярное выражение.

Если вы хотите произвести более углубленный поиск по всему содержимому страниц, используйте опцию -K :

Просмотр локальных страниц

Кроме утилиты man, для чтения man-страниц вы также можете использовать веб-браузер, например lynx или Firefox. Просмотр страниц в браузере позволяет воспользоваться основным преимуществом info-страниц — гиперссылками. Пользователи KDE могут читать man-страницы в Konqueror, используя URL вида:

Кроме того, вы можете установить следующие пакеты из официальных репозиториев:

1. xorg-xman для просмотра страниц в X.

2. yelp — Help Browser из состава GNOME.

Конвертирование страниц в HTML

mandoc

Установите пакет mandoc . Чтобы конвертировать страницу, для примера, free(1) , наберите:

Получившийся файл free.html теперь можно открыть в любом веб-браузере.

man2html

Сконвертируйте страницу командой:

Другая полезная функция man2html — экспорт в обычный текстовый файл, который можно распечатать:

man -H

Реализация утилиты man от GNU, также позволяет открыть страницу в веб-браузере:

Команда запустит браузер, установленный в переменной окружения BROWSER . Вы можете указать браузер явно, передав путь до исполняемого файла сразу после опции -H .

roffit

Для конвертирования страницы выполните:

Конвертирование в PDF

Man-страницы всегда были удобны для печати: они написаны в формате troff, который является типографским языком. Если у вас установлен ghostscript, конвертирование man-страниц в PDF выполнить очень просто:

По этой ссылке вы можете посмотреть, как будет выглядеть получившийся PDF-документ.

Обратите внимание, что шрифты главным образом ограничены набором Times и имеют жестко заданные размеры. Документ не будет содержать гиперссылок. Некоторые man-страницы форматировались так, чтобы выглядеть хорошо в терминале, однако могут отображаться некорректно в форме PostScript или PDF-документов.

Следующий perl-скрипт конвертирует man-страницы в PDF, кэшируя файлы в каталоге $HOME/.manpdf/ , и открывает программу для просмотра документа mupdf .

Просмотр онлайн-страниц

Существуют множество онлайн-хранилищ man-страниц; вот небольшой список:

Полезные страницы

Здесь приведен небольшой список полезных man-страниц, которые могут помочь вам получить более углубленные знания о множестве полезных вещей. Некоторые из них могут служить хорошими справочниками (например, таблица ASCII).

Вам могут быть интересны также и другие страницы седьмой категории:

А также страницы, относящиеся непосредственно к Arch Linux:

Источник

Хочу установить русские man-страницы от AltLinux. Ошибка при установке пакета.

По какой-то неведомой причине, в Debian давно выпилили русскоязычные страницы (они были в wheezy, и это было очень удобно).

Решил сейчас попробовать поставить пару пакетов от AltLinux в Dabian Stable 9. Пакеты беру вот отсюда:

Вопрос: как обойти эту ошибку, и поставить пакет так, чтобы в системе стали работать русскоязычные маны?

Не для всех выпилили. Тот же

Может можно их ручками в /opt или /usr/local засунуть?

Я бы попробовал /usr/local/share/man

Ну я сделал следующее. Добавил такого пользователя в /etc/passwd:

где 12 — это группа man.

Стала появляться другая ошибка:

И открывается английский man.

Вот, как это обойти пока не придумал.

Попробовал еще дать команду mandb:

А что будет, если распаковать вручную в /usr/local/man и запустить mandb? Правда не приходит других идей в голову.

Там же их вроде перекодировать из кои8р надо ещё. А вообще конечно маны могут быть только на английском.

Так, кажется, нащупал.

Файлы, устанавливаемые из этих пакетов, имеют расширение *.xz.gz. А родные файлы man-страниц в Debian имеют расширение *.gz.

То есть, в следующем списке два верхних файла родные, два нижних — из AltLinux:

Вот на эти *.xz.gz команда man и ругается.

Пока не решил как исправить.

Т.е. они xz в gz сжимают? Шикардос. Вообще поехавшие.

В общем, дал в каталоге /usr/share/man/ru команду:

Вылезла еще одна проблема. В подкаталогах /usr/share/man/ru man1, man2 и т.д. еще есть куча линков. Когда переименовывались «настоящие» файлы «*.xz.gz», то в этот момент не переименовывались файлы-линки, т.к. они становились некорректными.

Поэтому пришлось написать скрипт (в баше совсем не силен, посему php), который надо от рута выполнить в каталоге /usr/share/man/ru:

Т.е. они xz в gz сжимают? Шикардос. Вообще поехавшие.

Это в ваших дебианах alien поехавший, видимо: про xz не в курсе.

Тут вот в чём дело. Есть маны из man-pages, а есть собственные маны приложений. И они, по идее, не должны пересекаться. Соответственно, если у приложения свои национальные маны есть, они есть, а пакета man-pages-ru (по составу он соответствует man-pages), как я понимаю из данной темы, нет. Ну и всяких надёрганных в man-pages-ru-extra (и отсутствующих в man-pages) тоже нет. Но в этом extra всё достаточно устаревшее, на самом деле. Плюс есть ALT-специфичное.

Источник