# Інструменти та утиліти

В цьому розділі описуються деякі інструменти та утиліти в середовищі 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 | Отримати знімок екрана вікна, яке є активним.

  Ви можете використовувати інструмент параметрів Комбінацій клавіш клавіатури, щоб змінити комбінації клавіш за замовчуванням.

- З рядка меню

  Choose Applications Accessories Take Screenshot.

- З термінала

  Ви можете використовувати команду `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 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-open-specific.

#### Створення нового вікна

Щоб створити нове вікно:

- 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 який ви б хотіли переглянути, якщо є кілька сторінок 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: