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

This section describes some tools and utilities in the MATE Desktop.

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

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

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

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

   Из панели

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  Параметр | Функция
  `--window` | Получить снимок активного на данный момент окна.
  `--delay=`seconds`` | Делает снимок рабочего стола спустя указанное количество секунд и показывает диалоговое окно Сохранить снимок экрана, с помощью которого можно сохранить снимок.
  `--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` | Перечисляет параметры команды.

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

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

### Введение

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

Yelp Help Browser is internationalized, meaning that it has support to view documents in different languages. The documents must be localized or translated for each language and installed properly for Yelp Help Browser to be able to view them.

### Запуск Yelp

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

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

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

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

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

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

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

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

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

Yelp браузер помощи содержит следующие элементы fig-yelp-window

Menubar

- File

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

Edit

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

Go

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

Bookmarks

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

Help

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

Toolbar

- Back

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

Forward

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

Help Topics

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

Browser Pane

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

### Использование 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 Caja to the Yelp window or launcher.

- Press the F1 key.

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

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

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

- Click File New Window

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

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

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

- Click File About This Document

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

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

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

- Click File Print this Page

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

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

- Click File Print this Document

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

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

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

- Click File Close Window

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

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

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

- Click Edit Preferences

A window will appear that looks like yelp-preferences:

##### Yelp Help Browser Preferences Window

The options that are available in this dialog have the following functions:

Use system fonts

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

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

  Variable Width

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

Fixed Width

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

Browse with caret

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

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

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

- Click Go Back

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

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

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

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

- Click Go Forward

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

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

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

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

- Click Go Help Topics

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

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

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

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

- Click Go Previous Section

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

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

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

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

- Click Go Next Section

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

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

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

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

- Click Go Contents

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

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

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

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like yelp-add-bookmark.

##### Add Bookmark Window

Enter your desired bookmark title in to the Title text entry field. Then click Add to add the bookmark, or click Cancel to cancel the request.

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

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

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like yelp-edit-bookmarks.

##### Edit Bookmarks Window

You can manage your bookmarks using this window in the following ways:

Open

- Use this button to open the selected bookmark in a new window.

Rename

- Use this button to rename the title of your bookmark.

Remove

- Use this button to delete the bookmark from your collection.

Once you are finished managing your bookmarks, click the Close button to exit the Edit Bookmarks Window.

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

To get help to use Yelp Help Browser (and see this document):

- Click Help Contents

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

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

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

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

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

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

`file:`

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

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

`help:`

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

      yelp help:mate-terminal

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

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

`man:`

- Use this URI when you want to access a particular man page. You can append the section of the man page you would like to view if there are multiple man pages with the same name. The section number should be enclosed in parentheses and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.

      yelp man:mate-panel

  или

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

`info:`

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

      yelp info:make

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

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

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

This section details some helper applications which Yelp Help Browser uses, and provides resources where you can get more information about Yelp Help Browser.

#### Scrollkeeper

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

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

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

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

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

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

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

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

Для дополнительной информации о Бразуер помощи Yelp, пожалуйста посетите домашнюю страницу проекта документации , или подпиштесь на почтовую рассылку .

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

If you are interested in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: