# Caja-Actions Configuration Tool User's Manual

## Увод

Радње Цаје је проширење Цаје чија је главна функција да омогући кориснику да дода произвољне радње приручним изборницима управника датотека. Те радње могу бити уређене у изборницима и подизборницима, извезене и дељене са другим окружењима радне површи.

Програм Алат подешавања радњи Цаје је корисничко сучеље које вам допушта да тачно подесите како, где и када ваше радње треба да се појаве у приручном изборнику Цаје, и како ће се извршавати.

Алат подешавања радњи Цаје обезбеђује следеће функције:

- Дефинише и подешава радње из основа.

- Сређује радње у изборнике, подизборнике и тако редом.

- Увози и извози радње и изборнике из и у спољни свет.

Радње Цаје такође долази са додатним функцијама као што су:

- Прикључак Цаје који извози у стварном времену на Д-сабирницу тренутно изабране датотеке.

- Програм линије наредби који може да покрене сваку радњу.

  Придружен сучељу Д-сабирнице, овај програм допушта кориснику да покрене сваку радњу пречицом тастатуре, примењујући ову радњу на ставку тренутно изабрану у управнику датотека.

- Програм линије наредби који може да направи нову радњу.

Све ове функције су детаљније описане у општој документацији Радњи Цаје.

## Први кораци

### Starting Caja-Actions Configuration Tool

You can start Caja-Actions Configuration Tool in the following ways:

System menu

- Choose Preferences Look and Feel Caja-Actions Configuration Tool.

Наредба

- To start Caja-Actions Configuration Tool from a command line, type the following command:

  ``caja-actions-config-tool``

  then press Return.

  Да видите доступне опције линије наредби, упишите:

  ``caja-actions-config-tool` `--help-all``

  then press Return.

#### Прво покретање

When you start Caja-Actions Configuration Tool, the following window is displayed.

##### Caja-Actions Configuration Tool Start Up Window

Shows Caja-Actions Configuration Tool main window. Contains menubar, toolbar, display area, an empty items list in the left, several disabled properties tabs, and statusbar.

The Caja-Actions Configuration Tool main window contains the following elements:

Трака изборника.

- The menus on the menubar contain all of the commands you need to use in Caja-Actions Configuration Tool.

  Пречице су доступне за неке наредбе:

  Ctrl N

- Прави нову радњу.

Ctrl S

- Чува измењене радње и изборнике.

Ctrl Q

- Излази из програма.

Ctrl X

- Исеца текући избор, чувајући га у остави.

Ctrl C

- Умножава текући избор у оставу.

Ctrl V

- Умеће садржај оставе пре текуће ставке.

Shift Ctrl V

- Умеће садржај оставе као подставку текуће ставке.

Delete

- Брише тренутни избор.

F5

- Поново учитава радње и изборнике.

F1

- Приказује помоћ.

Трака алата.

- Several toolbars may be displayed below the menubar, depending of your choices in the View Toolbars submenu.

Списак ставки.

- The list on the left of the main window contains all items, whether they are actions or menus, currently available for edition in Caja-Actions Configuration Tool.

  Ставке се могу поређати растућим или опадајућим азбучним редом, или не поређане уопште, може их корисник непосредно сређивати и управљати њима.

  Неисправне ставке се приказују црвеном бојом.

  Измењене ставке се приказују искошеним словима.

Дугмад ређања

- Три дугмета вам омогућавају да мењате режиме ређања.

Језичци својстава.

- Десни део главног прозора приказује све што је потребно за дефинисање како, када и где ће се приказивати радње и изборници.

  Радња/Изборник

- Define in which Caja menus the item should appear, and how it will be displayed.

Наредба

- Одређује која ће се радња извршити, и који параметри јој се прослеђују.

Извршавање

- Одређује како ће се наредба извршавати.

Основе назива

- Define the basename filters the Caja selection must satisfy in order the action or menu be candidate for display.

Миме врсте

- Define the mimetype filters the Caja selection must satisfy in order the action or menu be candidate for display.

Фасцикле

- Define the folder filters the Caja selection must satisfy in order the action or menu be candidate for display.

Шеме

- Define the scheme filters the Caja selection must satisfy in order the action or menu be candidate for display.

Могућности

- Define the capability filters the Caja selection must satisfy in order the action or menu be candidate for display.

Окружење

- Define some environment conditions the Caja selection must satisfy in order the action or menu be candidate for display.

Својства

- Приказује својства ставке.

Трака стања.

- Трака стања приказује неке податке стања о тренутно изабраном реду на списку ставки.

  Ако нема одговарајућих информација за приказ, трака стања приказује број учитаних изборника, радњи и профила.

  The « read-only » icon is displayed in the right of the statusbar when appropriate.

#### Стварање ваше прве радње

У овом примеру, направићемо радњу која приказује неке информације о текућем избору.

#### Проверавање предуслова

This action will require MateDialog.

MateDialog is a program which will allow you to create a graphical user interface from a command-line.

Треба да проверите да ли је овај програм инсталиран на вашем систему, на пример уписавши следећу наредбу у терминалу:

``matedialog``

then press Return.

#### Стварање радње

To create a new action, choose Ctrl N File New action.

Нова радња ће бити уметнута на списак ставки, а њена својства приказана у језичцима на десној површи.

Натпис тренутно уређиване радње (ове) се додаје називу програма на траци наслова.

##### Основна својстава нове радње

Shows the default properties of a newly created action.

In the Items list, the new action is displayed in italic characters.

Искошена слова се користе као потсетник да ставка још није сачувана.

As another reminder that there is some pending modifications, an asterisk (« `*` ») comes to prefix the application name in the title bar.

#### Квалификација ваше нове радње

Састоји се само од избора начина на који ће се ваша радња приказивати у приручном изборнику управника датотека.

- Enter `My first action` in the Context label entry box.

  The Context label entry box contains the label of the action as you want it to be displayed in the file manager context menu.

  The label is a mandatory property of your action. If it happens to be empty, then your action will be considered as invalid by Caja-Actions: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

- Enter `This will execute an action with some parameters` in the Tooltip entry box.

  The Tooltip entry box contains the text you want to be displayed as a short help to your action.

- Select in the Icon drop-down list.

  The Icon selection defines the icon which will be associated with your action in file manager context menus and in the toolbar.

  Имате два начина да изаберете иконицу придружену вашој радњи:

  - Click on the Icon drop-down list to select an icon.

  - Click on Browse to search for an image in the filesystem.

#### Одређивање наредбе за извршавање

Када одаберете своју радњу у приручном изборнику управника датотека, извршиће се ова наредба, са аргументима по вашем избору.

Click on the Command tab to show the page which will permit you to enter the command.

##### Страница наредбе

Shows the Command tab. This tab contains the name of the profile, the command to be executed along with its parameters, and the configuration of the starting working directory.

- Enter `matedialog` in the Path entry box.

  The Path entry box defines the command which will be executed when you will select your action in the file manager context menu.

  Имате два начина за дефинисање наредбе за извршавање:

  - Enter it in the Path entry box.

  - Click on Browse to select the executable file on the filesystem.

  If the command you enter does not have an absolute path, then it will be searched for in the `PATH` variable at execution time.

- Enter `--info --text='%c selected item(s): %U'` in the Parameters entry box.

  The Parameters contains the arguments which will be passed to your command when it will be executed. These arguments may embed parameters which will be expanded at runtime.

  If both Path and Parameters are empty, then this action will be considered as invalid: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

#### Чување

To save all pending modifications, choose Ctrl S File Save.

Caja automatically takes into account your new action, and displays it in its context menu.

##### Your first action in the Caja context menu

Shows the first action in the Caja context menu.

Cliking of the item in the Caja context menu activates it, and executes the corresponding command.

##### Резултат извршавања ваше прве радње

Shows the result of the execution of your first action. This is MateDialog dialog box, displaying the URI of the selected item.

## Коришћење алата подешавања радњи Цаје

### Дефинисање услова

Whether your action will eventually be displayed in Caja file manager context menus or in its toolbar depends on the conditions you will have defined for it.

Услови могу бити одређени за место на које управник датотека тренутно показује, или за тренутно изабране ставке на том месту.

Each time the selection or the location change in the file manager, Caja-Actions checks all your actions, comparing the defined conditions against the new location and selection: all defined conditions must be satisfied in order your action be actually displayed.

#### Услови на основу основе назива

Можете да одлучите да се ваша радња појави у зависности од основе назива ставке која је тренутно изабрана у управнику датотека: можете да дефинишете да свака ставка избора мора да задовољи неку врсту основе назива, и можете истовремено да одлучите да ниједна изабрана ставка може имати неку другу врсту основе назива.

Click on the Basenames tab to show the page which will permit you to configure your basename-based conditions.

##### Услови на основу основе назива

Shows the tab which lets you define basename-based conditions.

У ствари, услови засновани на основи назива граде се као списак шаблона „мора да одговара једном“ и „не мора да одговара ни једном“. Да би ваша радња била кандидат у погледу ових услова заснованих на основи назива, сваки елемент избора мора бити важећи за све наведене услове: основа назива сваког елемента мора одговарати најмање једном од дефинисаних шаблона „мора да одговара једном“, и не сме да се подудара ни са једним од дефинисаних шаблона „не мора да одговара ни једном“.

Ако барем један елемент избора не одговара свим дефинисаним условима, тада ваша радња неће бити приказана.

Када циљате приручни изборник избора, ваши услови засновани на основи назива провераваће се у односу на тренутно изабране ставке. Када циљате приручни изборник места или траку алата, услови засновани на основи назива провераваће се у односу на основу назива тренутног места.

Дефинисање новог услова основе назива захтева два корака.

1. Дефинише нови филтер услова.

   - Press Insert or click on button to insert a new condition filter

   - Уредите новоуметнути филтер услова за основу назива који желите да поклопите.

     A basename-based condition may use « `*` » or « `?` » wildcard characters.

2. Означава да ли „мора да одговара једном“ или „не мора да одговара ни једном“ услову.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Depending of your target operating system, make sure that the Match case checkbox is activated (or not).

- When activated, all filters are considered as case sensitive, which means that `/my/file` filename is considered distinct from `/My/File` one.

  Ово је основно понашање на Јуниксоликим системима.

- When deactivated, filters are considered as case insensitive, which means that `/my/file` and `/My/File` filenames are considered the same name.

  This is most probably what you want if you target some sort of Windows system.

Removing a defined basename-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the basename-based condition is just one « `must match one of *` » condition. As all basenames always match the « `*` » condition, this just means that basename-based conditions are not considered as relevant for the action.

#### Услови на основу миме врсте

Можете да одлучите да се ваша радња појави у зависности од миме врста ставке која је тренутно изабрана у управнику датотека: можете да дефинишете да свака ставка избора мора да задовољи неку врсту миме врсте, и можете истовремено да одлучите да ниједна изабрана ставка може имати неку другу врсту миме врсте.

Click on the Mimetypes tab to show the page which will permit you to configure your mimetype-based conditions.

##### Услови на основу миме врсте

Shows the tab which lets you define mimetype-based conditions.

У ствари, услови засновани на миме врсте граде се као списак шаблона „мора да одговара једном“ и „не мора да одговара ниједном“. Да би ваша радња била кандидат у погледу ових услова заснованих на миме врсти, сваки елемент избора мора бити важећи за све наведене услове: миме врста сваког елемента мора одговарати најмање једном од дефинисаних шаблона „мора да одговара једном од“, и не сме да се подудара ни са једним од дефинисаних шаблона „не мора да одговара ни једном“.

Ако барем један елемент избора не одговара свим дефинисаним условима, тада ваша радња неће бити приказана.

Када циљате приручни изборник избора, ваши услови засновани на миме врсти провераваће се у односу на тренутно изабране ставке. Када циљате приручни изборник места или траку алата, услови засновани на миме врсти провераваће се у односу на миме врсти тренутног места, што ће бити добро позната миме врста „и-чвор/директоријум“.

Дефинисање новог услова миме врсте захтева два корака.

1. Дефинише нови филтер услова.

   - Press Insert or click on button to insert a new condition filter

   - Уредите новоуметнути филтер услова за миме врсту коју желите да поклопите.

     A mimetype must be defined as a `group/subgroup` expression.

     The « `*` » wildcard is supported only in some situations:

     - The « `*/*` » expression matches all mimetypes. As a convenient shortcut, the « `*` » literal is also accepted for this same purpose.

     - A `group/*` string matches all subgroups of `group` mimetype.

     - The `*/subgroup` string is not accepted as a valid wildcard.

2. Означава да ли „мора да одговара једном“ или „не мора да одговара ни једном“ услову.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined mimetype-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the mimetype-based condition is just one « `must match one of */*` » condition. As all mimetypes always match the « `*/*` », this just means that mimetypes are not considered as relevant for the action.

##### Пример уобичајених миме врста

`all/all`

- Поклапа све ставке.

`all/allfiles`

- Поклапа све регуларне датотеке.

`inode/directory`

- Поклапа само директоријуме.

#### Услови на основу фасцикле

Можете да одлучите да се ваша радња појави у зависности од директоријума ставке која је тренутно изабрана у управнику датотека: можете да дефинишете да свака ставка избора мора да се налази у једној хијерархији или у некој другој, и можете истовремено да одлучите да се ниједна изабрана ставка не може налазити у некој другој хијерархији.

Услов на основу фасцикле треба разумети као одредба хијерархије у којој се тренутно испитана ставка треба (или не треба) налазити: ово је шаблон по називу директоријума елемента.

Click on the Folders tab to show the page which will permit you to configure your folder-based conditions.

##### Услови на основу фасцикле

Shows the tab which lets you define folder-based conditions.

У ствари, услови засновани на фасцикли граде се као списак шаблона „мора да одговара једном“ и „не мора да одговара ниједном“. Да би ваша радња била кандидат у погледу ових услова заснованих на фасцили, сваки елемент избора мора бити важећи за све наведене услове: сваки елемент мора да се налази у једној од дефинисаних фасцикли „мора да одговара једном“, и не сме да се налази ни у једној од дефинисаних фасцикли „не мора да одговара ни једном“.

Ако барем један елемент избора не одговара свим дефинисаним условима, тада ваша радња неће бити приказана.

Када циљате приручни изборник избора, ваши услови засновани на фасцикли провераваће се у односу на тренутно изабране ставке. Када циљате приручни изборник места или траку алата, услови засновани на фасцикли провераваће се у односу на тренутно место.

Дефинисање новог услова фасцикле захтева два корака.

1. Дефинише нови филтер услова.

   - Press Insert or click on button to insert a new condition filter

   - Уредите новоуметнути филтер услова за фасциклу коју желите да поклопите.

     The « `*` » and « `?` » characters are accepted as wildcards at any level of the defined folder filter.

   - Or click on Browse to select a folder on the file system.

2. Означава да ли „мора да одговара једном“ или „не мора да одговара ни једном“ услову.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined folder-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the folder-based condition is just one « `must match one of /` » condition. As `/` is always the top of an Unix-like file system, then all selected items always match this condition.

If you target a Windows system, then this default value may not be what you actually want.

#### Услови на основу шеме

Можете да одлучите да се ваша радња појави у зависности од шема путања ставке која је тренутно изабрана у управнику датотека: можете да дефинишете да свака ставка избора мора да има неку шему; и можете истовремено да одлучите да ниједна изабрана ставка не може имати неку другу шему.

Click on the Schemes tab to show the page which will permit you to configure your scheme-based conditions.

##### Услови на основу шеме

Shows the tab which lets you define scheme-based conditions.

У ствари, услови засновани на шеми граде се као списак шаблона „мора да одговара једном“ и „не мора да одговара ниједном“. Да би ваша радња била кандидат у погледу ових услова заснованих на шеми, сваки елемент избора мора бити важећи за све наведене услове: шема сваког елемента мора одговарати најмање једном од дефинисаних шаблона „мора да одговара једном од“, и не сме да се подудара ни са једним од дефинисаних шаблона „не мора да одговара ни једном“.

