natgillin/translations-raw huggingface dataset:
Arguments in the command line are passed to the function as arg1, arg2, etc. In order to provide documentation for each command, simply implement the 'help' function as follows: function help(cmd) {if (cmd == "sort") {return "Sort the selected text.";} else if (cmd == "...") {/ /...}} Executing help sort in the command line then calls this help function with the argument cmd set to the given command, i. e. cmd == "sort". & kate; then presents the returned text as documentation to the user.
Параметри у командному рядку передаються функції як параметр1, параметр2 тощо. Щоб надати користувачам можливість ознайомлюватися з документацією щодо команди, просто реалізуйте функцію 'help' у такий спосіб: function help( cmd) {if (cmd == "sort") {return "Sort the selected text.";} else if (cmd == "...") {//...}} Після цього виконання команди help sort у командному рядку призведе до виклику відповідної функції довідки (help) з параметром cmd встановленим у назву вказаної команди, тобто, у нашому прикладі, cmd == "sort". У відповідь на команду & kate; покаже користувачеві визначений вами текст довідки.
Developing a command line script requires to reload the scripts to see whether the changes behave appropriately. Instead of restarting the application, simply switch to the command line and invoke the command reload-scripts.
Під час розробки скрипту командного рядка корисним буває перезавантаження скриптів для перевірки коректності поведінки під час встановлення відступів. Замість перезапуску програми достатньо просто перейти до командного рядка і виконати команду reload- scripts.
Scripting API
Інтерфейс (API) роботи зі скриптами
The scripting API presented here is available in all scripts, i. e. indentation scripts and command line commands. Before the contents of a script is loaded, & kate; first adds several prototypes and functions to the scripting context. This convenience API contains prototypes like text cursors and text ranges and is located in the folder $KDEDIR/ share/ apps/ katepart/ api. There, the file names of each JavaScript file conforms with the following naming scheme: & lt; numbergt; _lt; namegt;. js The number has two digits and the name is an arbitrary name such as myutils. Through the number & kate; controls the execution order of the API. I. e., the file called 05_cursor. js is called before the file 10_range. js. (This is similar to the start order of the runlevel/ init system in Linux).
Програмний інтерфейс роботи зі скриптами, про який ми тут говоритимемо, доступний у всіх скриптах, тобто у скриптах встановлення відступів та у скриптах командного рядка. Перед завантаженням вмісту скрипту & kate; додає декілька прототипів і функцій до контексту роботи зі скриптами. У цьому програмному інтерфейсі, доданому для зручності, містяться прототипи, зокрема текстові курсори та описи діапазонів тексту. Файли цього інтерфейсу зберігаються у теці $KDEDIR/ share/ apps/ katepart/ api. Для файлів у цій теці встановлено таку схему іменування: & lt; номерgt; _ lt; назваgt;. js Номер має складатися з двох цифр, а назва може бути довільною, наприклад, myutils. За допомогою номера & kate; встановлює послідовність виконання скриптів інтерфейсів. Таким чином, файл з назвою 05_ cursor. js буде виконано до файла з назвою 10_ range. js. (Ця схема подібна до порядку запуску або ініціалізації скриптів під час запуску Linux).
To extend the standard scripting API with own functions and prototypes simply create a new file in the KDE's local configuration folder $KDEHOME/ share/ apps/ katepart/ api and make sure it has a greater number (execution order) than the other *. js files in the global folder $KDEDIR/ share/ apps/ katepart/ api. & kate; automatically searches in both folders for *. js files and executes them in the correct order.
Щоб розширити стандартний програмний інтерфейс (API) для роботи зі скриптами власними функціями і прототипами просто створіть файл у локальній теці файлів налаштування KDE, $KDEHOME/ share/ apps/ katepart/ api, і переконайтеся, що у назві файла вказано порядковий номер виконання, більший за будь- який інший номер файлів *. js у загальній теці $KDEDIR/ share/ apps/ katepart/ api. & kate; автоматично виконає пошук файлів *. js у обох теках і виконає їх у вказаному порядку.
To extend existing prototypes like Cursor or Range, the recommended way is to not modify the global *. js files. Instead, create a *. js file in the local folder that is being executed later than the 05_cursor. js and then change the Cursor prototype in JavaScript.
Рекомендованим способом розширення можливостей прототипів, зокрема Cursor або Range, не є внесення змін до загальних файлів *. js. Для цього вам краще створити файл *. js у локальній теці, файли з якої виконуватимуться після 05_ cursor. js, а потім внести зміни до прототипу Cursor у JavaScript.
Cursors and Ranges
Курсори і діапазони
As & kate; is a text editor, all the scripting API is based on cursors and ranges whenever possible. A Cursor is a simple (line, column) tuple representing a text position in the document. A Range spans text from a starting cursor position to an ending cursor position. The API is explained in detail in the next sections.
Оскільки & kate; є текстовим редактором, весь програмний інтерфейс (API) за можливості засновано на курсорах та діапазонах тексту. Об’ єкт Cursor (курсор) є простим кортежем (line, column) (рядок, стовпчик), що визначає позицію у тексті документа. Об’ єкт Range (діапазон) це фрагмент тексту від початкової позиції курсора до кінцевої позиції курсора. Докладніше про програмний інтерфейс (API) ми поговоримо у наступних розділах.
The Cursor Prototype
Прототип Cursor (курсор)
Constructor. Returns a Cursor at position (0, 0).
Конструктор. Повертає об’ єкт Cursor (курсор) у позиції (0, 0).
Example: var cursor = new Cursor();
Приклад: var cursor = new Cursor ();
Cursor( int line, int column);
Cursor (int рядок, int стовпчик);
Constructor. Returns a Cursor at position (line, column).
Конструктор. Повертає об’ єкт Cursor (курсор) у позиції (рядок, стовпчик).
Example: var cursor = new Cursor(3, 42);
Приклад: var cursor = new Cursor( 3, 42);
Cursor( Cursor other);
Cursor (Cursor інший);
Copy constructor. Returns a copy of the cursor other.
Конструктор копіювання. Повертає копію курсора інший.
Example: var copy = new Cursor(other);
Приклад: var copy = new Cursor( other);
Returns a clone of the cursor.
Повертає клон курсора.
Example: var clone = cursor. clone();
Приклад: var clone = cursor. clone ();
Check whether the cursor is valid. The cursor is invalid, if line and/ or column are set to -1.
Перевіряє, чи є курсор коректним. Курсор вважається некоректним, якщо значення його позицій у рядку і/ або стовпчику дорівнюють - 1.
Example: var valid = cursor. isValid();
Приклад: var valid = cursor. isValid ();
Returns an new invalid cursor located at (-1, -1).
Повертає новий некоректний курсор, розташований у позиції (- 1, - 1).
Example: var invalidCursor = cursor. invalid();
Приклад: var invalidCursor = cursor. invalid ();
int Cursor. compareTo( Cursor other);
int Cursor. compareTo (Cursor інший);
Compares this cursor to the cursor other. Returns
Порівнює поточний курсор з курсором інший. Повертає
-1, if this cursor is located before the cursor other,
- 1, якщо поточний курсор розташовано перед курсором інший,
0, if both cursors equal and
0, якщо курсори у однакових позиціях і
+1, if this cursor is located after the cursor other.
+1, якщо поточний курсор розташовано після курсора інший.
bool Cursor. equals( Cursor other);
bool Cursor. equals (Cursor інший);
Returns true, if this cursor and the cursor other are equal, otherwise false.
Повертає true, якщо цей курсор і курсор інший є однаковими. Якщо це не так, повертає false.
Returns the cursor as a string of the form Cursor(line, column).
Повертає об’ єкт курсора як рядок у формі Cursor( line, column).
The Range Prototype
Прототип Range (діапазон)
Constructor. Calling new Range() returns a Range at (0, 0) - (0, 0).
Конструктор. Виклик new Range () повертає Range (діапазон) у (0, 0) - (0, 0).
Range( Cursor start, Cursor end);
Range (Cursor початок, Cursor кінець);
Constructor. Calling new Range( start, end) returns the Range (start, end).
Конструктор. Виклик функції new Range (початок, кінець) повертає Range (діапазон) (початок, кінець).
Range( int startLine, int startColumn, int endLine, int endColumn);
Range (int початковийРядок, int початковийСтовпчик, int кінцевийРядок, int кінцевийСтовпчик);
Constructor. Calling new Range( startLine, startColumn, endLine, endColumn) Returns the Range from (startLine, startColumn) to (endLine, endColumn).
Конструктор. Виклик функції new Range (початковийРядок, початковийСтовпчик, кінцевийРядок, кінцевийСтовпчик). Повертає Range (діапазон) від позиції (початковийРядок, початковийСтовпчик) до позиції (кінцевийРядок, кінцевийСтовпчик).
Range( Range other);
Range (Range інший);
Copy constructor. Returns a copy of Range other.
Конструктор копіювання. Повертає копію Range інший.
Returns a clone of the range.
Повертає клон діапазону.
Example: var clone = range. clone();
Приклад: var clone = range. clone ();
Returns true, if both start and end cursor are valid, otherwise false.
Повертає true, якщо початкова і кінцева позиції курсора є коректними. Якщо це не так, повертає false.
Example: var valid = range. isValid();
Приклад: var valid = range. isValid ();
Returns the Range from (-1, -1) to (-1, -1).
Повертає Range (діапазон) від (- 1, - 1) до (- 1, - 1).
bool Range. contains( Cursor cursor);
bool Range. contains (Cursor курсор);
Returns true, if this range contains the cursor position, otherwise false.
Повертає true, якщо позиція курсора міститься у діапазоні, у іншому випадку повертає false.
bool Range. contains( Range other);
bool Range. contains (Range інший);
Returns true, if this range contains the Range other, otherwise false.
Повертає true, якщо поточний діапазон містить діапазон інший. Якщо це не так, повертає false.
bool Range. containsColumn( int column);
bool Range. containsColumn (int стовпчик);
Returns true, if column is in the half open interval [start. column, end. column), otherwise false.
Повертає true, якщо стовпчик належить напіввідкритому інтервалу [start. column, end. column). Якщо це не так, повертає false.
bool Range. containsLine( int line);
bool Range. containsLine (int рядок);
Returns true, if line is in the half open interval [start. line, end. line), otherwise false.
Повертає true, якщо рядок належить до напіввідкритого інтервалу [start. line, end. line). Якщо це не так, повертає false.
bool Range. overlaps( Range other);
bool Range. overlaps (Range інший);
Returns true, if this range and the range other share a common region, otherwise false.
Повертає true, якщо поточний діапазон і діапазон інший мають ненульовий перетин. Якщо це не так, повертає false.
bool Range. overlapsLine( int line);
bool Range. overlapsLine (int рядок);
Returns true, if line is in the interval [start. line, end. line], otherwise false.
Повертає true, якщо рядок належить до інтервалу [start. line, end. line]. Якщо це не так, повертає false.
bool Range. overlapsColumn( int column);
bool Range. overlapsColumn (int стовпчик);
Returns true, if column is in the interval [start. column, end. column], otherwise false.
Повертає true, якщо стовпчик належить інтервалу [start. column, end. column]. Якщо це не так, повертає false.
bool Range. equals( Range other);
bool Range. equals (Range інший);
Returns true, if this range and the Range other are equal, otherwise false.
Повертає true, якщо поточний діапазон і діапазон діапазон інший тотожні. Якщо це не так, повертає false.
Returns the range as a string of the form Range(Cursor(line, column), Cursor(line, column)).
Повертає діапазон у форматі Range( Cursor( line, column), Cursor( line, column)).
Global Functions
Загальні функції
void debug( String text);
void debug (String текст);
Prints text to stdout in the console launching the application.
Виводить текст до stdout у консоль, з якої запущено програму.
The View API
Програмний інтерфейс View
Whenever a script is being executed, there is a global variable view representing the current active editor view. The following is a list of all available View functions.
Яким би чином не було запущено скрипт, він завжди користуватиметься загальною змінною view, що відповідає поточній активній панелі перегляду. Нижче наведено список всіх типових функцій об’ єкта View.
Returns the current cursor position in the view.
Повертає поточну позицію курсора у області перегляду.
void view. setCursorPosition( int line, int column) void view. setCursorPosition( Cursor cursor)
void view. setCursorPosition (int рядок, int стовпчик) void view. setCursorPosition (Cursor курсор)
void view. setCursorPosition( int line, int column); void view. setCursorPosition( Cursor cursor);
void view. setCursorPosition (int рядок, int стовпчик); void view. setCursorPosition (Cursor курсор);
Set the current cursor position to either (line, column) or to the given cursor.
Встановлює для поточного курсора позицію, вказану напряму (рядок, стовпчик), або позицію вказаного курсора.
Returns the virtual cursor position with each tab counting the corresponding amount of spaces depending on the current tab width.
Повертає позицію віртуального курсора. Всі символи табуляцій буде враховано за допомогою відповідної кількості пробілів, яка залежатиме від поточної ширини табуляції.
void view. setVirtualCursorPosition( int line, int column); void view. setVirtualCursorPosition( Cursor cursor);
void view. setVirtualCursorPosition (int рядок, int стовпчик); void view. setVirtualCursorPosition (Cursor курсор);
Set the current virtual cursor position to (line, column) or to the given cursor.
Встановлює для віртуального курсора позицію, вказану напряму (рядок, стовпчик), або позицію вказаного курсора.
Returns the selected text. If no text is selected, the returned string is empty.
Повертає позначений фрагмент тексту. Якщо жодного фрагменту не позначено, повертає порожній рядок.
Returns true, if the view has selected text, otherwise false.
Повертає true, якщо у області перегляду позначено фрагмент тексту, інакше повертає false.
Returns the selected text range. The returned range is invalid if there is no selected text.
Повертає діапазон позначеного фрагменту тексту. Якщо жодного фрагменту не позначено, буде повернуто некоректний діапазон.
void view. setSelection( Range range);
void view. setSelection (Range діапазон);
Set the selected text to the given range.
Встановлює позначення тексту за вказаним діапазоном.
Remove the selected text. If the view does not have any selected text, this does nothing.
Вилучає позначений текст. Якщо у області перегляду не було позначено жодного тексту, ніяких дій виконано не буде.
Selects the entire text in the document.
Позначає весь текст у документі.
Clears the text selection without removing the text.
Знімає позначення фрагменту тексту, не вилучаючи сам текст.
The Document API
Програмний інтерфейс (API) Document
Whenever a script is being executed, there is a global variable document representing the current active document. The following is a list of all available Document functions.
Яким би чином не було запущено скрипт, він завжди користуватиметься загальною змінною document, що відповідає поточній активній панелі перегляду. Нижче наведено список всіх типових функцій об’ єкта Document.
Returns the document's filename or an empty string for unsaved text buffers.
Повертає назву файла документа або порожній рядок для незбережених буферів з текстом.
Returns the document's full url or an empty string for unsaved text buffers.
Повертає адресу URL документа повністю або порожній рядок для незбережених буферів з текстом.
Returns the document's mime type or the mime type application/ octet-stream if no appropriate mime type could be found.
Повертає тип MIME документа або тип MIME application/ octet- stream, якщо відповідного типу MIME встановити не вдасться.
Returns the currently used encoding to save the file.
Повертає поточне кодування символів, яке буде використано для збереження даних файла.
Returns true, if the document has unsaved changes (modified), otherwise false.
Повертає true, якщо у документі є незбережені зміни, інакше повертає false.
Returns the entire content of the document in a single text string. Newlines are marked with the newline character\.
Повертає увесь вміст документа у формі єдиного рядка тексту. Розриви рядків буде позначено символом розриву рядка\.
String document. text( int fromLine, int fromColumn, int toLine, int toColumn); String document. text( Cursor from, Cursor to); String document. text( Range range);
String document. text (int зРядка, int зіСтовпчика, int доРядка, int доСтовпчика); String document. text (Cursor з, Cursor до); String document. text (Range діапазон);
Returns the text in the given range. It is recommended to use the cursor and range based version for better readability of the source code.
Повертає фрагмент тексту у вказаному діапазоні. Для того, щоб код було легше читати, ми рекомендуємо вам використовувати засновану на об’ єктах Cursor і Range версію функції.
String document. line( int line);
String document. line (int рядок);
Returns the given text line as string. The string is empty if the requested line is out of range.
Повертає рядок за його номером у тексті. Якщо вказаний номер не належатиме до діапазону номерів рядків документа, буде повернуто порожній рядок.
String document. wordAt( int line, int column); String document. wordAt( Cursor cursor);
String document. wordAt (int рядок, int стовпчик); String document. wordAt (Cursor курсор);
Returns the word at the given cursor position.
Повертає слово за вказаною позицією курсора.
String document. charAt( int line, int column); String document. charAt( Cursor cursor);
String document. charAt (int рядок, int стовпчик); String document. charAt (Cursor курсор);
Returns the character at the given cursor position.
Повертає символ за вказаною позицією курсора.
String document. firstChar( int line);
String document. firstChar (int рядок);
Returns the first character in the given line that is not a whitespace. The first character is at column 0. If the line is empty or only contains whitespace characters, the returned string is empty.
Повертає перший символ вказаного рядка рядок, який не є пробілом. Першим символом рядка вважається символ у стовпчику 0. Якщо рядок є порожнім або складається лише з пробілів, функція повертає порожній рядок.
String document. lastChar( int line);
String document. lastChar (int рядок);
Returns the last character in the given line that is not a whitespace. If the line is empty or only contains whitespace characters, the returned string is empty.
Повертає останній символ вказаного рядка рядок, який не є пробілом. Якщо рядок є порожнім або складається лише з пробілів, функція повертає порожній рядок.
bool document. isSpace( int line, int column); bool document. isSpace( Cursor cursor);
bool document. isSpace (int рядок, int стовпчик); bool document. isSpace (Cursor курсор);
Returns true, if the character at the given cursor position is a whitespace, otherwise false.
Повертає true, якщо символ у вказаній позиції курсора є пробілом. Якщо це не так, повертає false.
bool document. matchesAt( int line, int column, int line, String text); bool document. matchesAt( Cursor cursor, String text);
bool document. matchesAt (int рядок, int стовпчик, int рядок, String текст); bool document. matchesAt (Cursor курсор, String текст);
Returns true, if the given text matches at the corresponding cursor position, otherwise false.
Повертає true, якщо вказаний текст розташовано за відповідною позицією курсора. Якщо це не так, повертає false.
bool document. startsWith( int line, String text, bool skipWhiteSpaces);
bool document. startsWith (int рядок, String текст, bool пропускатиПробіли);
Returns true, if the line starts with text, otherwise false. The argument skipWhiteSpaces controls whether leading whitespaces are ignored.
Повертає true, якщо рядок з вказаним номером починається з фрагмента тексту текст. Якщо це не так, повертає false. За допомогою параметра пропускатиПробіли можна вказати програмі, чи слід ігнорувати пробіли.
bool document. endsWith( int line, String text, bool skipWhiteSpaces);
bool document. endsWith (int рядок, String текст, bool пропускатиПробіли);
Returns true, if the line ends with text, otherwise false. The argument skipWhiteSpaces controls whether trailing whitespaces are ignored.
Повертає true, якщо рядок з вказаним номером завершується фрагментом тексту текст. Якщо це не так, повертає false. За допомогою параметра пропускатиПробіли можна вказати програмі, чи слід ігнорувати пробіли.
bool document. setText( String text);
bool document. setText (String текст);
Sets the entire document text.
Замінює весь вміст документа на текст.
Removes the entire text in the document.
Вилучає з документа весь текст.
bool document. truncate( int line, int column); bool document. truncate( Cursor cursor);
bool document. truncate (int рядок, int стовпчик); bool document. truncate (Cursor курсор);
Truncate the given line at the given column or cursor position. Returns true on success, or false if the given line is not part of the document range.
Обрізає рядок з вказаним номером на вказаному стовпчику або позиції курсора. Повертає true у разі успіху або false, якщо рядка з вказаним номером у документі немає.
bool document. insertText( int line, int column, int line, String text); bool document. insertText( Cursor cursor, String text);
bool document. insertText (int рядок, int стовпчик, int рядок, String текст); bool document. insertText (Cursor курсор, String текст);
Inserts the text at the given cursor position. Returns true on success, or false, if the document is in read-only mode.
Вставляє фрагмент тексту текст у вказану позицію курсора. Повертає true у разі успіху або false, якщо документ відкрито у режимі лише для читання.
bool document. removeText( int fromLine, int fromColumn, int toLine, int toColumn); bool document. removeText( Cursor from, Cursor to); bool document. removeText( Range range);
bool document. removeText (int зРядка, int зіСтовпчика, int доРядка, int доСтовпчика); bool document. removeText (Cursor з, Cursor до); bool document. removeText (Range діапазон);
Removes the text in the given range. Returns true on success, or false, if the document is in read-only mode.
Вилучає текст у вказаному діапазоні. Повертає true у разі успіху або false, якщо документ відкрито у режимі лише для читання.
bool document. insertLine( int line, String text);
bool document. insertLine (int рядок, String текст);
Inserts text in the given line. Returns true on success, or false, if the document is in read-only mode or the line is not in the document range.
Вставляє вказаний фрагмент тексту до рядка з вказаним номером. Повертає true у разі успіху або false, якщо документ відкрито у режимі лише для читання або рядка з вказаним номером у документі немає.
bool document. removeLine( int line);
bool document. removeLine (int рядок);
Removes the given text line. Returns true on success, or false, if the document is in read-only mode or the line is not in the document range.
Вилучає рядок з вказаним номером. Повертає true у разі успіху або false, якщо документ відкрито у режимі лише для читання або рядка з вказаним номером у документі немає.
void document. joinLines( int startLine, int endLine);
void document. joinLines (int початковийРядок, int кінцевийРядок);
Joins the lines from startLine to endLine. Two succeeding text lines are always separated with a single space.
Об’ єднує рядки у діапазоні від початковийРядок до кінцевийРядок. Послідовні рядки тексту завжди відокремлюються одинарним пробілом.
Returns the amount of lines in the document.
Повертає кількість рядків у документі.
Returns the number of characters in the document.
Повертає кількість символів у документі.
int document. lineLength( int line);
int document. lineLength (int рядок);
Returns the line's length.
Повертає довжину рядка з номером рядок.