# Инструменты и утилиты

Этот раздел посвящён вспомогательным приложениям среды GNOME.

## Запуск приложений

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

Чтобы выполнить команду из командной строки, произведите следующие действия:

1. Открыть диалоговое окно Выполнить программу можно любым из следующих способов:

   Из панели

     Можно добавить кнопку Выполнить программу на любую панель. Смотрите . Нажмите кнопку Выполнить программу на панели, чтобы открыть диалоговое окно Выполнить программу.

   Используя комбинацию клавиш

     Нажмите Alt F2. Можно изменить эту комбинацию, открывающую диалоговое окно Выполнить программу, в инструменте параметров Комбинации клавиш клавиатуры.

   Показывается диалоговое окно Выполнить программу.

2. Введите в пустое поле команду, которую хотите выполнить, или выберите из списка известных приложений.

   Если вы введёте только местоположение файла, для его открытия будет запущено подходящее приложение. Если вы введёте адрес веб-страницы, она будет открыта вашим веб-браузером по умолчанию. В начале адресов веб-страниц добавляйте приставку «http://», например http://www.gnome.org.

   Чтобы выбрать одну из недавно выполнявшихся команд, щёлкните на стрелке вниз, расположенной сбоку от поля команды, затем выберите нужную команду.

   Также можно использовать кнопку С файлом для выбора файла, добавляемого к командной строке. Напрмер, можно указать команду текстового редактора emacs и выбрать редактируемый файл.

   Выберите параметр В терминале, чтобы приложение или команда запустились в окне терминала. Этот параметр необходим для тех приложений и команд, которые не создают собственного окна.

3. Нажмите кнопку Запустить в диалоге Выполнить программу.

## Создание снимков экрана

Можно создать снимок экрана следующими способами:

- Из любой панели

  Можно добавить кнопку Получить снимок экрана на любую панель. Подробнее о том, как это сделать, смотрите . Нажмите кнопку Получить снимок экрана, чтобы сделать снимок всего экрана.

- Используя комбинацию клавиш

  Чтобы сделать снимок экрана, используйте следующие комбинации клавиш:

  Комбинация клавиш по умолчанию | Функция
  --- | ---
  Print Screen | Получить снимок всего экрана.
  Alt Print Screen | Takes a screenshot of the window which is active.

  Можно использовать инструмент Комбинации клавиш клавиатуры для изменения комбинаций клавиш.

- Из строки меню

  Выберите Приложения Стандартные Сделать снимок экрана.

- Из терминала

  Для получения снимка экрана можно использовать команду `gnome-screenshot`. Команда `gnome-screenshot` делает снимок всего экрана и показывает диалог Сохранить снимок экрана, с помощью которого можно сохранить снимок.

  Также команде `gnome-screenshot` можно передавать следующие параметры:

  Параметр | Функция
  --- | ---
  `--window` | Получить снимок активного на данный момент окна.
  `--delay=секунды` | Делает снимок рабочего стола спустя указанное количество секунд и показывает диалоговое окно Сохранить снимок экрана, с помощью которого можно сохранить снимок.
  `--include-border` | Takes a screenshot including the border of the window.
  `--remove-border` | Takes a screenshot without the border of the window.
  `--border-effect=shadow` | Takes a screenshot and adds a shadow bevel effect around it.
  `--border-effect=border` | Takes a screenshot and adds a border effect around it.
  `--interactive` | Opens a window that lets you set options before taking the screenshot.
  `--help` | Перечисляет параметры команды.

When you take a screenshot, the Save Screenshot dialog opens. To save the screenshot as an image file, enter the filename for the screenshot, choose a location from the drop-down list and click the Save button. You can also use the Copy to Clipboard button to copy the image to the clipboard or transfer it to another application by drag-and-drop.

## Просмотр справки в Yelp

### Введение

Программа просмотра справки Yelp позволяет вам просматривать документацию к GNOME и другим программам в различных форматах. Среди поддерживаемых форматов — файлы DocBook, страницы HTML, man и info (поддержку страниц man и info можно включить при компиляции). Несмотря на различия поддерживаемых форматов, Yelp делает всё возможное, чтобы обеспечить единый внешний вид документов вне зависимости от их изначального формата.

Программа просмотра справки Yelp поддерживает документы на различных языках. Чтобы программа Yelp могла показывать эти документы, они должны быть переведены и адаптированы для каждого языка, а также правильно установлены.

### Запуск Yelp

#### Чтобы запустить программу просмотра справки Yelp

Можно запустить Yelp следующими способами:

Из меню Система

  Выберите Справка

Из командной строки

  Выполните следующую команду: `yelp`

#### Внешний вид

После запуска программы просмотра справки Yelp появляется следующее окно.

##### Окно программы Yelp

Программа Yelp содержит следующие элементы в

Строка меню

  Файл

    Используйте это меню, чтобы открыть новое окно, получить сведения о документе, напечатать документ или закрыть окно.

  Правка

    Используйте это меню, чтобы копировать, выделять или искать текст, а также чтобы изменять параметры приложения.

  Переход

    Используйте это меню, чтобы переходить назад, вперёд или к содержанию справки. При просмотре документа в формате DocBook из этого меню можно перейти к следующему разделу, предыдущему разделу или к оглавлению документа.

  Закладки

    Используйте это меню, чтобы добавлять и изменять закладки.

  Справка

    Чтобы просмотреть сведения о программе Yelp и о её создателях, выберите пункт О программе. Чтобы открыть этот документ, выберите пункт Содержание или нажмите F1.

Панель инструментов

  Назад

    Используйте эту кнопку, чтобы перейти назад по истории просмотра.

  Вперёд

    Используйте эту кнопку, чтобы перейти вперёд по истории просмотра.

  К темам справки

    Используйте эту кнопку, чтобы вернуться к основному оглавлению (которое показывает ).

Панель навигации

  В области навигации показывается оглавление документации. Используйте это оглавление, чтобы перейти к нужной вам документации.

### Использование Yelp

#### Открытие документа

To open a document in Yelp Help Browser:

- In an application, click Help Contents

- Use the Table of Contents to navigate to the desired document.

- You can drag a Docbook XML file from Nautilus to the Yelp window or launcher.

- Press the F1 key.

Также можно просмотреть конкретный документ, вызвав Yelp из командной строки или перетащив файл в Yelp. Подробнее об этом смотрите .

#### Создание нового окна

Чтобы создать новое окно:

- Выберите Файл Создать окно

- Используйте комбинацию клавиш Ctrl N

#### Сведения о документе

Чтобы просмотреть сведения о текущем документе:

- Выберите Файл О этом документе

Эта возможность доступна только для документации в формате DocBook. Обычно в этом разделе указывается юридическая информация и перечисляются авторы документа.

#### Печать страницы

Чтобы распечатать любую страницу, отображаемую в программу просмотра справки Yelp:

- Выберите Файл Распечатать эту страницу

#### Печать документа

Чтобы распечатать весь документ:

- Выберите Файл Распечатать этот документ

Эта возможность доступна только для документации в формате DocBook.

#### Закрытие окна

Чтобы закрыть окно программы просмотра справки Yelp, сделайте следующее:

- Выберите Файл Закрыть окно

- Используйте комбинацию клавиш Ctrl W

#### Изменение параметров

Чтобы изменить параметры в программе просмотра справки Yelp:

- Выберите Правка Параметры

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

##### Окно параметров Yelp

Параметры в этом диалоговом окне имеют следующее предназначение:

Использовать системные шрифты

  Выберите этот параметр, если вы хотите, чтобы при показе документации использовались стандартные шрифты среды GNOME.

  Чтобы выбрать собственные шрифты показа документации, отключите этот параметр и нажмите кнопки рядом с надписями Переменная ширина и Фиксированная ширина.

  Переменная ширина

    Этот шрифт используется, когда нет нужды в шрифте с постоянной или фиксированной шириной. К такому типу относится большинство текста.

  Фиксированная ширина

    Этот шрифт используется, когда все символы в тексте должны иметь одинаковую ширину. Обычно этим шрифтом выделяются команды, куски программ и другой текст, относящийся к этим категориям.

Отображать курсор

  Выберите этот параметр, если хотите видеть курсор в . Это облегчит вам просмотр документа, так как будет отображаться указатель текущего положения.

#### Переход назад по истории просмотра

Чтобы вернуться назад по истории просмотра:

- Выберите Переход Назад

- Используйте комбинацию клавиш Alt Влево

- Используйте кнопку Назад на панели инструментов

#### Переход вперёд по истории просмотра

Для перехода вперёд по истории просмотра:

- Выберите Переход Вперёд

- Используйте комбинацию клавиш Alt Вправо

- Используйте кнопку Вперёд на панели инструментов

#### Переход к темам справки

Чтобы перейти к темам справки:

- Выберите Переход К темам справки

- Используйте комбинацию клавиш Alt Home

- Используйте кнопку К темам справки на панели инструментов

#### Переход к предыдущему разделу

Чтобы перейти к предыдущему разделу:

- Выберите Переход К предыдущему разделу

- Используйте комбинацию клавиш Alt Вверх

Эта возможность доступна только в документах формата DocBook.

#### Переход к следующему разделу

Чтобы перейти к следующему разделу:

- Выберите Переход К следующему разделу

- Используйте комбинацию клавиш Alt Вниз

Эта возможность доступна только в документах формата DocBook.

#### Переход к содержанию

Чтобы перейти к содержанию документа:

- Выберите Переход Содержание

Эта возможность доступна только в документах формата DocBook.

#### Добавление закладки

Чтобы добавить закладку в определённый документ:

- Выберите Закладки Добавить закладку

- Используйте комбинацию клавиш Ctrl D

Появится окно, подобное тому, которое показывает .

##### Окно добавления закладки

Введите название закладки в поле Заголовок. Затем нажмите Добавить для добавления закладки или Отменить для отмены действия.

#### Изменение закладок

Чтобы изменить ваш набор закладок:

- Выберите Закладки Изменить закладки

- Используйте комбинацию клавиш Ctrl B

Появится окно, подобное тому, которое показывает .

##### Окно изменения закладок

С помощью этого окна можно производить следующие действия над закладками:

Открыть

  Используйте эту кнопку, чтобы открыть выделенную закладку в новом окне.

Переименовать

  Используйте эту кнопку, чтобы изменить заголовок вашей закладки.

Удалить

  Используйте эту кнопку, чтобы удалить закладку из вашего набора.

Когда вы закончите разбирать ваши закладки, нажмите кнопку Закрыть, чтобы выйти из окна изменения закладок.

#### Получение справки

Чтобы получить справку по использованию программы Yelp (и увидеть этот документ):

- Выберите Справка Содержание

### Дополнительные возможности

#### Открытие отдельных документов

##### Открытие документов из файлового менеджера

Чтобы открыть документ — например, XML-файл — из файлового менеджера, откройте документ в файловом менеджере Nautilus, или перетащите значок из Nautilus на окно документа или кнопку запуска Yelp.

##### Использование командной строки для открытия документов

Программа Yelp может открывать документы из командной строки. Можно использовать несколько видов адресов URI, в том числе:

`file:`

  Используйте этот тип URI, если хотите отобразить файл в Yelp, например:

      yelp file:///usr/share/gnome/help/gcalctool/ru/gcalctool.xml

`ghelp:` или `gnome-help:`

  Используйте этот тип URI, если хотите отобразить один из файлов справки GNOME, которые обычно пишутся в формате DocBook.

      yelp ghelp:gcalctool

  Если нужно открыть справочный документ на определённом разделе, добавьте в конце URI знак вопроса и идентификатор раздела.

      yelp ghelp:user-guide?yelp-advanced-cmdline

`man:`

  Используйте этот тип URI, если хотите обратиться к одной из страниц руководства man. Можно добавить секцию руководства man, если в различных секциях присутствуют страницы с одинаковым именем. Номер секции должен быть заключён в скобки, поэтому аргумент нужно экранировать, чтобы скобки не воспринимались командной оболочкой.

      yelp man:gcalctool

  или

      yelp 'man:intro(1)'
      yelp 'man:intro(2)'

`info:`

  Используйте этот тип URI, если хотите обратиться к одной из страниц GNU info.

      yelp info:make

#### Обновление содержимого по запросу

Программа просмотра справки Yelp поддерживает комбинацию клавиш Ctrl R, которая перезагружает отображаемый документ DocBook. Таким образом разработчики могут просматривать вносимые в документ изменения по мере их добавления.

### Дополнительные сведения

В этом разделе описаны некоторые вспомогательные приложения, которые используются в программе просмотра справки Yelp, и приведены ссылки на ресурсы, в которых можно получить больше информации о Yelp.

#### Scrollkeeper

Программа Yelp использует Scrollkeeper, чтобы создавать перечень документации в форматах DocBook и HTML, а также для отслеживания переводов каждого документа на различные языки.

#### Утилиты документации GNOME

Документация, распространяемая с GNOME, использует этот набор утилит для разных целей:

- Облегчение перевода документации на различные языки.

- Обеспечение набора средств, упрощающих упаковку и установку документации в правильное место, а также регистрацию документов в Scrollkeeper.

- Преобразование из формата DocBook в подходящий для отображения формат.

Программа просмотра справки Yelp опирается на таблицы стилей GNOME XSLT Stylesheets для преобразования документации формата DocBook в HTML. Утилиты сборки документации GNOME обеспечивают разработчикам приложений возможность устанавливать и регистрировать документацию в системе справки.

#### Домашняя страница и список рассылки

Для получения дополнительной информации о программе просмотра справки Yelp посетите веб-сайт проекта документирования, http://live.gnome.org/Yelp, или подпишитесь на список рассылки gnome-doc-devel-list@gnome.org.

### Вступление в проект документирования GNOME

Если вы хотите помочь в создании и обновлении документации для проекта GNOME, посетите веб-сайт проекта документирования: http://live.gnome.org/DocumentationProject