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

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

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

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

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

1. Open the Run Application dialog in any of the following ways:

   From a panel

2. You can add the Run Application button to any panel. See panels-addobject. Click on the Run Application panel button to open the Run Application dialog.

Using shortcut keys

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

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

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

  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 http://, as in http://www.mate-desktop.org.

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

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

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

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

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

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

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

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

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

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

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

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

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

  Choose Applications Accessories Take Screenshot.

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

  Для получения снимка экрана можно использовать команду `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` | Перечисляет параметры команды.

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

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

### Запуск Yelp

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

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

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

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

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

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

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

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

##### Yelp Help Browser Window

Yelp Help Browser contains the following elements in 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.

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

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

- 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

  If you want to open the help document at a particular section, append a slash to the end of the URI, followed by the section id.

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

`man:`

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

      yelp man:mate-panel

  или

      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, а также для отслеживания переводов каждого документа на различные языки.

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

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

- Ease translation of documents to different languages.

- Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.

- Perform conversion from DocBook format to a format suitable for display.

Yelp Help Browser relies on MATE XSLT Stylesheets to perform conversion from DocBook to HTML. MATE Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

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

For further information on Yelp Help Browser, please visit the Documentation Project homepage, , or subscribe to the mailing list, .

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

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