Ако барем један елемент избора не одговара свим дефинисаним условима, тада ваша радња неће бити приказана.

Када циљате приручни изборник избора, ваши услови засновани на шеми провераваће се у односу на тренутно изабране ставке. Када циљате приручни изборник места или траку алата, услови засновани на шеми провераваће се у односу на шему тренутног места.

Дефинисање новог услова шеме захтева два корака.

1. Дефинише нови филтер услова.

   - Press Insert or click on button to insert a new condition filter

   - Уредите новоуметнути филтер услова за шему који желите да поклопите.

     Scheme-based conditions only accept « `*` » wildcard, which stands for « any scheme ».

   - Or click on Common to select a scheme among those predefined in Edit Preferences.

     ##### Бирање шеме из основних унапред дефинисаних

     Show the list of predefined schemes.

     Нова шема се може изабрати само овде ако већ није дефинисана као филтер шеме.

     To select a new scheme, click OK, or double-click on the desired row.

2. Означава да ли „мора да одговара једном“ или „не мора да одговара ни једном“ услову.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined scheme-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the scheme-based condition is just one « `must match one of *` » condition, which means that schemes are not relevant for this action.

#### Услови засновани на могућности

Могућности су нека својства која датотека може да прикаже кориснику.

But except for the `Local` capability, all others depend on the user who executes the command.

You may so decide that your action will appear, or not, depending on the capabilities of the selected item(s) vs. the current user.

Click on the Capabilities tab to show the page which will permit you to configure your capability-based conditions.

##### Услови засновани на могућности

Shows the tab which lets you define capability-based conditions.

У ствари, услови засновани на шеми граде се као списак шаблона „мора да одговара свим“ и „не мора да одговара ни једном“. Да би ваша радња била кандидат у погледу ових услова заснованих на могућности, сваки елемент избора мора бити важећи за све наведене услове: могућност сваког елемента мора одговарати најмање једном од дефинисаних шаблона „мора да одговара свим“, и не сме да се подудара ни са једним од дефинисаних шаблона „не мора да одговара ни једном“.

Ако барем један елемент избора не одговара свим дефинисаним условима, тада ваша радња неће бити приказана.

Када циљате приручни изборник избора, ваши услови засновани на могућности провераваће се у односу на тренутно изабране ставке. Када циљате приручни изборник места или траку алата, услови засновани на могућности провераваће се у односу на оне тренутног места.

Дефинисање новог услова могућности захтева два корака.

1. Дефинише нови филтер услова.

   - Press Insert to insert a new condition filter.

   - Уредите новоуметнути филтер услова за могућност коју желите да поклопите.

   - Or click on to open the Adding a new capability dialog box.

     ##### Управљане могућности

     Shows the list of managed capabilities.

     Нова могућност се може изабрати само овде ако већ није дефинисана као филтер могућности.

     To select a new capability, click OK, or double-click on the desired row.

2. Означава да ли „мора да одговара свим“ или „не мора да одговара ни једном“ услову.

   Click on the Must match all of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined capability-based condition is as simple as selecting it, and pressing Del (or clicking on button).

По основи, списак услова заснованих на могућности је празан. То значи да могућности не утичу много на ову радњу.

#### Услов броја избора

Можете дефинисати да ће се ваша радња појавити само ако текући избор у управнику датотека има неки тачан број, или неки тачан однос са датим бројем.

##### Случај коришћења броја избора

If your action consists in displaying the differences between two files, you may define here « `Count = (equal to) 2` ».

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

##### Услови засновани на окружењу

Shows the tab which lets you define environment-based conditions. This includes the selection count configuration, the desktop selection, along with the runtime filters.

The selection count condition is defined in the 'Appears if selection contains' frame.

##### Област услова броја избора

Focus on the Appears if selection contains frame.

Када циљате приручни изборник избора, услов броја дефинисан овде биће проверен за бројем тренутно изабраих ставки. Када циљате на приручни изборник места или траку алата, услов броја ће се проверавати у односу на нулу јер у том случају нема изабране ставке.

Да дефинишете услов броја избора:

- Select in the Count drop-down list the operator you want apply to the selection count:

  - `<` (strictly less than)
  - `=` (equal to)
  - `>` (strictly greater than)

- Унесите број упуте који желите.

The selection count defaults to « `Count > (strictly greater than) 0` », which means that the action will be a candidate to be displayed as soon as at least one item is selected in the file manager.

#### Избор радне површи

Можете дефинисати за вашу радњу:

- да ће се увек појавити,

- или ће се појавити само у неким датим окружењима,

- или се неће појавити у неким датим окружењима.

Само један избор од ове три ставке је могућ.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The desktop selection is defined in the Desktop environment frame.

##### Област избора радне површи

Focus on the Desktop environment frame.

Да дефинишете услов окружења радне површи:

1. Прво изаберите врсту филтера:

   - треба ли ваша радња да се приказује увек, без обзира на окружење радне површи?
   - треба ли ваша радња да се прикаже само у неким окружењима радне површи?
   - треба ли ваша радња да се никада не прикаже у неким окружењима радне површи?

2. Ако ваша радња не треба увек да се приказује, тада изаберите одговарајуће окружење радне површи са списка на десној страни.

The targeted desktop environment condition defaults to « `Always appear` », which means that the action will be a candidate to be displayed regardless of the current desktop environment.

#### Услов нађене извршне

Можете дефинисати да се ваша радња прикаже само ако је неки предусловни пакет инсталиран на вашем систему. То се проверава овде навођењем да та одређена датотека, познате или барем под претпоставком да је обезбеђује пакет, мора бити присутна на систему датотека, и извршива.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The executable found condition is defined in the Execution environment frame.

##### Област окружења извршавања

Focus on the Execution environment frame.

To define the relevant file, enter its full filename in the Appears if the file is executable entry box, or click on Browse to select a file on the file system.

Оставите поље празним ако овај услов није потребан вашој радњи.

Можете да угнездите неке параметре у траженом називу датотеке. Ти параметри биће динамички замењени у време извршавања вредностима које ће зависити од тренутно изабране ставке.

#### Услов регистрације Д-сабирнице

Можете дефинисати да се ваша радња појави само ако је неки дати назив регистрован на систему Д-сабирнице у време извршавања.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the relevant name, enter it in the Appears if the name is registered on D-Bus entry box.

Оставите поље празним ако овај услов није потребан вашој радњи.

Можете да угнездите неке параметре у траженом називу. Ти параметри биће динамички замењени у време извршавања вредностима које ће зависити од тренутно изабране ставке.

#### Прилагођени услови

You may define that your action will only appear if some given command outputs a `true` string on its standard output.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

This lets you define your own customized condition filter, by writing a small script which outputs, or not, the `true` string on stdout when it is ran.

To define the command, enter it in the Appears if the command outputs "true" entry box.

Оставите поље празним ако овај услов није потребан вашој радњи.

Можете да угнездите неке параметре у називу извршене датотеке или њеним опцијама. Ти параметри биће динамички замењени у време извршавања вредностима које ће зависити од тренутно изабране ставке.

#### Услови покренутог процеса

Можете дефинисати да ће се ваша радња појавити само ако нека дата извршна тренутно ради.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the binary, enter its name in the Appears if the binary is running entry box, or click on Browse to select a file on the file system.

Чак и ако овде упишете пун назив извршне датотеке, само њен основни назив ће се тражити на списку процеса у време извршавања.

Оставите поље празним ако овај услов није потребан вашој радњи.

Можете да угнездите неке параметре у траженом називу. Ти параметри биће динамички замењени у време извршавања вредностима које ће зависити од тренутно изабране ставке.

### Налажење радње

#### Подешавање циља

Shows the three fields which let you configure the target of your action.

Caja file manager may display your action in different places, depending on what you will request here, and if some item is currently selected (or not).

Click on the Action tab to show the page which will permit you to configure the locations your action targets.

#### Циљање приручног изборника избора

When Display item in selection context menu is checked, then your action will be a candidate to be displayed in Caja' context menu as soon as at least one item is selected in the file manager. Your action will so deal with currently selected item(s).In order to be actually displayed, all the conditions defined in your candidate action must be met by each item currently selected in the Caja file manager.

When an action targets the selection context menu, and is actually displayed in Caja' context menu, then it is also displayed in Caja' Edit menu.

Ова мета је штиклирана по основи.

#### Циљање приручног изборника места

When Display item in location context menu checkbox is activated, then your action will be a candidate to be displayed in Caja' context menu when the file manager selection is empty. Your action will so deal with currently displayed location. In order to be actually displayed, all the conditions defined in your candidate action must be met by the location currently displayed in the Caja file manager.

When an action targets the location context menu, and is actually displayed in Caja' context menu, then it is also displayed in Caja' File menu.

#### Циљање траке алата

When Display item in the toolbar checkbox is activated, then your action will be a candidate to be displayed in Caja' toolbar.

Радње приказане на траци алата раде само са местом које је тренутно приказано у управнику датотека, а не са ставкама које тренутно могу бити изабране (или не). Да би била приказана, сви услови дефинисани у вашој радњи кандидату морају бити задовољени тренутним местом.

#### Напомене

#### Ако ће ваша радња бити приказана у приручном изборнику

Whether it is the selection context menu or the location context menu, and both in Caja' context menus and in File or Edit menus, it will be displayed as

- the Context label as a label,

- the Icon,

- these two properties being associated with the Tooltip.

У зависности од тачног подешавања вашег радног окружења, иконица може и не мора бити приказана испред натписа у изборнику.

Можете да угнездите неке параметре у натпис, назив иконице или у облачић. Ти параметри биће динамички замењени у време извршавања вредностима које ће зависити од тренутно изабране ставке.

#### Ако ће ваша радња бити приказана на траци алата

Биће приказана као

- the Toolbar label as a label,

- the Icon,

- these two properties being associated with the Tooltip.

У зависности од тачног подешавања вашег радног окружења, натпис траке алата може и не мора бити приказан испред иконице на траци алата.

The toolbar label defaults to the same label as those used in menus. By unchecking the Use same label for icon in the toolbar checkbox you can define a label specific to the toolbar, which is usually shorter that those defined for the menus.

Можете да угнездите неке параметре у натпис траке алата, назив иконице или у облачић. Ти параметри биће динамички замењени у време извршавања вредностима које ће зависити од тренутно изабране ставке.

#### Дефинисање неколико мета

Радња може да циља на приручни изборник избора, приручни изборник места и на траку алата, или на једно или на више од ових.

#### Дефинисање уопште без мете

If no target is defined, i.e. if the three checkboxes are unchecked, then your action will never be displayed.

### Која радња треба да се изврши?

Највероватније ћете желети да се ваша радња евентуално заврши у извршавању нечега. И, у ствари, имајући нешто за извршавање је један од неколико услова који су потребни да би се радња сматрала исправном.

As we have already seen, the command to be executed is configured in the Command page.

Ова наредба може имати аргументе, који сами по себи могу угнездити параметре. Ти параметри биће раширени у време извршавања, са вредностима које ће зависити од тренутно изабране ставке.

#### Доступни параметри

In the Command page, click on Legend button to see the list of available parameters.

##### Списак доступних параметара

Shows the list of available parameters.

The Legend button has a toggling action: click once to display the Parameter Legend dialog box; click a second time to hide it.

The word « first » may be misleading as it only refers to the list of selected items internally provided by the file manager to the Caja-Actions plugin.

In particular, it has nothing to do with the visual selection you may have done in the file manager window. And, in fact, which is the « first » selected item in a multiple selection is absolutely undefined and rather unpredictable.

#### Где радња треба да се изврши?

Ваша радња се може извршити у нарочитом радном директоријуму.

You may specify it in the Command tab, in the Working directory entry box, or by clicking on Browse to select a folder on the filesystem.

##### Област радног директоријума

Focus on the working directory selection frame.

The working directory defaults to `%d`, which runs the command in the base directory of the (first) selected item.

In the particular case of the `%d` parameter, the « first » selected item is not very important because it is very likely that all selected items are located in the same base directory.

#### Како ће се извршавати радња?

Apart from configuring the conditions, the selection must be met in order your action be displayed in file manager menus, Caja-Actions allows you to configure how exactly your command will be executed.

Click on the Execution tab to show the page which configures the execution of your command.

##### Подешавање режима извршавања

Shows how to configure the execution modes of a command.

##### Режим извршења

###### Подешавање режима извршавања

Focus on the execution mode frame.

Режим извршавања ваше наредбе можете изабрати између следећих вредности:

Обичан

- Покреће наредбу као стандардно графичко корисничко сучеље.

У терминалу

- Покреће омиљени терминал радног окружења, и у њему извршава наредбу.

Угнеждено

- Користи нарочиту функцију управника датотека која може дозволити терминалу да буде покренут у њему.

  As Caja does not have this feature, this option is strictly equivalent to `Terminal` option.

Прикажи излаз

- Покреће жељени терминал радног окружења, и у њему покреће наредбу. На крају, стандардни токови (стандардни излаз, стандардна грешка) се прикупљају и приказују.

The execution mode of a command defaults to `Normal`. That is, the command is executed without any particular pre- or post-work.

##### Обавештење покретања

###### Подешавање режима покретања

Focus on the Startup mode frame.

If the execution mode of the command is `Normal`, and if you know that the application will send a `remove` message with the `DESKTOP_STARTUP_ID` environment variable set, then check the Startup notify checkbox.

See the Startup Notification Protocol Specification for more details.

##### Класа прозора

If the execution mode of the command is `Normal`, and if you know that the application will map at least one window with a given class name, then enter that name into the Startup Window Manager class entry box.

See the Startup Notification Protocol Specification for more details.

##### Власник извршавања

###### Подешавање власника покретања

Focus on the Execute as frame.

Enter in the Execute as user entry box the username or the UID of the user your command will be run as.

Ако не упишете ништа у ово поље, тада ће наредба бити извршена за текућег корисника.

##### Многострука извршавања

Можете пожелети да ваша радња буде извршена једном, достављајући јој списак изабраних ставки као аргумент.

Или ћете можда више желети да се ваша наредба понавља за сваку изабрану ставку, достављајући другу ставку као аргумент за свако извршавање.

Actually, Caja-Actions automatically handles these two behaviors, depending of the form and the order of the parameters in the command arguments.

Though some parameters are not depending on the count of the selection (e.g. « `%c` », the selection count itself), most have two declensions:

- a « singular » one, e.g. « `%b` », the basename of the selected item;

- a « plural » one, e.g. « `%B` », the space-separated list of the basenames of selected items.

Када је избор празан или садржи само један елемент, и са те тачке гледишта, ова два облика су потпуно једнака.

Када избор садржи више од једне ставке:

- if the first relevant parameter is of a singular form, then Caja-Actions will consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item;

- contrarily, if the first relevant parameter found is of the plural form, then Caja-Actions will consider that the command is able to deal with a list of items, and thus the command will be executed only once;

- if all found parameters are irrelevant, then Caja-Actions defaults to consider that the command should be executed only once.

##### Characterization of the parameters vs. multiple execution

Параметар | Опис | Понављање
`%b` | (прва) основни назив | једнина |  |
`%B` | размаком раздвојени списак назива основе |  |  | множина
`%c` | број изабраних ставки |  | небитно |
`%d` | (прва) основни директоријум | једнина |  |
`%D` | размаком раздвојени списак основних директоријума сваке изабране ставке |  |  | множина
`%f` | (прва) назив датотеке | једнина |  |
`%F` | размаком раздвојени списак изабраних назива датотека |  |  | множина
`%h` | назив домаћина (прве) изабране путање |  | небитно |
`%m` | миме врста (прве) изабране ставке | једнина |  |
`%M` | размаком раздвојени списак миме врста изабраних ставки |  |  | множина
`%n` | корисничко име (прве) изабране путање |  | небитно |
`%o` | „no-op“ оператор који приморава облик једнине извршавања | једнина |  |
`%O` | „no-op“ оператор који приморава облик множине извршавања |  |  | множина
`%p` | број прикључника (прве) изабране путање |  | небитно |
`%s` | шема (прве) изабране путање |  | небитно |
`%u` | (прва) путања | једнина |  |
`%U` | размаком раздвојени списак изабраних путања |  |  | множина
`%w` | (прва) основни назив без проширења | једнина |  |
`%W` | размаком раздвојени списак основних назива без проширења |  |  | множина
`%x` | (прва) проширење | једнина |  |
`%X` | размаком раздвојени списак проширења |  |  | множина
`%%` | the « `%` » character |  | небитно |

###### Usage of singular vs. plural forms

Say the current folder is `/data`, and the current selection contains the three files `pierre`, `paul` and `jacques`.

###### If we have requested `echo %b`,

тада ће следеће наредбе бити редом извршене:

- `echo pierre`
- `echo paul`
- `echo jacques`

This is because `%b` marks a singular parameter. The command is then run once for each of the selected items.

###### Contrarily, if we have requested `echo %B`,

тада ће следећа наредба бити извршене:

- `echo pierre paul jacques`

This is because `%B` marks a plural parameter. The command is then run only once, with the list of selected items as arguments.

###### If we have requested `echo %b %B`,

тада ће следеће наредбе бити редом извршене:

- `echo pierre pierre paul jacques`
- `echo paul pierre paul jacques`
- `echo jacques pierre paul jacques`

This is because the first relevant parameter is `%b`, and so the command is run once for each selected item, replacing at each occurrence the `%b` parameter with the corresponding item. The second parameter is computed and added as arguments to the executed command.

###### And if we have requested `echo %B %b`,

тада ће следеће наредбе бити извршене:

- `echo pierre paul jacques pierre`

This is because the first relevant parameter here is `%B`. The command is then run only once, replacing `%B` with the space-separated list of basenames. As the command is only run once, the `%b` is substituted only once with the (first) basename.

### Коришћење профила за проширење радње

Постоје неке ситуације у којима ћете желети да се дата радња понаша мало другачије у зависности од тренутно изабраних ставки или тренутног окружења времена извршавања.

#### Овде отвори терминал

Каже да имате радњу која отвара терминал на текућем месту.

Подесили сте је да отвори ваш жељени терминал на месту на које ваш управник датотека тренутно показује.

Али шта ако желите да изаберете директоријум у вашем управнику датотека, и да непосредно отворите терминал у том директоријуму? Ако наставите на основу текућег места управника датотека, ваш терминал ће се отворити у полазном из циљног директоријума.

Једно од решења је да дефинишете нови профил за вашу радњу, подешавајући тај профил да отвори терминал у циљном директоријуму.

At runtime, Caja-Actions will successively examine each profile attached to your action. If the first profile targets a file while you have selected a directory, then Caja-Actions will just try with your second profile.

To create a new profile, first select the action in the items list, then choose File New profile.

Нови профил је направљен у вашој радњи.

Сада можете да дефинишете услове који морају бити задовољени да би тај профил био изабран, и наредбу која ће бити извршена.

#### Сређивање профила унутар радње

At runtime, Caja-Actions will begin with examining the conditions set on your action.

If these conditions (the action-conditions) are met, then Caja-Actions will examine in order each profile.

If these conditions (the action-conditions) are met, then Caja-Actions will examine in order each profile.

Ако ниједан профил није пронађен исправан у време извршавања, тада ће сама радња бити сматрана неисправном, и неће бити приказана у приручном изборнику управника датотека.

Profiles of an action are ordered, and they are examined in that order at runtime. The first profile whose conditions are met will be validated, and made selectable in the Caja context menu.

Стога, сређивање профила може бити важно за вашу радњу: први исправан нађени профил је само један изабран.

Можете поређати ваше профиле у радњи на два начина.

1. Исеците профил за премештање, изаберите профил пре кога желите да уметнете исечени профил, и убаците га.

2. Кликните на профил за премештање, и превуците га на његово ново место.

### Организовање радњи у изборницима

Како ће се ваш списак радњи повећавати, највероватније ћете пожелети да их организујете у изборницима, подизборницима и тако редом.

In order to create a new menu, choose File New menu.

A menu may be created anywhere in the list of your actions, but inside of an action (i.e. not between two profiles of an action).

Као радња, тачно место где ће нови изборник бити уметнут зависи од текућег редоследа ређања:

Ручни редослед:

- Нови изборник је уметнут одмах пре текуће радње или изборника.

  Ово место се неће променити када касније измените натпис изборника.

Растући (опадајући) азбучни редослед:

- The new menu is inserted at the correct place, regarding the default « `New Caja menu` » label.

  Ово место ће се самостално изменити, сваки пут када измените натпис изборника.

As an action, too, a menu requires a label, and may have an icon and a tooltip. Also, you may define some conditions in order your menu be candidate to be displayed in Caja context menu. If the defined conditions are not met at runtime, then your whole menu, including its submenus, its actions and so on, will not be displayed.

### Ређање списка ставки

Your actions and menus will be displayed in file manager context menus in the same order that they are listed in the Items list, on the left pane of the main Caja-Actions Configuration Tool window.

Можете одлучити да:

- поређате ваше радње и изборнике растућим или опадајућим азбучним редом по њиховом натпису.

- или да не поређате, већ да ручно средите ваше радње и изборнике по вашој жељи.

#### Азбучно ређање радњи и изборника

На ове начине, радње и изборници су поређани у зависности од њиховог натписа, унутар њихових родитеља.

##### Дзгмад ређања у главном прозору

Shows the three sort buttons in the main window.

Можете да поређате ваше радње:

- Click on (resp.)button to sort your actions in ascending (resp. descending) order.

- Или да уредите одговарајуће поставке.

#### Ручно сређивање радњи и изборника

Када су ставке ручно поређане на списку, нове ставке се обично умећу управо на текућем положају.

Ипак постоји случај када је радња изабрана, а није раширена (или тренутно има само један профил). Уметањем новог профила нећете га уметнути пре радње, већ унутар радње.

Да изаберете тај режим:

- Click on button.

- Или да уредите одговарајуће поставке.

### Уређивање

With Caja-Actions Configuration Tool, you may safely cut, copy, paste to and from the clipboard.

#### Исецање/брисање

Брисање се примењује на текући избор.

Знајте да бирање и брисање свих профила радње оставља је без профила, у неисправном стању. Назив радње биће исписан црвеном бојом (јер је неисправна) и искошеним словима (јер је измењена).

#### Многоструки избор

Multiple selection is possible in Caja-Actions Configuration Tool. You can extend the current selection by pressing Ctrl or Shift while selecting an item to add to the selection.

Caja-Actions Configuration Tool only accepts homogeneous multiple selections. That is, you may select one or more profiles, or one or more actions or menus. A multiple selection containing both profiles and actions or menus is not allowed. This is because Caja-Actions Configuration Tool would not know where to paste such a selection.

Знајте да бирање неког реда значи такође и бирање садржаних у том реду. Ти садржани се називају „подразумевано изабрани“: биће део следећих радњи уређивања, али се неће узети у обзир приликом провере једноличности избора. Такође, не могу се изричито изабрати (нити поништити њихов избор).

### Чување ваших измена

To save your modifications, choose Ctrl S File Save.

Све ваше заказане измене биће сачуване. Нове ставке биће направљене првим доступним уписивим У/И достављачем.

Caja-Actions also has an Auto-save feature which is configurable in Preferences dialog box.

### Извоз радњи

### Увоз радњи

### Постављање ваших сопствених поставки

Choose Edit Preferences to access to the configuration of your preferences.

#### Поставке времена покретања

Shows the tab which lets you define runtime preferences.

#### Поставке извршавања времена покретања

Shows the tab which lets you define runtime execution preferences.

##### Избор радне површи

Let the user explicitely configure the current desktop.

#### Поставке корисничког сучеља

##### Поставке КС-а

Shows the tab which lets you define UI preferences.

#### Поставке увоза

Shows the tab which lets you define import preferences.

#### Поставке извоза

Shows the tab which lets you define export preferences.

#### Поставке шема

Shows the tab which lets you define schemes preferences.

#### Поставке У/И достављача

Shows the tab which lets you define I/O providers preferences.

## Разне информације

The new action is also displayed in red color in the items list. Red color is used as an indicator that the item is invalid, that is that the item cannot be candidate to be displayed in a Caja context menu because some of its informations are missing or erroneous. Here, and though this newly inserted action has some suitable defaults, it lacks a command to be executed to be considered valid by Caja-Actions Configuration Tool

## ТПознате грешке и ограничења

### Познате грешке

Known bugs are available on Bugzilla summary page.

If you find some new bug in Caja-Actions, you are welcome to open it by pointing your favorite browser to Bugzilla web site.

#### Позната ограничења

#### Режим извршења

As of version 3.0, execution mode may be configured in Caja-Actions Configuration Tool but is not yet honored by Caja plugin.

Ово се односи на радни директоријум, начин извршења, обавештење о покретању и параметре власника извршења.

#### Предложена пречица

As of version 3.0, suggested shortcut, as described in DES-EMA specification, cannot be configured in Caja-Actions Configuration Tool, and is not honored by Caja plugin.

#### Раздвојник изборника

As of version 3.0, menu separators cannot be configured in Caja-Actions Configuration Tool, and are not honored by Caja plugin.

One has to note that, for now, Caja file manager does not allow its plugins to define separators in the context menu.

## О алату подешавања радњи Цаје

Прво издање Радњи Цаје је написао Фредерик Руаудел (grumz@grumz.net) и Родриго Моја (rodrigo@gnome-db.org). Темељно га је побољшао Пјер Вјезер (pwieser@trychlos.org) и Волфганг Улбрих (mate@raveit.de). Тренутно га одржавају Мејтови програмери.

За уметнички рад је заслужан Улисе Перусин (uli.peru@gmail.com) и „DragonArtz“ (http://www.dragonartz.net).

Да пријавите грешку или дате предлог у вези Радњи Цаје, Алата подешавања радњи Цаје или овог упутства, пратите смернице на Мејтовој страници за примедбе, или вам више одговара, по вашем уверењу, да непосредно отворите грешку или затражите побољшање на веб сајту Бубаждаје.

## Гнуова слободна документациона дозвола

Издање 1.3, 3. новембар 2008.

Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.

Свакоме је допуштено да умножава и да прослеђује вербатим (цд) примерке документа ове лиценце, али њихово мењање није дозвољено.

0. УВОД

Сврха ове лиценце је да упутство, приручник или други сврсисходни и користан документ учини „слободним“ у смислу слободе: да се свима обезбеди ефективна слобода умножавања и расподеле, са или без измена, било комерцијално или некомерцијално. Као друго, ова лиценца задржава за аутора и издавача начин стицања заслуга за свој рад, док се не сматрају одговорним за измене које су други извршили.

Ова лиценца је врста „левог права“, што значи да изведена дела документа сама по себи морају бити слободна у истом смислу. Допуњује Гнуову Општу Јавну Лиценцу, која је лиценца левог права осмишљена за слободан софтвер.

Осмислили смо ову лиценцу како бисмо је користили за упутства слободног софтвера, јер за слободан софтвер је потребна слободна документација: слободни програм треба да долази са упутствима која дају исте слободе као и софтвер. Али ова лиценца није ограничена на софтверска упутства; може се користити за било који текстуални рад, без обзира на тему или да ли је објављен као штампана књига. Ову лиценцу препоручујемо углавном за радове чија је сврха упутство или референца.

1. ПРИМЕЊИВОСТ И ДЕФИНИЦИЈЕ

Ова лиценца се примењује на било које упутство или друго дело, на било ком медијуму, које садржи обавештење које је поставио власник ауторских права у коме се каже да се може расподељивати под одредбама ове лиценце. Ово обавештење обезбеђује свеопшта, слободна лиценца, неограниченог трајања, за коришћење тог дела под овде наведеним условима. Доле наведени „Документ“ односи се на било које такво упутство или дело. Било која јавна особа је давалац лиценце и обраћамо јој се са „ви“. Ви прихватате лиценцу ако умножите, измените или расподељујете дело на начин који захтева дозволу према закону о ауторским правима.

„Измењено издање“ документа означава свако дело које садржи документ или његов део, било умножено на цд носачу, или са изменама и/или преведено на други језик.

„Секундарни одељак“ је именовани додатак или одељак главног дела „Документа“ који се бави искључиво односом издавача или аутора документа и целокупне теме документа (или повезаним питањима) и не садржи ништа што би могло директно да потпадне унутар те целокупне теме. (На пример, ако је документ делом уџбеник математике, други одељак не може објашњавати ништа из математике.) Однос може бити ствар историјске везе са предметом или сродним питањима, или правни, комерцијални, филозофски, етички или политички став у вези са њима.

„Неизмењени одељци“ су одређени „Секундарни одељци“ чији су наслови, као наслови неизмењених одељака, назначени у обавештењу које каже да је документ објављен под овом лиценцом. Ако одељак не одговара горњој дефиницији „секундарног“, тада није дозвољено да буде означен као „Неизмењен“. Документ може садржати нула неизмењених одељака. Ако документ не препознаје ниједан неизмењени одељак, онда их нема.

„Текстови корица“ су одређени кратки делови текста који су наведени, као текст предње или задње корице, у обавештењу које каже да је документ издат под овом лиценцом. Текст предње корице може имати највише 5 речи, а текст задње корице може имати највише 25 речи.

„Транспарентни“ умножак документа означава машински читљив примерак, представљен у формату чија је спецификација доступна широј јавности, који је погодан за преглед документа непосредно и управо у општим уређивачима текста или (за слике састављене од пиксела) општим програмима за сликање или (за цртеже) неким широко доступним уређивачем цртежа, и који је погодан за унос у обрађиваче текста или за аутоматско превођење у велики број формата погодним за унос у обрађиваче текста. Умножак направљен у иначе транспарентном формату датотеке чије је означавање, или недостатак означавања, уређено да спречи или обесхрабри накнадне измене од стране читача, није транспарентан. Формат слике није транспарентан ако се користи за било какву позамашну количину текста. Умножак који није „Транспарентан“ назива се „Нетранспарентним“.

Примери погодних формата за транспарентне примерке укључују обичан АСКРИ без маркирања, Тексинфо формат уноса, ЛаТеКс формат уноса, СГМЛ или ХМЛ који користе јавно доступан ДТД, и једноставни ХТМЛ, Постскрипт или ПДФ који одговара стандардима, осмишљен за измену од стране људи. Примери транспарентних формата слике укључују ПНГ, ИксЦФ и ЈПГ. Нетранспарентни формати укључују власничке формате које могу читати и уређивати само власнички програми за обраду текста, СГМЛ или ХМЛ за које ДТД и/или алати за обраду нису уопштено доступни, као и машински-створени ХТМЛ, Постскрипт или ПДФ кога произведе неки обрађивач текста само за сврхе излаза.

„Насловна страница“ значи, за штампану књигу, саму насловну страницу, као и следеће странице потребне за читко држање материјала који ова лиценца захтева да би се појавио на насловној страници. За дела у форматима која немају ниједну насловну страницу као такву, „Насловна страница“ означава текст близу најистакнутијег изгледа наслова дела, који претходи почетку текста.

„Издавач“ означава сваку особу или ентитет који расподељује примерке документа у јавност.

Одељак „Под називом АБВ“ означава именовану подјединицу документа чији је наслов тачно АБВ или садржи АБВ у заградама, пратећи текст који преводи АБВ на други језик. (Овде АБВ означава назив одређеног одељка поменутог у наставку, као што су „Захвалнице“, „Посвета“, „Одобрења“ или „Историјат“.) „Очувати наслов“ таквог одељка приликом мењања документа значи да остаје одељак „Под називом АБВ“ према овој дефиницији.

Документ може да садржи одрицање од одговорности поред обавештења у којем се наводи да се ова лиценца односи на документ. Сматра се да су ова одрицања од одговорности укључена упутом у ову лиценцу, али само у погледу одрицања од одговорности: било које друго подразумевање које могу имати ова одрицања од одговорности је ништавно и нема утицаја на значење ове лиценце.

2. УМНОЖАВАЊЕ НА ЦД НОСАЧИМА

Можете умножавати и расподељивати Документ на било ком медијуму, било комерцијалном или некомерцијалном, под условом да се ова Лиценца, обавештења о ауторским правима и обавештење о лиценци које каже да се ова Лиценца односи на Документ, репродукује у свим примерцима и да не додате никакве друге услове онима из ове лиценце. Не можете користити техничке мере да ометете или контролишете читање или даље умножавање примерака које направите или расподелите. Међутим, можете прихватити накнаду у замену за примерке. Ако расподелите довољно велик број примерака, такође морате следити услове из одељка 3.

Такође можете да позајмљујете умношке, под истим горе наведеним условима и можете јавно да приказујете умношке.

3. УМНОЖАВАЊЕ У ВЕЋЕМ БРОЈУ

Ако објавите штампане примерке (или примерке на медијумима који уопштено имајуштампане насловнице) Докумнета, у броју већем од 100, а обавештење о лиценци документа захтева Текст насловнице, морате да уврстите умношке у насловницама који садржи, јасно и читљиво, читав тај текст насловнице: текст насловне странице на првој корици, и текст задње насловнице на задњој корици. Обе корице морају такође јасно и читко да прикажу вас као издавача тих примерака. Предња корица мора да прикаже читав наслов са свим речима наслова подједнако истакнутим и видљивим. Можете да ставите и други материјал на корице као додатак. Умножавање са изменама ограниченим на корице, све док очувава наслов Документа и задовољава ове услове, може се сматрати као дословно умножавање у сваком погледу.

Ако је текст потребан за обе корице превише обиман да би стао и био читљив, треба да ставите прве делове (што више све док разумно стају) на стварну корицу, и да наставите са остатком на следећим страницама

Ако објавите или расподелите нетранспарентне примерке Документа у броју већем од 100, морате да или да укључите машински читљив транспарентан примерак уз сваки нетранспарентни примерак, или да изјавите или да са сваким нетранспарентним примерком јавно доступну локацију рачунарске мреже која садржи читав транспарентан примерак документа, без додатог материјала. Ако користите последњу опцију, морате предузети разумне пажљиве кораке када започнете расподељивање непровидних примерака у количини, како бисте били сигурни да ће овај транспарентни примерак остати тако доступан на наведеном месту најмање годину дана након последње расподеле непровидног примерка (директно или преко ваших агената или продаваца) тог издања за јавност.

Потребно је, али није обавезно, да контактирате ауторе документа и пре поновног расподељивање било ког великог броја примерака, како бисте им пружили прилику да вам обезбеде ажурирано издање документа.

4. ИЗМЕНЕ

Можете да умножавате и расподељујете Измењено издање Документа под условима горњих одељака 2 и 3, под условом да објавите измењено издање под тачно овом Лиценцом, са измењеним издањем које испуњава улогу документа, чиме се лиценцира расподела и измена измењеног издања ономе ко поседује њен умножак. Поред тога, у измењеном издању морате урадити следеће:

1. Да користите на „Насловној страници“ (и на корицама, ако постоје) наслов који се разликује од наслова Документа, и од оних из претходних издања (које би, ако их има, требало навести у одељку историјата документа). Можете користити исти наслов као и претходно издање ако изворни издавач тог издања да дозволу.

2. Испишете на „Насловној страници“, као ауторе, једну или више особа или ентитета одговорних за ауторство измена у „Измењеном издању“, заједно са најмање пет главних аутора документа (све његове главне ауторе, ако их има мање од пет).

3. Да објавите на „Насловној страници“ име издавача „Измењеног издања“, као издавач.

4. Да очувате сва обавештења о ауторским правима „Документа“.

5. Да додате одговарајуће обавештење о ауторском праву за ваше измене поред других обавештења о ауторским правима.

6. Да укључите, одмах после обавештења о ауторском праву, обавештење о лиценци које даје јавно овлашћење за коришћење „Измењеног издања“ под одредбама ове Лиценце, у облику приказаном у додатку испод.

7. Да очувате у обавештењу те лиценце пун списак „Неизмењених одељака“ и захтеваних „Текстова корица“ датих у обавештењу лиценце Документа.

8. Да укључите неизмењени примерак ове Лиценце.

9. Да сачувате одељак под насловом „Историјат“, и његов наслов, и да му додате ставку у којој се наводи барем наслов, година, нови аутори, и издавач „Измењеног издања“ како је дато на „Насловној страници“. Ако у Документу нема одељка под насловом „Историјат“, направите одељак у којем ће бити наведен наслов, година, аутори и издавач документа као што је дато на насловној страници, а затим додајте ставку која описује измењено издање како је наведено у претходној реченици.

10. Да очувате мрежну локацију, ако постоји, наведену у Документу за јавни приступ транспарентном умношку документа, а такође и мрежне локације дате у документу за претходна издања на којима је заснован. Оне се могу сместити у одељак „Историјат“. Можете изоставити мрежну локацију за дело које је објављено најмање четири године пре самог документа или ако оригинални издавач издања на које се односи да овлашћење.

11. У било ком одељку под насловом „Захвалнице“ или „Посвете“, сачувајте наслов одељка и у одељку сачувајте сву суштину и тон сваког признања сарадника и/или посвете дате у њему.

12. Да очувате све „Неизмењене одељке“ документа, неизмењене у свом тексту и својим насловима. Бројеви одељака или еквиваленти се не сматрају делом наслова одељка.

13. Да обришете сваки одељак са насловом „Одобрења“. Такав одељак се не може укључити у „Измењено издање“.

14. Да не преименујте ниједан постојећи одељак као „Одобрења“ нити да дођете у сукоб са насловом било којег „Неизмењеног одељка“.

15. Да сачувате свако одрицање од одговорности.

Ако „Измењено издање“ укључује нове уводне одељке или додатке који се квалификују као „Секундарни одељци“ и не садрже умножени материјал из Документа, можете по жељи одредити неке или све ове одељке као непроменљиве. Да бисте то урадили, додајте њихове наслове на списак „Непроменљивих одељака“ у обавештењу о лиценци измењеног издања. Ови наслови се морају разликовати од свих осталих наслова одељака.

Можете да додате одељак под насловом „Одобрења“, под условом да не садржи ништа осим одобрења вашег „Измењеног издања“ од разних страна – на пример, изјаве прегледа парњака или да је организација одобрила текст као меродавну дефиницију стандарда.

Можете да додате одломак до пет речи као „Текст предње корице“ и одломак до 25 речи као „Текст на задњој корици“, на крај списка „Текстови насловница“ у „Измењеном издању“. Само један одломак текста са предње корице и један текст са задње корице може бити додат било којим ентитетом (или путем аранжмана). Ако Документ већ садржи текст насловнице за исту корицу, који сте претходно додали ви или по договору исти ентитет у чије име делујете, не можете додати други; али можете заменити стари, уз изричито одобрење претходног издавача који је додао стари.

Аутор(и) и издавач(и) „Документа“ овом лиценцом не даје дозволу да користите његово(њихова) име(на) за рекламирање или да тврде или подразумевају одобравање било ког Измењеног издања.

КОМБИНОВАЊЕ ДОКУМЕНАТА

Можете комбиновати Документ са другим документима објављеним под овом лиценцом, под условима дефинисаним у горњем одељку 4 за измењена издања, под условом да укључите у комбинацију све „Неизмењене одељке“ свих оригиналних докумената, непромењених, и све их наведете као неизмењене одељке вашег комбинованог дела у његовом обавештењу о лиценци, и да сачувате сва њихова „Одрицања од одговорности“.

Комбиновано дело мора да садржи само један примерак ове лиценце, а више идентичних „Неизмењених одељака“ може се заменити једним примерком. Ако постоји више неизмењених одељака са истим називом, али различитим садржајем, учините наслов сваког таквог одељка јединственим додавањем на крају у загради име оригиналног аутора или издавача тог одељка, ако је познат, или јединствени број. Направите исто прилагођавање наслова одељака на списку неизмењених одељака у обавештењу о лиценци за комбиновано дело.

У комбинацији, морате комбиновати све одељке са насловом „Историјат“ у разним оригиналним документима, стварајући један одељак под насловом „Историјат“; на исти начин комбинујте све одељке са насловом „Захвалнице“ и све одељке под насловом „Посвећења“. Морате избрисати све одељке са насловом „Одобрења“.

6. ЗБИРКА ДОКУМЕНАТА

Можете да направите збирку која се састоји од „Документа“ и других докумената објављених под овом Лиценцом, а појединачне примерке ове Лиценце у разним документима можете заменити једним примерком који је укључен у збирку, под условом да поштујете правила ове Лиценце за дословно умножавање сваког од докумената у свим осталим аспектима.

Можете издвојити један документ из такве збирке, и расподелити га појединачно под овом лиценцом, под условом да у издвојени документ уметнете примерак ове лиценце и пратите ову Лиценцу у свим осталим аспектима у вези са дословним умножавањем тог документа.

7. ПРИДРУЖИВАЊЕ СА НЕЗАВИСНИМ ДЕЛИМА

Компилација Документа или његових деривата са другим одвојеним и независним документима или делима, у или на медијуму за складиштење или расподелу, назива се „агрегат“, ако ауторска права која произилазе из компилације се не користе да ограниче законска права корисника компилације ван ограничења појединачног дела. Када је Документ укључен у агрегат, ова Лиценца се не примењује на друга дела у агрегату која сама по себи не произилазе из Документа.

Ако се захтев Текста омотнице одељка 3 може применити на ове примерке Документа, тада ако је Документ мањи од половине читавог агрегата, Текст омотнице документа се може ставити на омотнице које затварају документ унутар агрегата, у електронском еквиваленту омотнице ако је документ у електронском облику. У супротном морају се појавити на штампаним корицама око целог агрегата.

8. ПРЕВОД

Превод се сматра врстом измене, тако да можете дистрибуирати преводе „Документа“ под одредбама одељка 4. Замена „Неизмењених одељака“ преводима захтева посебну дозволу њихових власника ауторских права, али можете укључити и преводе неких или свих неизмењених одељака као додатак оригиналним издањима ових неизмењених одељака. Можете укључити превод ове лиценце, и свих обавештења о лиценци у документ, и сва одрицања од одговорности, под условом да укључите и оригинално издање ове лиценце на енглеском језику и изворна издања тих обавештења и одрицања. У случају неслагања између превода и изворног издања ове Лиценце или обавештења или одрицања, преовладаће изворно издање.

Ако одељак у документу има наслов „Захвалнице“, „Посвезте“ или „Историјат“, захтев (одељак 4) да очувате његов наслов (одељак 1) обично ће захтевати измену тренутног наслова.

9. ОКОНЧАВАЊЕ

Не смете умножавати, мењати, подлиценцирати или расподељивати „Документ“ осим ако је изричито достављено под овом лиценцом. Сваки други покушај да га умножите, измените, подлиценцирате или расподелите је ништаван, и аутоматски ће укинути ваша права под овом лиценцом.

Међутим, ако престанете са свим кршењима ове лиценце, тада ваша лиценца одређеног носиоца ауторских права се поново враћа (а) привремено, осим ако и све док власник ауторских права изричито и коначно не оконча вашу лиценцу, и (б) трајно, ако носилац ауторских права не успе да вас обавести о кршењу неким разумним средствима пре 60 дана након њеног престанка.

Штавише, ваша лиценца од одређеног носиоца ауторских права се трајно враћа ако вас носилац ауторских права на неки разуман начин обавести о кршењу права, то је први пут да сте од тог носиоца ауторских права добили обавештење о кршењу ове лиценце (за било које дело), и уклоните кршење пре 30 дана од пријема обавештења.

Укидањем ваших права из овог одељка не престају да важе лиценце страна које су од вас добиле примерке или права под овом лиценцом. Ако су ваша права укинута и нису трајно враћена, пријем примерка неког или целог истог материјала не даје вам никаква права да га користите.

10. БУДУЋЕ ПРЕРАДЕ ОВЕ ЛИЦЕНЦЕ

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See Copyleft.

Сваком издању Лиценце додаје се препознатљиви број издања. Ако „Документ“ наводи да се на њега односи одређено нумерисано издање ове Лиценце „или било које новије издање“, имате опцију да следите одредбе и услове тог одређеног издања или било којег новијег издања које је објавила (не као скицу) Фондација Слободног Софтвера. Ако у документу није наведен број издања ове лиценце, можете одабрати било које издање које је икада објавила (не као скицу) Фондација Слободног Софтвера. Ако документ наводи да посредник може да одлучи која будућа издања ове лиценце се могу користити, та јавна изјава посредника о прихватању издања трајно вас овлашћује да изаберете то издање за документ.

11. ПОНОВНО ЛИЦЕНЦИРАЊЕ

„Сајт за масовну вишеауторску сарадњу“ („Massive Multiauthor Collaboration Site“ или „MMC“ сајт) означава било који Свеопште Светски Веб сервер који објављује дела заштићена ауторским правима и такође пружа истакнуте могућности било коме да их уређује. Јавни вики који свако може да уређује је пример таквог сервера. „Масовна Вишеауторска Сарадња“ (или „MMC“) садржана на сајту означава било који скуп дела заштићених ауторским правима која су тако објављена на „MMC“ сајту.

„CC-BY-SA“ означава лиценцу „Приписивања Заједничког Стваралаштва–Истоветног Дељења“ 3.0 коју је објавила Корпорација Заједничког Стваралаштва (Creative Commons Corporation), непрофитна организација са главним седиштем деловања у Сан Франциску у Калифорнији (САД), као и будућа издања копилефта те лиценце која објави та иста организација.

„Укључити“ значи објавити или поново објавити документ, у целини или делимично, као део другог документа.

„MMC“ је „подобан за поновно лиценцирање“ ако је лиценциран под овом лиценцом и ако су сва дела која су први пут објављена под овом лиценцом негде другде осим под „MMC“, а затим у потпуности или делимично уграђен у „MMC“, (1) нема текстове корица или неизмењене одељке, и (2) јесу тако укључени пре 1. новембра 2008.

Оператер „MMC“ сајта може поново објавити „MMC“ садржан на сајту под „CC-BY-SA“ на истом сајту у било које време пре 1. августа 2009. године, под условом да „MMC“ испуњава услове за поновно лиценцирање.

ДОДАТАК: Како да користите ову лиценцу за своја документа

Да бисте користили ову лиценцу у документу који сте написали, додајте примерак лиценце у документ и ставите следећа обавештења о ауторским правима и лиценцама одмах иза насловне странице:

    Copyright © YEAR YOUR NAME

    Permission is granted to copy, distribute and/or modify this document under the
    terms of the GNU Free Documentation License, Version 1.3 or any later version
    published by the Free Software Foundation; with no Invariant Sections, no
    Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in
    the section entitled “GNU Free Documentation License”.

Ако имате неизмењене одељке, текст насловне корице и текст задње корице, замените ред „са… текстом.“ следећим:

    with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts
    being LIST, and with the Back-Cover Texts being LIST.

Ако имате неизмењених одељака без насловне корице, или неку другу комбинацију ова три, стопите та два алтернативна да задовоље ситуацију.

Ако ваш документ садржи нетривијалне примере програмског кода, препоручујемо да их објавите паралелно према вашем избору лиценце слободног софтвера, као што је Гнуова Општа Јавна Лиценца, да допустите њихово коришћење у слободном софтверу.