Info/ru

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

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

Формат info-страниц
Основные info-страницы располагаются в. В отличие от стиля размещения каталогов для страниц man, содержит гораздо более обширный набор файлов. Эти файлы имеют следующий формат:

формат страниц info

- это актуальное имя страницы (например:  ). является дополнительным элементом, который обозначает уровень другого узла [древовидной структуры справочной системы 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:

Resulting Recursive Download screen

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.

Navigating to other info pages
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:

Going to an info page by name

This will bring up the libc page as shown here:

Result of the Goto node command

Now that we know how to go to info pages by name, the next section will look at searching for pieces of information using the info page's index.

Searching using an 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:

Entering an index search query

After pressing enter upon completion of our query, we're brought to the  definition for   :

Result of the index search query

We've now successfully performed a search using the  info page index. However, sometimes what we want is in the page itself. The next section will look at performing searches within the page.

Searching using the search command
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):

Entering a search query

Hit  and it will show the result of the query:

Result of the search query

And we have the function we need.

Conclusion
This concludes the overview of using info to view info pages. As always comments are both welcome and appreciated. Clicking on the my name (Chris White) on the right side will send me an email.

Additional Program Resources
In order to make things easier for those that wish to browse info pages through a more friendly graphical interface, the following are available:


 * app-text/info2html - Convert info pages to a browse-able HTML format
 * app-text/pinfo -  based info viewer
 * app-text/tkinfo - a  based info browser
 * app-vim/info - a  based info browser

The  browser   also allows you to browse info pages through the   URI.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Chris White