natgillin/translations-raw huggingface dataset:
All styles in a syntax definition use one of the default styles. A few syntax definitions use more styles that there are defaults, so if you use a format often, it may be worth launching the configuration dialogue to see if some concepts are using the same style. For example there is only one default style for strings, but as the perl programming language operates with two types of strings, you can enhance the highlighting by configuring those to be slightly different.
Під час створення всіх стилів визначення синтаксису використовують один з типових стилів. У деякій частині визначень синтаксису використовуються додаткові стилі, яких немає серед типових, отже, якщо ви часто працюєте з файлами у таких форматах, доцільно відкрити діалогове вікно налаштування, щоб подивитися, чи не використовуються для певних елементів однакові стилі. Наприклад, існує лише один типовий стиль для рядків, але, оскільки у мові програмування Perl існує два типи рядків, ви можете налаштувати підсвічування для кожного з цих типів трохи по- різному. Огляд всіх можливих типових стилів буде наведено далі.
This section is an overview of the Highlight Definition & XML; format. It will describe the main components and their meaning and usage, and go into detail with the detection rules.
Цей розділ присвячено огляду формату & XML; визначення підсвічування. За допомогою невеличкого прикладу у розділі описано основні компоненти, їх призначення і використання. Далі ми докладно розглянемо правила визначення підсвічування синтаксису.
The formal definition, aka the DTD is stored in the file language. dtd which should be installed on your system in the folder $KDEDIR / share/ apps/ kate/ syntax.
Формальне визначення або DTD зберігається у файлі з назвою language. dtd, який у вашій системі має бути встановлено до теки $KDEDIR / share/ apps/ katepart/ syntax.
Main components of & kate; Highlight Definitions
Головні розділи файлів визначення підсвічування & kate;
The String attribute defines the set of characters.
section визначає категорію.
The String attribute defines the set of characters.
kateversion визначає найостаннішу з підтримуваних версій & kate;.
The String attribute defines the set of characters.
casesensitive визначає, чи розрізнятимуться ключові слова за регістром символів, чи ні.
The String attribute defines the set of characters.
author повинен містити ім’ я і адресу електронної пошти автора.
The String attribute defines the set of characters.
hidden визначає, чи має бути показано назву підсвічування у меню & kate;.
A rule looks like this:
Отже, наступний рядок має виглядати десь так:
The Rules in Detail
Докладно про розділи
The String attribute defines the set of characters.
fallthroughContext визначає наступний контекст, якщо не буде знайдено відповідника до правил.
The String attribute defines the set of characters.
selColor визначає колір виділеного тексту.
Default Styles
Можливі типові стилі
The char attribute defines the character to match.
dsChar, використовується для символів.
The String attribute defines the set of characters.
dsString, використовується для рядків.
The char attribute defines the character to match.
dsOthers, використовується для « інших » значень.
Each rule can match zero or more characters at the beginning of the string they are asked to test. If the rule matches, the matching characters are assigned the style or attribute defined by the rule, and a rule may ask that the current context is switched.
Кожне з правил може відповідати нульовій або більшій кількості символів на початку рядка, у якому шукатиметься відповідник правила. Якщо такий відповідник буде знайдено, знайдені символи визначать стиль або attribute, вказані за допомогою правила, правило також може надіслати системі запит на зміну поточного контексту.
& lt; RuleName attribute=quot; (identifier)quot; context=quot; (identifier_BAR_order)quot; [rule specific attributes] / gt;
& lt; НазваПравила attribute=quot; (ідентифікатор) quot; context=quot; (ідентифікатор) quot; [специфічні для правила атрибути] / gt;
The attribute identifies the style to use for matched characters by name or index, and the context identifies the context to use from here.
Значення attribute визначає назву стилю, який буде використано для відповідних символів, а значення context визначає контекст, який слід використовувати, починаючи з цього місця.
An identifier, currently only its zero-based index in the contexts group.
Ідентифікатора, який є назвою іншого контексту.
Some rules can have child rules which are then evaluated if and only if the parent rule matched. The entire matched string will be given the attribute defined by the parent rule. A rule with child rules looks like this:
У деяких правил можуть бути дочірні правила, перевірка можливості використання яких виконуватиметься, лише якщо буде задіяно батьківське правило. Атрибути, визначені у батьківському правилі, буде застосовано до всього знайденого рядка. Правило з дочірніми правилами виглядає так:
Rule specific attributes varies and are described in the following list.
Специфічні для правила атрибути можуть бути різними, їх описано у наступних розділах.
& lt; HlCOct (common attributes) / gt;
Загальні атрибути
The attribute and context attributes are common to all rules.
attribute: атрибут, що вказує на визначені itemData.
& lt; DetectChar char=quot; (character)quot; (common attributes) / gt;
& lt; DetectChar char=quot; (символ) quot; (загальні атрибути) (dynamic) / gt;
& lt; Detect2Chars char=quot; (character)quot; char1=quot; (character)quot; (common attributes) / gt;
& lt; Detect2Chars char=quot; (символ) quot; char1=quot; (символ) quot; (загальні атрибути) (dynamic) / gt;
& lt; StringDetect String=quot; (string)quot; [insensitive=quot; TRUE_BAR_FALSE; quot;] (common attributes) / gt;
& lt; StringDetect String=quot; (рядок) quot; [insensitive=quot; true_BAR_falsequot;] (загальні атрибути) (dynamic) / gt;
The String attribute defines the string to match. The insensitive attribute defaults to FALSE and is fed to the string comparison function. If the value is TRUE insensitive comparing is used.
Атрибут String визначає рядок для порівняння. Типовим значенням атрибута insensitive є false, цей атрибут передається функції порівняння рядків. Якщо значенням атрибута буде true, порівняння відбуватиметься без врахування регістру.
& lt; RegExpr String=quot; (string)quot; [insensitive=quot; TRUE_BAR_FALSE; quot;] [minimal=quot; TRUE_BAR_FALSEquot;] (common attributes) / gt;
& lt; RegExpr String=quot; (рядок) quot; [insensitive=quot; true_BAR_falsequot;] [minimal=quot; true_BAR_falsequot;] (загальні атрибути) (dynamic) / gt;
insensitive defaults to FALSE and is fed to the regular expression engine.
Типовим значенням атрибута insensitive є false, цей атрибут передається рушію пошуку за формальним виразом.
minimal defaults to FALSE and is fed to the regular expression engine.
Типовим значенням атрибута minimal є false, цей атрибут буде передано рушієві пошуку за формальним виразом.
& lt; Int (common attributes) / gt;
& lt; Int (загальні атрибути) (dynamic) / gt;
This rule has no specific attributes. Child rules are typically used to detect combinations of L and U after the number, indicating the integer type in program code.
У цього правила немає специфічних атрибутів. Зазвичай, для виявлення символів, що стоять після числа і позначають тип цілого числа у коді програми, L і U, використовуються дочірні правила. Насправді, можна використовувати будь- які правила як дочірні, але у DTD передбачено використання лише правила StringDetect.
This rule has no specific attributes. Child rules are typically used to detect combinations of L and U after the number, indicating the integer type in program code.
У цього правила немає специфічних атрибутів. Можна використовувати правило AnyChar як дочірнє, це правило типово використовується для виявлення комбінацій, порівняйте з правилом Int.
& lt; HlCOct (common attributes) / gt;
& lt; HlCHex (загальні атрибути) / gt;
It matches letteral representations of invisible characters commonly used in program code, for example\ (newline) or \\t (TAB).
Перевірка на відповідність символам, які часто використовуються у коді програм, наприклад,\ (перехід на новий рядок) або\\ t (табуляція).
The following characters will match if they follow a backslash (\\): abefnrtvquot; '?. Additionally, escaped hexadecimal numbers like for example \\xff and escaped octal numbers, for example \\033 will match.
Пошук буде виконуватися за переліченими далі символами, якщо ці символи стоять одразу за зворотною навскісною рискою (\\): abefnrtvquot; '?\\. Крім того, відповідними вважатимуться шістнадцяткові числа, наприклад,\\ xff і екрановані вісімкові числа, наприклад,\\ 033.
Detect an escaped character.
Перевірка на відповідність символу C.
& lt; HlCOct (common attributes) / gt;
& lt; HlCChar (загальні атрибути) / gt;
char defines the character starting the range, char2 the character ending the range.
char визначає символ, який повинен починати діапазон символів, char1 — символ, який має завершувати діапазон.
Useful to detect for example small quoted strings and the like, but note that since the hl engine works on one line at a time, this will not find strings spanning over a line break.
Корисно для виявлення, наприклад, невеличких рядків у лапках, але зауважте, що, оскільки рушій підсвічування обробляє за раз лише один рядок, у такий спосіб неможливо знайти рядки у лапках, які розбито між декількома рядками документа.
The char attribute defines the character to match.
Атрибут context визначає контекст, який слід включити.
& lt; Int (common attributes) / gt;
& lt; DetectSpaces (загальні атрибути) / gt;
& lt; Int (common attributes) / gt;
& lt; DetectIdentifier (загальні атрибути) / gt;
The & kate; Main Window is a standard & kde; application window, with the addition of dockable subwindows, or tool windows. It has a Menubar with all the common menus, and some more, and a toolbar providing access to commonly used commands.
Головним вікном & kate; є стандартне вікно програми & kde; з додаванням бічних панелей, на яких розташовано переліки інструментів. У вікні ви знайдете всі типові пункти меню разом з деякими додатковими пунктами, а також панель інструментів, призначену для доступу до команд, якими користуються найчастіше.
The most important part of the window is the Editing Area, by default displaying a single text editor component, in which you can work with your documents.
Найголовнішою частиною вікна є область редагування. Типово, буде показано єдиний компонент текстового редактора, за допомогою якого ви зможете працювати над вашими документами.
The File Selector
Списку документів
The File List
Навігатора файлової системи
And possibly other tool windows, for example provided by plugins.
А також інших інструментів, наприклад, інструментів додатків до програми.
When splitting an editor into two frames, it is divided into two equally sized frames, both displaying the current document of that editor. The new frame will be at the bottom (in the case of a horizontal split) or at the right (for a vertical split). The new frame gets the focus, which is visualised by a small green led in the focused frame.
Якщо ви накажете програмі з розділити вікно редактора на два фрейми, буде створено два фрейми однакового розміру, у обох буде показано поточний документ редактора. Новий фрейм буде розташовано в нижній частині вікна (у випадку горизонтального розподілу) або у правій частині (у випадку вертикального розподілу). Фокус буде передано новому фрейму, це буде показано за допомогою блимання курсора у фреймі, який знаходиться у фокусі.
The File Selector
Список документів
The file list displays a list of all documents currently open in & kate;. Modified files will have a small floppy disk icon on their left to indicate that state.
На панелі списку документів ви побачите список всіх документів, які зараз відкрито у & kate;. Поруч з позначками файлів з незбереженими змінами буде показано невеличку піктограму дискети, яка позначатиме їх стан.
The default location in the & kate; window is at the bottom, below the editing area.
Типово, список документів у вікні & kate; розташовано у лівій частині області редагування.
The File List
Навігатор файлової системи
The File Selector is a folder viewer, allowing you to open files from a displayed folder in the current frame.
Навігатор файлової системи — це переглядач тек, за допомогою якого ви зможете відкривати файли з показаної у навігаторі теки у поточному фреймі.
From top down, the file selector consist of the following elements:
Перелічимо всі елементи навігатора файлової системи, починаючи згори:
A Folder View
Стислий вигляд
The built in Terminal Emulator is a copy of the & kde; & konsole; terminal application, for your convenience. It is available from the Settings Show Terminal Emulator menu item or by pressing the F7 key, and will get the focus whenever displayed. Additionally, if the Sync & konsole; with active document option is enabled, it will change into the directory of the current document if possible when it is displayed, or when the current document changes.
Вбудований емулятор термінала є копією термінала з програми & konsole;, його додано для зручності. Доступ до емулятора можна отримати за допомогою пункту меню Вікно Вікна інструментів Показати термінал, це вікно завжди отримуватиме фокус після увімкнення його показу. Крім того, якщо буде позначено пункт Автоматично синхронізувати термінал з поточним документом, поточний каталог у терміналі буде за можливості змінено на каталог поточного документа після показу або внесення змін у поточний документ.
You can configure the & konsole; using it 's & RMB; menu, for more information, see the & konsole; manual.
Ви можете налаштувати & konsole; за допомогою контекстного меню, яке можна викликати клацанням правою кнопкою миші. Докладніші відомості можна знайти у підручнику з & konsole;.
Ctrl; F Edit Find
Щоб знайти фрагмент тексту, відкрийте панель покрокового пошуку за допомогою комбінації клавіш Ctrl; F або пункту меню Правка Пошук....
Working with Plugins
Робота з додатками
With a normal search, you would start out searching for the first name, Henrik maybe followed by sa like this: Henrik sa, and while looking for matches, you would have to discard those not being the beginning of a paragraph, as well as those in which the word starting with the letters sa was not either says, said or so. And then of cause repeat all of that with the next name...
Якщо б ви виконували пошук у звичайний спосіб, ви мали б почати з пошуку імені, Іван, можливо у супроводі говори, десь так: Іван говори, серед відповідників вам слід би було відкинути ті, які стоять не на початку абзацу, а також ті, у яких літери говори не є літерами слів говорить, говорив тощо. Потім, звичайно ж, вам слід було б повторити пошук для прізвища...
To achieve this, Regular Expressions defines rules for expressing in details a generalisation of a string to match. Our example, which we might literally express like this: A line starting with either Henrik or Pernille (possibly following up to 4 blanks or tab characters) followed by a whitespace followed by sa and then either ys or id could be expressed with the following regular expression:
Щоб досягти цього, за допомогою формальних виразів визначаються правила, за допомогою яких створюється узагальнена форма рядка пошуку. У нашому прикладі це правило можна висловити буквально так: Рядок, який починається з Іван або Франко (перед цим словом може бути до 4 пробілів або символів табуляції), продовжується пробілом, за яким йде слово говори, яке закінчується на ть або в. Все це визначає формальний вираз:
Escaping of cause includes the backslash character it self, to literally match a such, you would write\\\\.
Екранування, звичайно ж, можна застосовувати і до самого символу зворотної навскісної риски, щоб програма сприймала введену вами зворотну навскісну риску як зворотну навскісну риску, вам слід ввести\\\\.
Because letters and digits have a logical order, you can abbreviate those by specifying ranges of them: [a-c] is equal to [abc] and [0-9] is equal to [0123456789]. Combining these constructs, for example [a-fynot1-38] is completely legal (the last one would match, of cause, either of a, b, c, d, e, f, y, n, o, t, 1, 2, 3 or 8).
Оскільки для літер і цифр характерний певний порядок (абетка або порядок цифр), ви можете скорочувати запис за допомогою діапазонів: [a- c] рівнозначний до [abc], а [0- 9] — до [0123456789]. Можна також використовувати комбінації таких конструкцій, наприклад, [a- fynot1- 38] (звичайно ж, остання комбінація відповідає одному з символів a, b, c, d, e, f, y, n, o, t, 1, 2, 3 або 8).
It is of cause possible to create a negative class matching as anything but To do so put a caret (^) at the beginning of the class:
Звичайно ж можна створити і негативний клас, до якого б входили всі літери окрім вказаних. Для запису такого класу вам слід скористатися символом каретки (^) на початку запису класу:
For example, it you want to find two occurrences of the same word separated by a comma and possibly some whitespace, you could write (\\w+), \\s*\\1. The sub pattern \\w+ would find a chunk of word characters, and the entire expression would match if those were followed by a comma, 0 or more whitespace and then an equal chunk of word characters. (The string \\1 references the first sub pattern enclosed in parentheses)
Наприклад, якщо вам потрібно знайти два однакових слова, відокремлені комою і, можливо, пробільними символами, ви можете скористатися формальним виразом (\\ w+),\\ s *\\ 1. За допомогою підшаблону\\ w+ буде знайдено послідовність символів слів, збіг з формальним виразом буде зареєстровано, якщо за цією послідовністю буде кома, 0 або більше пробільних символів і така сама послідовність символів слів. (Рядок\\ 1 відповідає першому підшаблону, взятому у круглі дужки)
When using quantifiers with no maximum, regular expressions defaults to match as much of the searched string as possible, commonly known as greedy behaviour.
За використання лічильників без зазначення максимальної кількості, типово, буде виконано пошук якомога більшої кількості відповідників формального виразу, така поведінка називається жадібною.
Modern regular expression software provides the means of turning off greediness, though in a graphical environment it is up to the interface to provide you with access to this feature. For example a search dialogue providing a regular expression search could have a check box labelled Minimal matching as well as it ought to indicate if greediness is the default behaviour.
У сучасних рушіях пошуку за формальними виразами передбачено можливість вимикання жадібності, забезпечення доступу до цієї можливості є проблемою лише графічного інтерфейсу. Наприклад, у діалоговому вікні пошуку за формальним виразом може бути поле для позначки з міткою Мінімальна кількість збігів, а також певним чином позначено, що жадібність є типовою поведінкою.
Some assertions actually does have a pattern to match, but the part of the string matching that will not be a part of the result of the match of the full expression.
У деяких умовних виразах можуть міститися шаблони, але за їх використання виконуватиметься лише перевірка на збіг рядка з вказаним шаблоном, — результат перевірки не буде включено до результатів пошуку.
That means that it will match for example within words: The expression \\Bin\\B will match at in window but not in integer or I 'm in love.
Такий вираз можна використовувати, наприклад, для пошуку внутрішніх частин слів: вираз\\ Bу\\ B буде знайдено у слові вухо, але не у слові увійшов або виразі Бачив у кіно.
The documentation for & kappname; was not finished when & kde; was installed on this computer.
Документацію для & kbugbuster; не було завершено до часу, коли на цьому комп’ ютері було встановлено & kde;.
& kcachegrind; is a profile data visualisation tool, written using the & kde; environment.
& kcachegrind; — це інструмент для візуалізації даних профілювання, створений з використанням середовища & kde;.
When developing a program, one of the last steps often involves performance optimisations. As it makes no sense to optimise functions rarely used, because that would be a waste of time, one needs to know in which part of a program most of the time is spent.
Під час розробки програми одним з останніх кроків часто є оптимізація швидкодії. Оскільки оптимізація функцій, які використовуються рідко не має великого сенсу, потрібно знати кількість процесорного часу, яку споживає кожна з частин програми.
For sequential code, collecting statistical data of the programs runtime characteristic like time numbers spent in functions and code lines usually is enough. This is called Profiling. The program is run under control of a profiling tool, which gives the summary of an execution run at the end. In contrast, for parallel code, performance problems typically are caused when one processor is waiting for data from another. As this waiting time usually can not easily attributed, here it is better to generate timestamped event traces. KCachegrind can not visualise this kind of data.
Для послідовного коду збирання статистичних даних щодо характеристик запущеної програми, зокрема час, витраченого на виконання функцій і рядків, зазвичай, достатньо. Збирання таких даних називається профілюванням. Програма запускається під керуванням інструменту профілювання, це надає резюме щодо виконання наприкінці. Навпаки, для розпаралеленого коду проблеми з швидкодією може бути спричинено очікуванням одного процесора на передавання даних від іншого процесора. Оскільки цей час очікування, зазвичай, важко пов’ язати з кодом, у такому випадку краще створити трасування подій з часовими позначками. & kcachegrind; не може створити візуальний відповідник цього типу даних.
After analysing the produced profile data, it should be easy to see the hot spots and bottlenecks of the code: for example, assumptions about call counts can be checked, and identified code regions can be optimised. Afterwards, the success of the optimisation should be verified with another profile run.
Після аналізу створених даних профілю ви маєте з легкістю виявити прогалини і вузькі місця у коді: наприклад, можна перевірити припущення щодо кількості викликів, виявлені діапазони коду може бути оптимізовано. Після цього ви можете перевірити результати оптимізації за допомогою повторного запуску профілювання.
To exactly measure the time passed or record the events happening during the execution of a code region (e. g. a function), additional measurement code needs to be inserted before and after the given region. This code reads the time, or a global event count, and calculates differences. Thus, the original code has to be changed before execution. This is called instrumentation. Instrumentation can be done by the programmer itself, the compiler, or by the runtime system. As interesting regions usually are nested, the overhead of measurement always influences the measurement itself. Thus, instrumentation should be done selectively and results have to be interpreted with care. Of course, this makes performance analysis by exact measurement a very complex process.
Щоб точно виміряти час на виконання або записати події, які сталися під час виконання певного діапазону коду (наприклад, функції), слід вставити додатковий код для вимірювання перед і після вказаного діапазону. Цей код зчитує час або загальну кількість подій, а потім обчислює різниці. Отже, перед виконанням початкового коду його слід змінити. Така зміна називається інструменталізацією. Інструменталізацію може виконати сам програміст, компілятор або система запуску. Оскільки цікаві діапазони коду зазвичай є вкладеними, накладання інструментів вимірювання завжди впливає на самі виміри. Таким чином, інструменталізацію слід виконувати вибірково, а результати слід сприймати з певною поправкою. Звичайно ж, це робити аналіз швидкодії точним виміром дуже складним процесом.