Info/ru

В этом руководстве демонстрируются приёмы навигации по страницам справки info с использованием одноимённой команды.

Что такое info?
Большинство из вас, вероятно, знакомы с системой документации. Она хорошо подходит для быстрого поиска определённой информации, но не имеет механизмов для связывания man-страниц между собой. И здесь на помощь приходит система документации. Инструменты  позволяют создавать страницы с оглавлением и ссылками на другие страницы, облегчают навигацию в целом. В следующем разделе мы рассмотрим устройство страниц info.

Расположение страниц info
Основные страницы info расположены в каталоге. Стиль их размещения отличается от применяемого в системе man: каталог содержит не очень большой набор относительно крупных файлов. Они именуются следующим образом:

— фактическое имя страницы (например, ),   — необязательный элемент, определяющий дочерний узел (обычно имя страницы и узла выводятся сверху документа info). Для экономии свободного места страницы info сжимаются с использованием. Местоположение дополнительных info-страниц может указываться в переменной среды  (она обычно определяется через файлы в ). Отметим для начала специальный файл, он содержит перечень всех info-страниц и отображается командой info при запуске без параметров. С запуска команды info без параметров мы и начнём рассмотрение навигации по справке:

В следующей главе мы рассмотрим основы навигации по справке info.

Навигация по оглавлению
После запуска команда info отобразит экран вроде этого:

Сейчас на экране отображается множество элементов, начинающихся со звёздочки. Это пункты оглавления, они предназначены для навигации по узлам разных уровней. Выбирать их можно двумя способами. Первый мы рассмотрим сейчас, второй — позже. Нам нужно переместиться дальше по текущей странице до ссылки на info-страницу. Удерживайте стрелку вниз на клавиатуре, пока не дойдёте до пункта Wget:

Когда дойдёте до нужной строки, выберите соответствующий пункт оглавления клавишей. Откроется страница справки :

Мы добрались до нужной страницы info и в следующем разделе рассмотрим основы навигации.

Основы навигации
На экране сейчас, согласно принятой терминологии, верхний узел ( node) страницы wget. Верхние узлы можно считать оглавлениями для соответствующих info-страниц. Для навигации по текущей странице существует несколько различных методов. Первый — стандартный способ навигации в системе info — использование клавиши для перемещения на страницу вперед, а клавиш  или  для перехода на страницу назад. Мы советуем этот метод, поскольку при его использовании переход на следующий или предыдущий узел документа происходит автоматически. Это позволяет продвигаться по документу в линейной манере, как по man-странице. Другой способ навигации — клавиши и. Он работает, но, в отличие от предыдущего, не делает переходов по узлам вперёд и назад. Если вы хотите пропустить узел целиком без, и , то используйте клавиши  (переход назад) и  (переход вперёд).

Ранее упоминались два способа навигации по оглавлению. Сейчас мы опишем второй. Клавиши  можно использовать для переходов по первым девяти пунктам оглавления. Этот способ годится для быстрого изучения документов. Для примера, клавишу можно использовать для перехода по пункту. Итак, нажмём и получим экран  :

Сейчас мы на странице. Самое время обозначить некоторые моменты. Во-первых, заголовок вверху страницы. Он отображает доступные с данной страницы переходы. Страница, отмеченная как, доступна по клавише ,   — по клавише. Обратите внимание, что работает это только в рамках одного уровня. При чрезмерном использовании можно оказаться на страницах, совершенно к делу не относящихся. Лучше пользуйтесь, , , , для перемещений в линейном стиле.

Если вы по какой-либо причине потерялись, есть несколько способов сориентироваться. Первый — клавиша (TOC, table of contents), она вернёт вас к верхнему уровню (оглавлению) текущей страницы. С помощью клавиши (last) можно вернуться к предыдущей просмотренной странице. На уровень выше можно перейти по клавише (up). Теперь у вас есть представление о навигации по странице, и в следующей главе мы перейдём к поиску.

Переход к другим info-страницам
Теперь, когда вы умеете перемещаться по одной info-странице, важно взглянуть на способы получения доступа к другим страницам. Самый очевидный способ — перейти к нужной странице через узел  — оглавление, включающее список всех страниц info. Чтобы перейти к узлу  из документа любого уровня, просто нажмите. Отсюда вы можете начать поиск нужной страницы. Однако, если вам известно название нужной страницы, проще использовать команду перехода к узлу. Чтобы перейти на info-страницу по имени, нажмите (goto) — появится приглашение ко вводу — и введите название страницы в круглых скобках:

Это откроет страницу libc, как показано здесь:

Теперь мы знаем, как перейти к странице по её имени. В следующем разделе мы рассмотрим поиск информации по индексу info-страницы.

Поиск по индексу
The following example will describe how to lookup the  function of the C library using the libc info page's index. Users should still be at the libc info page from the last section, and if not, they can use the Goto node command to do so. To utilize the index search, hit the key to bring up the prompt, then enter the search term:

После ввода запроса и нажатия клавиши, мы перейдём к определению функции  info-страницы  :

Мы успешно выполнили поиск по индексу страницы. Однако, иногда требуется поиск по самому содержимому страницы. Поиск по содержимому info-страницы рассматривается в следующем разделе.

Поиск по содержимому
Начнём поиск разновидности  функции   с нашей предыдущей позиции —. Нажмите для выполнения поиска — появится приглашение ко вводу — и введите запрос (в данном случае sprintf):

Нажмите и будет показан результат запроса:

Таким образом мы нашли нужную функцию.

Заключение
На этом обзор команды info для просмотра info-страниц завершён. Как и всегда, приветствуются комментарии и замечания.

Дополнительные программные ресурсы
Программы в помощь тем, кто хочет просматривать info-страницы с использованием более дружественных графических интерфейсов:


 * — конвертирует info-страницы в формат HTML для просмотра из браузера.
 * — info-просмотрщик на.
 * — info-просмотрщик на.
 * — info-просмотрщик на базе.

В браузере  из состава   можно открывать страницы info с помощью URI, начинающихся с.