Як знайти документацію в моїй власній системі GNU / Linux

Багато з них нових у світі GNU / Linux вони сповнені сумнівів і не можуть швидко знайти відповідь на свої занепокоєння, іноді вони навіть не мають зв'язку, через яку можна отримати доступ до форуму підтримки, і, нарешті, приходять до думки, що Linux для них дуже важкий.

Більшість тих, хто опинився в цій ситуації, не знають, що наша власна система містить значну частину відповідей на наші первинні проблеми. По суті, в системі є три джерела документації GNU / Linux: сторінки користувача, інформаційні сторінки та посібники програми, упаковані в / usr / share / doc.

У цій статті ми докладно розповімо про кожне з цих джерел.

---

Сторінки людини

Сторінки з посібниками або "сторінки користувача" є класичними формами довідкової документації в Linux та Unix. В ідеалі ви можете шукати на сторінках керівництва будь-яку команду, файл конфігурації або бібліотеку.

На практиці Linux є вільним програмним забезпеченням, і деякі сторінки не написані або не показують їх вік. Однак сторінки, на які поширюється інформація, - це перше місце, де потрібно отримати допомогу. Щоб отримати доступ до сторінок, просто введіть людина за якою йде тема, яку слід дослідити.

Буде розпочато підкачування, тому ви натиснете q коли я закінчу читати. Наприклад, щоб знайти інформацію про команду ls, Я б написав:

$ людина ls

Знаючи частини сторінок керівництва, може бути корисним швидко перейти до потрібної інформації, ви знайдете наступні розділи на сторінці керівництва (Вставка 1):

Таблиця 1: Сторінки керівництва

ІМ'Я	Назва команди та опис
СИНТАКСИС	Як користуватися командою
ОПИС	Поглиблене пояснення того, як працює команда
ПРИКЛАДИ	Пропозиції щодо використання команди
ДИВИСЬ ТАКОЖ	Пов’язані теми (Зазвичай на сторінках man)

Розділи сторінок керівництва

Файли, що містять сторінки, зберігаються у / usr / share / man (або в / usr / man на деяких старих системах). У цьому каталозі ви побачите, що сторінки посібника упорядковані за наступними розділами (Вставка 2).

Таблиця 2: Розділи сторінок посібника

man1	Користувацькі програми
man2	Системні дзвінки
man3	Бібліотечні функції
man4	Спеціальні файли
man5	Формат файлу
man6	ігри
man7	Збірник

Кілька сторінок man

Деякі теми існують більш ніж в одному розділі. Щоб продемонструвати це, ми будемо використовувати команду що, який показує всі сторінки, доступні для цієї теми:

$ що таке printf

printf (1) - форматування та друк даних

printf (3) - відформатоване перетворення вихідних даних

У цьому випадку, людина printf це було б на сторінці розділу 1 (Користувацькі програми). Якби ми писали програму на С, нас би більше зацікавила сторінка в розділі 3 (Бібліотечні функції). Ви можете викликати певний розділ сторінок керівництва, вказавши його в командному рядку, щоб запитати printf, ми можемо написати:

$man 3 printf

Пошук правильної сторінки керівництва

Іноді буває складно знайти кілька сторінок, присвячених даній темі. У такому випадку ви можете скористатися людина -к знайти розділ ІМЯ на сторінках керівництва. Знайте, що це пошук підрядків, тому щось на зразок людина -k ls дасть вам багато результатів, ось приклад використання більш конкретного слова:

$ man -k whatis whatis (1) - друкує описи сторінок вручну

Все про це

Попередній приклад приніс нам ще кілька пунктів. Спочатку команда з приводу точно еквівалентно людина -к, (Насправді, я дам тобі секрет. Коли ти побіжиш людина -к насправді бігати з приводу за сценою).

---

Рядок коду MANPATH

Тепер ми звернемось до другого типу документації, яку ми знайдемо в нашій системі GNU / Linux. За замовчуванням програма man шукає сторінки сторінок у / usr / share / man, / usr / local / man, / usr / X11R6 / man і можливо / opt / man. іноді ви можете знайти те, що вам потрібно, додавши додатковий шлях до шляху пошуку. В цьому випадку просто відредагуйте /etc/man.conf у текстовому редакторі та додайте такий рядок:

MANPATH / opt / man

Відтепер будь-яка сторінка довідника в каталозі / opt / man буде знайдено. Пам’ятайте, що вам потрібно бігти знову зробити що додати ці нові сторінки до бази даних що.

---

Інформація про GNU

Одним з недоліків сторінок керівництва є те, що вони не підтримують гіпертекст, тому ви не можете легко переходити з однієї сторінки на іншу. Друзі GNU визнають цю ваду, тому вони винайшли інший формат документації: "інформаційні" сторінки.

Багато програм GNU постачаються з великою документацією у форматі інформаційної сторінки. Ви можете розпочати читання інформаційних сторінок за допомогою команди інформація:

Таким чином ми подамо індекс усіх інформаційних сторінок, доступних у системі. Ви можете пересуватися в них за допомогою клавіш зі стрілками, переходити за "посиланнями" (позначеними зірочкою) за допомогою клавіші Enter і вийти, натиснувши q. Клавіші базуються на Emacs, тому, якщо ви знайомі з цим редактором, вам буде легко орієнтуватися.

Для отримання додаткової інформації з використанням інформація, прочитайте їхню інформаційну сторінку. Ви повинні мати можливість керувати ними за допомогою вищезазначених клавіш:

$ інфо інформація

---

/ usr / share / doc

Є одне останнє джерело, яке може допомогти вам у системі Linux. Багато програм оснащені додатковою документацією в інших форматах: текст, PDF, PostScript, HTML, щоб назвати декілька.

Подивись на / usr / share / doc (/ usr / doc на старих системах). Ви знайдете довгий список каталогів, кожен з яких постачається разом із програмами у вашій системі. Переглядаючи цю документацію, часто можна виявити щось цікаве, наприклад, підручники або додаткову технічну документацію. Швидка перевірка виявляє купу інформації, яку можна прочитати:

$ cd / usr / share / doc

$ знайти. -тип f | wc -l

---

В інших статтях ми будемо посилатися на зовнішні джерела документації, такі як Проект документації Linux (LDP), списки розсилки та групи новин.

Джерело: Стаття взята з КУШКА і написана Майкелем Ламарет Ередією. Посилання: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org