Man page (українська)

Ця сторінка потребує супровідника

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

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

Доступ до man-сторінок

Щоб відобразити man-сторінку, наберіть

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

відобразить 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-сторінки, пов'язані з паролями ("password"), введіть:

З тим же успіхом, ви також можете скористатися командою apropos:

За промовчанням ключове слово інтерпретується як регулярне вираження.

Якщо ви хочете зробити більш поглиблений пошук по всьому вмісту сторінок, використовуйте -K :

Кольорові man-сторінки

Текст сторінок може відображатися в різних кольорах, що спрощує їхчитання. Є два основні методи, що дозволяють розфарбувати сторінки - за допомогою утилітlessтаmost.

За допомогою less (рекомендується)

Перевага цього способу в тому, що less має більш багатий набір можливостей, ніж most, а також використовується за умовчанням для відображення man-сторінок.

Додайте наступні рядки у конфігураційний файл вашої командної оболонки (для Bash це файл

Виконайте команди з файлу, щоб побачити зміни:

Для Fish налаштування виглядатимуть якось так:

Щоб одразу побачити зміни (без перезапуску fish або системи), виконайте:

За допомогою most (не рекомендується)

Утиліта most виконує те саме завдання, що less іmore, але має менший набір можливостей. Налаштування кольорів для most простіше, проте потрібне додаткове налаштування для того, щоб most працював на зразок less.

Відкрийте будь-яку сторінку для перевірки.

Налаштування кольорів здійснюється в файлі користувача

/.mostrc (потрібно створити, якщо він відсутній), або у системному файлі /etc/most.conf . Приклад конфігурації:

Інший приклад, що показує, як налаштувати поєднання клавіш, подібно до less (перехід до рядка призначений на клавішу J ):

Кольорові сторінки в xterm або rxvt-unicode

Швидкий спосіб розфарбувати кольори man-сторінок, які проглядаються через xterm/uxterm або rxvt-unicode, полягає в редагуванні файлу

У підрозділах представлена ​​конфігурація для xterm та rxvt-unicode.

Ці налаштування замінюють зображення тексту квітами. Додайте також:

якщо ви хочете бачити кольори та зображення одночасно. Дивіться xterm(1) для опису ресурсу терміналу veryBoldColors .

rxvt-unicode

Після внесення змін до файлу виконайте:

Запустіть xterm/uxterm або rxvt-unicode, і ви повинні побачити кольорові man-сторінки. Ці налаштування додають кольори для слів, написанихнапівжирниміпідкресленимшрифтом у xterm/uxterm , і кольори для слів унапівжирним,підкресленим, іпохилимнакресленнях в rxvt-unicode . Ви також можете поєднувати ці атрибути в різних комбінаціях.

Перегляд локальних сторінок

Крім того, ви можете встановити такі пакети з офіційних репозиторіїв:

2. yelp - Help Browser зі складу GNOME.

Конвертування сторінок у HTML

Встановіть пакет mandoc AUR. Щоб конвертувати сторінку, наприклад, free(1) , наберіть:

Файл free.html, що вийшов, тепер можна відкрити в будь-якому веб-браузері.

Сконвертуйте сторінку командою:

Інша корисна функція man2html - експорт у звичайний текстовий файл, який можна надрукувати:

Реалізація утиліти man від GNU також дозволяє відкрити сторінку у веб-браузері:

Команда запустить браузер, встановлений у змінному оточенні BROWSER. Ви можете вказати браузер явно, передавши шлях до файлу, що виконується відразу після опції -H .

Для конвертування сторінки виконайте:

Конвертування у PDF

Man-сторінки завжди були зручними для друку: вони написані у форматі troff, який є друкарською мовою. Якщо у вас встановленоghostscript, конвертування man-сторінок у PDF виконати дуже просто:

За цим посиланням ви можете подивитися, як виглядатиме PDF-документ, що вийшов.

Зверніть увагу, що шрифти переважно обмежені набором Times і мають жорстко задані розміри. Документ не міститиме гіперпосилань. Деякі man-сторінки форматувалися так, щоб виглядати добре в терміналі,однак, можуть відображатися некоректно у формі PostScript або PDF-документів.

Перегляд онлайн-сторінок

Існує безліч онлайн-сховищ man-сторінок; ось невеликий список:

Корисні сторінки

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

А також сторінки, які стосуються безпосередньо Arch Linux: