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

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

## Изпълняване на програми

Прозореца Стартиране на програма ви дава достъп до командния ред. Когато изпълните команда в прозореца Стартиране на програма, не може да получавате изходни съобщения от командния ред.

За да изпълните команда от командния ред извършете следните стъпки:

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

   From a panel

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

   Using shortcut keys

     Press AltF2. 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 | Заснема целия екран.
  AltPrint Screen | Заснема активния прозорец.

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

- От лента с меню

  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 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 Help Browser Window

Yelp Help Browser contains the following elements in

Лента с менюта

  File

    Използвайте това меню, за да Отворите Нов прозорец, да прегледате страницата 'Относно този документ', за Отпечатване на този документ или да Затворите прозореца.

  Edit

    Използвайте това меню за Копиране, Избор на всички, Търсене... или за задаване на вашите Настройки.

  Go

    Използвайте това меню за да се Върнете, Напред, Общо съдържание. Когато преглеждате DocBook документ, използвайте това меню за Следващ раздел, Предишен раздел или Съдържание.

  Bookmarks

    Използвайте това, за да Добавите отметка(и) или да Редактирате отметка(и).

  Help

    Преглед на информация за 'Yelp преглед на помощни документи' и сътрудници на проекта през елемента Относно. Отворете този документ с елемента Съдържание или като натиснете клавиша F1.

Лента с инструменти

  Back

    Използвайте този бутон, за да се върнете назад в историята на документа.

  Forward

    Използвайте този бутон, за да се отидете напред във вашата история на документа.

  Help Topics

    Използвайте този бутон, за да се върнете в главното съдържание (показано в ).

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. Вижте за повече информация.

#### Отваряне на Нов прозорец

За да отворите нов прозорец:

- Click File New Window

- Използвайте клавишната комбинация CtrlN

#### Относно този документ

За преглед на информация за текущо отворения документ:

- Click File About This Document

Тази опция е достъпна само за DocBook документация. Обикновено в тази секция са описани легални забележки и сътрудници на документа.

#### Разпечатване на тази страница

За да разпечатате всяка страница, която можете да видите в Yelp преглед на помощни документи:

- Click File Print this Page

#### Разпечатване на документ

За да разпечатате цял документ:

- Click File Print this Document

Тази опция е налична само за DocBook документация.

#### Затваряне на прозорец

За да затворите прозорец в Yelp преглед на помощни документи, направете следното:

- Click File Close Window

- Използвайте клавишна комбинация CtrlW

#### Задаване на настройки

За да зададете Ваши настройки в Yelp преглед на помощни документи:

- Click Edit Preferences

A window will appear that looks like :

##### 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

  Натиснете тази опция, ако искате да видите курсор в . Това ви позволява да разглеждате документа по-лесно като просто посочите с курсора някъде в документа.

#### Обратно в История на документ

За да се върнете обратно в история на документ:

- Click Go Back

- Използвайте клавишната комбинация AltСтелка наляво

- Use the Back button in the Toolbar

#### Напред в История на документ

За да отидете напред в история на документ:

- Click Go Forward

- Използвайте клавишната комбинация AltСтрелка надясно

- Use the Forward button in the Toolbar

#### Отиване в Общо съдържание

За да отидете в Общо съдържание:

- Click Go Help Topics

- Използвайте клавишната комбинация AltHome

- Use the Help Topics button in the Toolbar

#### Връщане в предишен раздел

За да се върнете в предишен раздел:

- Click Go Previous Section

- Използвайте клавишната комбинация AltСтрелка нагоре

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

#### Отиване в Следващ раздел

За да отидете в следващ раздел:

- Click Go Next Section

- Използвайте клавишната комбинация AltСтрелка надолу

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

#### Отиване в Съдържание

За да отидете в съдържание на документ:

- Click Go Contents

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

#### Добавяне на отметка

За да добавите отметка за определен документ:

- Click Bookmarks Add Bookmark

- Use the key combination CtrlD

A window will appear that looks like .

##### 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 CtrlB

A window will appear that looks like .

##### 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:`

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

  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:`

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

      yelp info:make

#### Обновяване на съдържането при заявка

Yelp преглед на помощни документи поддържа клавишната комбинация CtrlR, която презарежда 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 използва този набор от помощни програми за различни неща:

- 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, `http://mate-desktop.org`, or subscribe to the mailing list, `http://ml.mate-desktop.org/listinfo/mate-dev`.

### Присъединяване към Проектът за документация на MATE

If you are interested in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`