natgillin/translations-raw huggingface dataset:
Actions are very common in every application. You need them often when you use any application. Clicking on a toolbar icon, selecting a menu item or using a shortcut usually executes an action. In & quantaplus; actions are taken to the next level. Instead of hardcoded actions (that are created by the application programmer at the source code level) it is possible for the ordinary user to create and modify actions and by this way adding new functionality to & quantaplus;. These are the user defined actions, and many of the standard & quantaplus; actions are user defined (and user modifiable) actions as well.
Дії виконуються у кожній програмі. У них часто виникає потреба під час користування будь- якою програмою. Натискання кнопки- піктограми панелі інструментів, вибір пункту меню або використання клавіатурного скорочення, зазвичай, призводять до виконання певної дії. У & quantaplus; дії переведено на інший рівень. Замість жорстко запрограмованих дій (дій, які було створено розробником програми на рівні коду програми) у програмі передбачено можливість створення і зміни дій звичайним користувачем і, таким чином, додавання нових функціональних можливостей до & quantaplus;. Такі дії називаються діями, визначеними користувачами, значна частина стандартних дій & quantaplus; визначаються користувачами (і можуть бути змінені користувачами).
There are three types of user definable actions:
існує три типи визначених користувачем дій:
Text actions
Текстові дії
Tag actions
Дії теґів
Script actions
Дії скриптів
Creating actions
Створення дій
You can create an action by going to Settings Configure Actions. Click on New Action and you will face a similar dialog:
Створити дію можна за допомогою пункту меню Параметри Налаштувати дії. Натисніть кнопку Створити дію, і програма відкриє діалогове вікно, подібне до такого:
Specifies the action's type (Text, Tag, Script).
Вказує тип дії (Текст, Теґ, Скрипт).
The user visible name of the action.
Видима для користувача назва дії.
The button near the Text label
Кнопка, поряд з міткою Text
The icon assigned to this action. Click on it in order to change the current icon.
Піктограма, пов’ язана з цією дією. Натисніть, щоб змінити поточну піктограму.
Tool tip
Підказка
Short description of what the action does.
Короткий опис призначення дії.
Shortcut
Скорочення
The shortcut assigned to this action. Click on Custom or the button near Custom to assign a shortcut; click on None to remove the currently assigned shortcut.
Клавіатурне скорочення, пов’ язане з цією дією. Натисніть мітку Нетипове або кнопку, розташовану поруч з міткою Нетипове, щоб визначити клавіатурне скорочення. Натисніть мітку Немає, щоб вилучити поточне клавіатурне скорочення.
Container toolbars
Пенали- контейнери
The user defined toolbars where this action appears. See.
Визначені користувачем панелі інструментів, на яких з’ явиться ця дія. Див..
Detailed Settings
Детальні параметри
Specific settings for the different type of actions. See below.
Особливі параметри для різних типів дій. Див. нижче.
The simplest actions. You can enter some text in the Detailed Settings area and whenever the action is executed this text will be inserted in your document at the current cursor position. See the below example.
Найпростіші дії. Ви можете ввести текст у поле Детальні параметри. Кожного разу, коли виконуватиметься дія, цей текст буде вставлено до документа у поточну позицію курсора. Див. наведений нижче приклад.
Useful to insert XML tags, but of course you can use them for other purposes as well. lt; taggt; The name of the tag. lt; /taggt; If checked when the action is executed this text will be inserted as a closing tag. If there is a selected area in the document before you execute the action, the & lt; taggt; will be inserted before the selected area and the & lt; /taggt; after. Run "Edit tag" dialog if available If checked and there is a tagXML file for this tag, a tag editing dialog will be shown prior of inserting the tag inside the document, so you can fine-tune the tag attributes. The & lt; taggt; and & lt; /taggt; will be inserted as you've typed there. The & lt;, & gt; or the / sign wo n't be automatically appended.
Корисні для вставлення міток XML, але, звичайно ж, ви можете скористатися ними і для іншої мети. lt; теґgt; Назва теґу. lt; / теґgt; Якщо позначено, під час виконання дії цей текст буде вставлено як кінцевий теґ. Якщо у документі було позначено певний фрагмент до виконання дії, перед позначеним фрагментом буде додано & lt; теґgt;, а після фрагменту — & lt; / теґgt;. Відкрити діалогове вікно « Редагувати теґ », якщо таке вікно передбачено Якщо позначено і існує файл tagXML для відповідного теґу, перед вставлення теґу до документа буде відкрито діалогове вікно редагування. За допомогою цього вікна ви зможете остаточно налаштувати атрибути теґу. Розмітку & lt; теґgt; і & lt; / теґgt; буде вставлено точно так, як ви вказали у відповідних полях. Програма не додаватиме символів & lt;, & gt; або / у автоматичному режимі.
The most powerful action type. With the help of this action you can run external applications (usually scripts, but it's not limited to scripts), which can alter your document or use your document (or part of your document) as input. Examples from & quantaplus; itself are the Quick Start dialog, the various View In... actions for the (X)HTML DTEPs.
Цей найпотужніший тип дій. За допомогою цієї дії ви можете виконати зовнішню програму (зазвичай, скрипт, але не лише скрипт), який може змінити ваш документ або використати ваш документ (або частину документа) як вхідні дані. Прикладами у & quantaplus; є діалогове вікно Швидкий запуск, різноманітні дії Переглянути у … для DTEP (X) HTML.
First you have to enter the name of your script with the interpreter as well. Example: sh / home/ myHome/ myScript. sh.
Спершу вам слід ввести назву вашого скрипту разом з інтерпретатором. Приклад: sh / home/ myHome/ myScript. sh.
Although you can use full paths, the recommended way is to use the %scriptdir variable in the command line, like sh %scriptdir/ myScript. sh. This way & quantaplus; will try to locate your script in the following places: global script folder: $KDEDIR / share/ apps/ quanta/ scripts local script folder: $KDEHOME / share/ apps/ quanta/ scripts your path: $PATH There are other special variables that you can use in the command line:
Хоча можна вказувати шляхи повністю, варто використовувати змінну командного рядка% scriptdir, приклад: sh% scriptdir/ myScript. sh. Якщо ви скористаєтеся цією змінною, & quantaplus; спробує знайти ваш скрипт у таких теках: загальній теці скриптів: $KDEDIR / share/ apps/ quanta/ scripts локальній теці скриптів: $KDEHOME / share/ apps/ quanta/ scripts вашій змінній шляхів: $PATH Передбачено також інші спеціальні змінні, які ви можете використовувати у командному рядку:
%f: will be replaced with the URL of the current document. In case of local documents, file: / will be stripped from the document.
% f: буде замінено адресою URL поточного документа. У випадку локальних документів, рядок file: / буде вилучено.
%input: will be replaced with the selected input. See below.
% input: буде замінено вибраними вхідними даними. Див. нижче.
%projectbase: will be replaced with the URL of the current project. It is empty if no project is loaded.
% projectbase: буде замінено адресою URL поточного проекту. Вона буде порожньою, якщо проекту не буде завантажено.
%pid: will be replaced with the PID of the running & quantaplus; process. If & quantaplus; is running in unique mode, the "unique" text will be prepended to the PID number. Useful when you use DCOP to control & quantaplus; from the external script.
% pid: буде замінено на PID поточного процесу & quantaplus;. Якщо & quantaplus; запущено у режимі однієї копії, перед номером PID буде додано « unique ». Корисно, якщо ви використовуєте керування & quantaplus; за допомогою DCOP з зовнішнього скрипту.
%userarguments: useful in case of events. This entry will be replaced by the event properties in the following order:
% userarguments: корисне у випадку подій. Цей запис буде замінено властивостями події у такому порядку:
First argument
Перший аргумент
The unique id of the script
Унікальний ідентифікатор скрипту
Second argument
Другий аргумент
the event name
назва події
Third argument
Третій аргумент
the parameters for the event, usually the file name of the current document or the path to the project file.
параметри події, зазвичай, назва файла поточного документа або шлях до файла проекту.
Aside of the above methods the script can receive input from & quantaplus; on the standard input. In the Input combobox you can select what to send to the standard input. Choices are:
Окрім вже згаданих методів, скрипт може отримувати вхідні дані від & quantaplus; на стандартному вхідному каналі даних. За допомогою спадного списку Вхід ви можете визначити, що саме слід надсилати на стандартний вхід. Можливі варіанти:
None: nothing is sent to the script.
Немає: скрипту нічого не буде передано.
Current document: the whole document is sent to the script.
Поточний документ: документу буде передано цілий скрипт.
Selected text: the selected area of the document is sent to the script. Using the %input variable usually makes sense only when using this setting.
Вибраний текст: скриптові буде надіслано позначений фрагмент тексту документа. Використання змінної% input, зазвичай, є доцільним, лише якщо використовується цей варіант.
Similar to the Input you can catch the output of the executed application. There are two kind of outputs: normal output, printed to the standard output; error messages, printed to the standard error. You can specify what should happen with the text printed to the standard output. This can be done by modifying the value of the Output combobox:
Подібно до Вводу, ви можете перехоплювати і дані, виведені програмою, яку буде виконано. Існує два типи виведених даних: звичайний вивід, який надсилається до стандартного виводу; повідомлення про помилки, які надсилаються до стандартного виводу помилок. Ви можете вказати спосіб обробки тексту, надісланого до стандартного виводу. Зробити це можна зміною значення у спадному списку Вивід:
None: the output of the application is ignored.
Немає: вивід програми буде проігноровано.
Insert in cursor position: the output will be inserted in the current document and the cursor position.
Вставити у позицію курсора: вивід буде вставлено до поточного документа у позицію курсора.
Replace selection: the selected area of the document will be replaced with the output.
Замінити вибране: виведеними даними буде замінено вибрану область документа.
Create a new document: a new document will be created and will contain all the output of the script.
Створити новий документ: буде створено новий документ, який міститиме всі дані, виведені скриптом.
Replace current document: the entire document will be replaced with the output.
Замінити поточний документ: виведені дані замінять собою весь документ.
Message window: the output will appear in the Messages toolview.
Вікно повідомлення: виведені дані з’ являться на панелі перегляду Повідомлення.
The choices for the standard error output (Error) are the same as for the normal output.
Варіанти для стандартного виводу помилок (Помилка) збігаються з варіантами звичайного виводу.
Creating Toolbars
Створення панелей інструментів
The following will show you how to create toolbars for a & DTEP;. Toolbars are graphical elements that are assigned to actions. Actions, in & quantaplus;, are the basis for nearly all the extensions that & quantaplus; has and will acquire in the future. The same mechanism that defines an action in & quantaplus; also enables auto-completion and tag dialogs. With actions, the limit of what you can do is virtually limitless. For means of an example, we will use HTML; tidy on our web pages.
Нижче наведено настанови щодо створення панелей інструментів для & DTEP;. Панелі інструментів є графічними елементами, які пов’ язано з діями. Дії у & quantaplus; є основою майже для всіх додаткових елементів, які вже передбачено у & quantaplus; і які буде створено у майбутньому. Механізм, подібний до визначення дії у & quantaplus;, також уможливлює автоматичне завершення і діалогові вікна теґів. За допомогою дій ви можете майже безмежно розширювати область операцій. У нашому прикладі ми використаємо HTML; tidy для наших веб- сторінок.
From Scratch to Complete
З нічого до завершеної панелі
To begin, you will need to create a user toolbar. Select Toolbars Add User Toolbar.
Для початку вам слід створити панель інструментів користувача. Скористайтеся для цього пунктом меню Пенали Додати пенал користувача....
If there are many tags for the markup language, it is recommended that you split up the tags into logical groups. You will need to create a new user toolbar for each group. In this case, there are not many, so we will be making one toolbar and naming it with the name of the markup.
Якщо у мові розмітки забагато теґів, ці теґи варто розбити на логічні групи. Вам слід буде створити нову панель інструментів користувача для кожної з груп. Якщо ви так зробите, кількість груп буде меншою за кількість дій і ви зможете створити одну панель інструментів з назвою відповідної розмітки.
Once all your toolbars are created, you must add and configure the actions. To do this, select Settings Configure Actions.
Після створення всіх ваших панелей інструментів вам слід додати і налаштувати дії. Щоб зробити це, скористайтеся пунктом меню Параметри Налаштувати дії.
The parts of this window are pretty straight forward. Press the New action button at the bottom of the window to enter the editing mode.
Призначення елементів цього вікна є досить очевидним. Натисніть кнопку Створити дію, розташовану у нижній частині вікна, щоб перевести програму у режим редагування.
Fill in all of the necessary fields and add the tag to the appropriate toolbar(s).
Заповніть всі потрібні поля і додайте теґ до належних панелей інструментів.
Complete the rest and, if the tag has attributes and you always plan to use them, check the Run "Edit tag" dialog if available box so that you will be prompted every time the action is used.
Заповніть решту пунктів і, якщо для теґу передбачено атрибути, а ви маєте намір завжди використовувати саме ці атрибути, позначте пункт Відкрити діалогове вікно « Редагувати теґ », якщо таке передбачено, — програма відкриватиме вікно запиту кожного разу, коли ви користуватиметеся дією.
You should now have something much like the following.
У вас має вийти щось дуже схоже до такого.
Press the Apply button and you will see the action added to the toolbar(s) you have selected.
Натисніть кнопку Застосувати і ви побачите додану дію на обраній вами панелі інструментів.
Egad! That's an awful icon. How will yourself and others remember that icon goes with that action? Let's replace it before trouble arises.
Ой! Ця піктограма виглядає жахливо. Як же вам та іншим користувачам запам’ ятати піктограму, пов’ язану з дією? Давайте поміняємо піктограм, доки не виникли пов’ язані з цим проблеми.
To create an icon that more accurately describes that action, we will be using & kiconedit;. Select it from the & kmenu;, Graphics More Programs (or where ever your distribution placed it).
Щоб створити піктограму, яка точніше описуватиме відповідну дію, ми скористаємося програмою & kiconedit;. Оберіть її пункт з K- меню: Графіка Більше (або інше підменю, що відповідає програмі у вашому дистрибутиві).
& kiconedit; defaults to the size 32x32 pixels, but we need 22x22. To change this, select Edit Resize.
У & kiconedit; типовим розміром піктограм є 32x32 пікселів, але нам потрібна піктограма розмірів 22x22. Щоб змінити розмір, скористайтеся пунктом меню Правка Змінити розмір.
Keep in mind that you are creating an icon that will assist in helping not only yourself to remember which action does what, but also other users of the & DTEP;.
Пам’ ятайте, що ви створюєте піктограму, яка допоможе визначати дію не лише вам, але і іншим користувачам & DTEP;.
Since the tag I am creating the icon for is called start, I have decided to create a Start sign. Using the color green (green often interpreted as go, start, or proceed) will, or, at least, should, convey a message to the user that clicking this action will place the & lt; startgt; tag in the current document.
Через призначення теґу, який ми створюємо, піктограма називатиметься « пуск », отже нам варто створити « знак запуску ». За допомогою зеленого кольору (зелений часто позначає дію « можна », « розпочати » або « продовжити ») ми маємо повідомити користувачеві, що натискання кнопки дії додасть теґ & lt; startgt; у поточний документ.
Now that I am finished with the creation of the icon, I will save it.
Тепер, коли створення піктограми завершено, її слід зберегти.
Once you are done with creating the icon(s), you must associate the icon with the action. To do this, open Settings Configure Actions again (in & quantaplus;) and select the action you made the icon for. Beside the Text field, you will see a button, click it.
Після завершення створення піктограм вам слід пов’ язати їх з діями. Зробити це можна за допомогою пункту меню Параметри Налаштувати дії (у & quantaplus;). Оберіть дію, для якої було створено піктограму. Поряд з полем Текст буде показано кнопку, натисніть її.
Select Other Icons and then click the Browse button.
Оберіть пункт Інші піктограми, а потім натисніть кнопку Навігація.
Goto the folder in which you saved the icon, select the icon, and click OK.
Перейдіть до теки, у якій ви зберегли піктограму, і натисніть кнопку Гаразд.
Press the Apply button and either continue to do the same with the other tags, if any, or click OK to finish.
Натисніть кнопку Застосувати і або продовжіть роботу над іншими теґами, якщо такі є, або натисніть кнопку Гаразд, щоб завершити роботу.
Let us say you would like to add some common & quantaplus; functions to your toolbar or maybe you think the toolbar would be better off organized in a different manner with some separators to group the actions. Open the Configure Toolbars dialog by going Settings Configure Toolbars. Make sure your toolbar is selected.
Припустімо, вам потрібно додати до вашої панелі інструментів якісь типові дії & quantaplus;, або ви вважаєте, що панель краще впорядкувати інакше, з додаванням роздільників, за допомогою яких буде створено групи дій. Відкрийте діалогове вікно Налаштувати пенали за допомогою пункту меню Параметри Налаштувати пенали. Не забудьте обрати у цьому вікні потрібну вам панель.
I will be choosing the separator (top of the left column) for my toolbar. Once you have selected the item you wish to add to your toolbar, press the right arrow button. This will add it to your toolbar.
Ми оберемо роздільник (верхній пункт у лівому стовпчику) для нашої панелі інструментів. Після вибору елемента, який ви бажаєте додати на вашу панель інструментів, натисніть кнопку зі стрілочкою праворуч. Натискання цієї кнопки додасть її на вашу панель інструментів.
I think I would like a quick way to access the Konqueror Preview. I will select it and add it to the toolbar.
Думаю, вам сподобається швидкий спосіб доступу до Перегляду Konqueror. Ми позначимо цей пункт і додамо його до панелі інструментів.
Note how the separator helps in grouping. Someone new to my toolbar might have thought that the & konqueror; button was like or the opposite of the start button.
Зауважте, які роздільник допомагає у групуванні. Без нього на панелі інструментів кнопка & konqueror; виглядатиме як протилежність кнопки запуску.
Apply your changes and, when you are done, press OK to finish.
Застосуйте ваші зміни і, коли вони вас вдовольнять, натисніть кнопку Гаразд.
Ah, look at the fantastic new toolbar! Much more handy now.
О, подивіться на цю фантастичну нову панель інструментів! Тепер вона набагато зручніша.
Remember to test your toolbar, by clicking all the buttons, so that you know the output is correct.
Не забудьте перевірити вашу панель інструментів. Натисніть всі її кнопки, щоб переконатися у правильності виводу.
Now to save the toolbar, we will select Toolbars Save Toolbars Save as Local Toolbar.
Збережіть панель інструментів. Для цього скористайтеся пунктом меню Пенали Зберегти пенали Зберегти локальний пенал.
Save it to the correct folder. Since NeXML does not exist, I will just have it to the top-level folder, but your toolbar(s) should be saved to the correct folder. Make sure to adjust your & descriptionrc; to have it load your toolbar(s) when a new file of that type is created.
Панель слід зберегти до належної теки. Оскільки теки NeXML не існує, ми створимо її як теку верхнього рівня, але ваші панелі інструментів слід зберігати до відповідної теки. Змініть ваш файл & descriptionrc; так, щоб під час створення файла відповідного типу завантажувалася ваша панель інструментів.
Creating Your Own Documentation
Створення вашої власної документації
Probably the most notable additions to & quantaplus; for the general user will be the addition of documentation for the markup or scripting language that you like best. To that end, this chapter will explain how I create the & PHP; documentation tree for my personal use.
Ймовірно, найпомітнішими для типового користувача додатковими елементами & quantaplus; є додавання документації для мови розмітки і скриптової мови, яку ви вважаєте найкращою. Отже, у цій главі ми пояснимо спосіб створення ієрархії документації & PHP; для особистого користування.
Before starting on creating your own documentation, you may wish to check out the & quantaplus; repository to see if someone else has already done this set.
Перш ніж розпочати створення вашої власної документації, вам варто пошукати у сховищі & quantaplus;: можливо, там уже є результати чиєїсь роботи.
There are two parts to this process. First, you must obtain the existing documentation for the markup/ scripting/ etc; language that you prefer. Second, you have to create the docrc file. The first is up to you, the second is what we will cover here.
Ця процедура складається з двох кроків. По- перше, вам слід отримати існуючу документацію для мови розмітки/ скриптів/ тощо, яку ви згодом зміните. По- друге, вам слід створити файл docrc. Виконання першого кроку покладається на вас, другу ми обговоримо тут.
The general form of the docrc file is as follows:
Загальна форма файла docrc є такою:
#KDE Config File [Tree] Doc dir= path, relative to this file, of the documentation html files & eg; php42/ #top level elements Top Element= Your description for these documentation & eg; & PHP; 4.2 documentation Section 1=Section1. html Section 2=#Sec2.1, #Sec2.2, #Sec2.3 Sec2.1=Sec2.1. html Sec2.2=Sec2.2. html Sec2.3=Sec2.3. html... [Context] ContextList=func1, func2, tag1, tag2, tag3 func1=func1. html func2=func2. html tag1=tag1. html tag2=tag2. html tag3=tag3. html
# KDE Config File [Tree] Doc dir= шлях, відносно цього файла, до файлів документації html & eg; php42 / # top level elements Top Element= Ваш опис цієї документації, наприклад, & PHP; 4. 2 documentation Section 1=Section1. html Section 2=# Sec2. 1, # Sec2. 2, # Sec2. 3 Sec2. 1=Sec2. 1. html Sec2. 2=Sec2. 2. html Sec2. 3=Sec2. 3. html... [Context] ContextList=func1, func2, tag1, tag2, tag3 func1=func1. html func2=func2. html tag1=tag1. html tag2=tag2. html tag3=tag3. html
The docrc is broken down into two sections: Tree and Context.
docrc розбито на два розділи: Tree і Context.
The Tree section defines the presentation aspect of the documentation in the documentation tab. For example, you will see that in the & PHP; documentation you have something akin to this:
Розділ « Дерево » визначає параметри показу документації на вкладці документації. Наприклад, документація з & PHP;, виглядатиме десь так:
Relating this to the above, my & PHP; docrc looks like this:
Якщо пов’ язати сказане з наведеним вище прикладом, наш & PHP; docrc має виглядати десь так: