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

В этом разделе описаны некоторые инструменты и утилиты среды MATE.

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

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

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

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

   Из панели

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

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

     Press Alt F2. You can change the shortcut keys that display the Run Application dialog in the tool.

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

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

   If you enter only the location of a file, an appropriate application will launch to open it. If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.org.

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

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

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

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

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

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

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

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

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

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

  Комбинация клавиш по умолчанию | Функция
  --- | ---
  Print Screen | Получить снимок всего экрана.
  Alt Print Screen | Делает снимок активного окна.

  You can use the tool to modify the default shortcut keys.

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

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

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

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

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

  Параметр | Функция
  --- | ---
  `--window` | Получить снимок активного на данный момент окна.
  `--delay=seconds` | Делает снимок рабочего стола спустя указанное количество секунд и показывает диалоговое окно Сохранить снимок экрана, с помощью которого можно сохранить снимок.
  `--include-border` | Делает снимок окна вместе с его границей.
  `--remove-border` | Делает снимок окна без его границ.
  `--border-effect=shadow` | Делает снимок экрана и добавляет эффект теневого скоса вокруг него.
  `--border-effect=border` | Делает снимок экрана и добавляет эффект границы по контуру.
  `--interactive` | Открывает окно, которое позволяет установить параметры перед выполнением снимка экрана.
  `--help` | Перечисляет параметры команды.

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

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

### Введение

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

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

### Запуск Yelp

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

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

С помощью меню Система

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

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

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

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

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

##### Окно программы просмотра справки Yelp

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

Строка меню

  Файл

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

  Правка

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

  Переход

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

  Закладки

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

  Справка

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

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

  Назад

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

  Вперед

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

  Разделы помощи

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

Область навигации

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

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

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

Для открытия документа в программе просмотра справки Yelp:

- В приложении нажмите Справка Содержание

- Используйте содержание для поиска нужного Вам документа.

- Вы можете перетянуть Docbook XML файл из Caja в окно Yelp или в ланчер.

- Нажмите клавишу F1.

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

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

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

- Нажмите Файл Новое окно

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

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

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

- Нажмите Файл Об этом документе

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

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

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

- Нажмите Файл Распечатать эту страницу

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

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

- Нажмите Файл Распечатать этот документ

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

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

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

- НажмитеФайл Закрыть окно

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

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

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

- НажмитеПравка Настройки

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

##### Окно параметров программы просмотра справки Yelp

Опции, которые доступны в этом диалоге будут иметь следующие функции:

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

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

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

  Настраиваемая ширина

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

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

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

Обзор с помощью каретки

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

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

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

- Нажмите Переход Назад

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

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

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

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

- Нажмите Переход Вперед

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

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

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

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

- Нажмите Переход Разделы помощи

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

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

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

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

- Нажмите Переход Предыдущий раздел

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

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

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

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

- Нажмите Переход Следующий раздел

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

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

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

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

- Нажмите Переход Содержание

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

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

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

- Нажмите Закладки Добавить закладку

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

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

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

Введите название закладки в тестовое полеНазвание. Нажмите Добавить для добавления закладки, или нажмите Отменитьдля отмены запроса.

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

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

- Нажмите Закладки Редактировать закладки...

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

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

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

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

Открыть

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

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

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

Удалить

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

После окончания работы с закладками нажмите кнопку Закрыть для выхода из окна редактирования закладок Окно изменения закладок.

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

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

- Нажмите Справка Содержание

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

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

##### Открытие документов из диспетчера файлов

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

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

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

`файл:`

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

      yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml

`помощь:`

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

      yelp help:mate-terminal

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

      yelp help:mate-user-guide/yelp-advanced-cmdline

`мануал:`

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

      yelp man:mate-panel

  или

      yelp 'мануал:введение(1)'
      yelp 'мануал:введение(2)'

`информация:`

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

      yelp info:make

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

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

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

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

#### Scrollkeeper

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

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

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

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

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

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

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

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

Дополнительные сведения о программе просмотра справки Yelp доступны на домашней странице проекта: `http://mate-desktop.org`. Также можно подписаться на почтовую рассылку: `http://ml.mate-desktop.org/listinfo/mate-dev`.

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

Информация о том, как принять участие в создании и обновлении документации проекта MATE, опубликована на домашней странице проекта: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`