# Инструменти и помощни програми

Този раздел обяснява някои от инструментите и помощните програми в работната среда 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 страници и информационни страници (поддръжката за man страници и информационни страници незадължително е включена). Въпреки поддържаните различни формати, 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:`

- Използвайте този адрес, когато искате да отворите файл с yelp. Пример:

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

`help:`

- Използвайте този адрес, когато искате да отворите 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:`

- Използвайте този адрес, когато искате да отворите определена man страница. Можете да прибавите раздела на man страницата, която искате да прегледате, ако има няколко man страници със същото име. Номера на раздела трябва да е затворен в скоби и по тази причина може да е нужно да избегнете аргумента, така че шела да не интерпретира тези скоби.

      yelp man:mate-panel

  или

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

`info:`

- Използвайте този адрес, когато искате да отворите определена GNU информационна страница.

      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: