Info/ru

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

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

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

формат имени файла info

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

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

Навигация по содержанию
После запуска команда info отобразит экран вроде этого (Часть текста содержит полезную информацию по работе с info, поэтому приведена здесь в переводе. На самом деле справка info не локализована. — Прим. пер.):

Пример экрана info

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

Переход к пункту с info-страницей wget

Как только доберетесь до этой строки, нажмите для выбора пункта меню. Это откроет info-страницу для :

info-страница wget

Теперь, когда мы получили info-страницу, в следующем разделе мы рассмотрим простую навигацию:

Основы навигации
In terms of nodes, this is considered the  node for the wget page. Consider the  node to be the same as the table of contents for that particular info page. Now to navigate the actual page itself, you have a couple of different methods. First off is the standard info method. This is using the key to move forward a page and the / keys to move back a page. This is the recommended method as it automatically advances/retreats to the appropriate node in the document. This allows for a somewhat linear browsing for those used to man pages. Another way is through the / keys. These work, but they will not advance/retreat like // will. If you want to skip entire nodes without using //, you can also use the (advance backwards) and  (advance forwards) keys.

As mentioned earlier, there are 2 ways of navigating menus. The other way will now be described here. The numbers  can be used to reference to the first-ninth menu entries in a document. This can be used to quickly peruse through documents. For example, we'll use to reach the   menu entry. So press and it will bring up the   screen:

Экран Recursive Download, открывшийся в результате

Now we're at the  screen. Here is a good time to note a few things. First off the top header section. This header shows the navigation capable from this particular screen. The page indicated by  can be accessed by pressing the  key, and the page indicated by   can be accessed by pressing the  key. Please note that this will only work for the same level. If overused you could round up in totally unrelated content. It's better to use //// to navigate in a linear fashion.

If for some reason you get lost, there are a few ways to get out. First is the key. This will take you straight to the toplevel (table of contents) for the particular info page you're browsing. If you want to return to the last page you looked out, you can do so with the key. If you want to go to the above level, you can do so with the key. Now that you have some idea of navigating a page, the next chapter will look at searching for content.

Переход к другим info-страницам
Now that you can navigate an individual info page, it's important to look at accessing other info pages. The first obvious way is to go to the info page through the  index listing of info pages. To get to the  index from deep within a document, simply press the  key. From there you can search for the appropriate page you want. However, if you know the actual page, there is an easier way through the  command. To go to an info page by name, type to bring up the prompt and enter the name of the page in parentheses:

Переход к info-странице по имени

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

Результат команды Goto node (перейти к узлу)

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

Поиск по Index-узлу
In this example we'll see how to lookup the  function of the c library using the   info page's index. You should still be at the libc info page from the last section, and if not, use the Goto node command to do so. To utilize the index search, hit the key to bring up the prompt, then enter your search term. We'll do so for  below:

Ввод запроса для поиска по Index-узлу

После нажатия ввод и введения нашего запроса, мы перемещаемся к определению  для   :

Результат поиска по Index-узлу

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

Поиск с использованием команды search
Starting from the previous location at the  node, we'll look at searching for the   variation of the   function. To perform a search, press the key to bring up the search prompt, and then enter the query (sprintf in this case):

Ввод поискового запроса

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

Результат поискового запроса

Мы получили необходимую функцию.

Выводы
This concludes the overview of using info to view info pages. As always comments are both welcome and appreciated.

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


 * - Convert info pages to a browse-able HTML format
 * -  based info viewer
 * - a  based info browser
 * - a  based info browser

браузер  также позволяет просмотр info-страниц через   URI.

Благодарности
Мы хотели бы поблагодарить следующих авторов и редакторов за их вклад в это руководство:


 * Chris White