natgillin/translations-raw huggingface dataset:
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.
Käsureaskripti arendamiseks tuleb skriptid taaslaadida, et näha, kas muudatused, mida nad teevad, on korrektsed. Terve rakenduse taaskäivitamise asemel lülitu lihtsalt käsureale ja anna käsk reload- scripts.
Scripting API
Skriptimise 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).
Allpool esitatud skriptimise API kehtib kõigi skriptide, s. t nii taande - kui ka käsureakäskude skriptide kohta. Enne skripti sisu laadimist lisab & kate; kõigepealt skriptimiskontekstile mõned prototüübid ja funktsioonid. Seepärast sisaldabki API prototüüpe tekstikursorite ja tekstivahemike kujul ning neid võib leida kataloogis $KDEDIR/ share/ apps/ katepart/ api. Kõigi JavaScripti failide nimed vastavad järgmisele skeemile: & lt; arvgt; _ lt; nimigt;. js Arvul on kaks kohta, nimi aga on suvaline nimi, näiteks myutils. Arvude abil kontrollib & kate; API täitmise järjekorda. Nii kutsutakse fail 05_ cursor. js välja enne faili 10_ range. js. (Samasugune käivitamise järjekord kehtib näiteks Linuxis käitustasemete puhul.)
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.
Standardse skriptimise API laiendamiseks oma funktsioonide ja prototüüpidega loo lihtsalt uus fail KDE kohalikus seadistuste kataloogis $KDEHOME/ share/ apps/ katepart/ api ja kanna hoolt, et selle arv (täitmise järjekord) oleks suurem kui teistel *. js - failidel globaalses kataloogis $KDEDIR/ share/ apps/ katepart/ api. & kate; otsib automaatselt mõlemast kataloogis *. js - faile ja käivitab need õiges järjekorras.
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.
Olemasolevate prototüüpide, näiteks Cursor või Range, laiendamiseks ei ole soovitatav muuta globaalseid *. js - faile. Selle asemel loo *. js - fail kohalikus kataloogis, mis käivitatakse hiljem kui 05_ cursor. js ja seejärel muuda prototüüpi Cursor JavaScriptis.
Cursors and Ranges
Kursorid ja vahemikud
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.
Kuna & kate; on tekstiredaktor, siis on kogu skriptimise API aluseks, nii palju kui võimalik, kursorid ja vahemikud. Kursor kujutab endast lihtsat (rida, veerg) määratlust, mis näitab ära teksti asukoha dokumendis. Vahemik aga paneb paika tekstivahemiku kursori algasukohast selle lõppasukohani. API seletatakse üksikasjalikult lahti järgmistes lõikudes.
The Cursor Prototype
Kursori prototüüp
Cursor();
Cursor ();
Constructor. Returns a Cursor at position (0, 0).
Konstruktor. Tagastab kursori asukohas (0, 0).
Example: var cursor = new Cursor();
Näide: var cursor = new Cursor ();
Cursor( int line, int column);
Cursor (int rida, int veerg);
Constructor. Returns a Cursor at position (line, column).
Konstruktor. Tagastab kursori asukohas (rida, veerg).
Example: var cursor = new Cursor(3, 42);
Näide: var cursor = new Cursor( 3, 42);
Cursor( Cursor other);
Cursor (Cursor other);
Copy constructor. Returns a copy of the cursor other.
Koopia konstruktor. Tagastab kursori koopia other.
Example: var copy = new Cursor(other);
Näide: var copy = new Cursor( other);
Cursor Cursor. clone();
Cursor Cursor. clone ();
Returns a clone of the cursor.
Tagastab kursori klooni.
Example: var clone = cursor. clone();
Näide: var clone = cursor. clone ();
bool Cursor. isValid();
bool Cursor. isValid ();
Check whether the cursor is valid. The cursor is invalid, if line and/ or column are set to -1.
Kontrollib, kas kursor on korrektne. Kursor ei ole korrektne, kui rida ja/ või veeru väärtuseks on määratud - 1.
Example: var valid = cursor. isValid();
Näide: var valid = cursor. isValid ();
Cursor Cursor. invalid();
Cursor Cursor. invalid ();
Returns an new invalid cursor located at (-1, -1).
Tagastab uue ebakorrektse kursori asukohas (- 1, - 1).
Example: var invalidCursor = cursor. invalid();
Näide: var invalidCursor = cursor. invalid ();
int Cursor. compareTo( Cursor other);
int Cursor. compareTo (Cursor other);
Compares this cursor to the cursor other. Returns
Võrdleb antud kursorit kursoriga other. Tagastab
-1, if this cursor is located before the cursor other,
- 1, kui antud kursor paikneb enne kursorit other,
0, if both cursors equal and
0, kui mõlemad kursorid on võrdsed,
+1, if this cursor is located after the cursor other.
- +1, kui antud kursor paikneb pärast kursorit other.
bool Cursor. equals( Cursor other);
bool Cursor. equals (Cursor other);
Returns true, if this cursor and the cursor other are equal, otherwise false.
Tagastab true, kui antud kursor ja kursor other on võrdsed, vastasel juhul false.
String Cursor. toString();
String Cursor. toString ();
Returns the cursor as a string of the form Cursor(line, column).
Tagastab kursori stringina kujul Cursor( rida, veerg).
The Range Prototype
Vahemiku prototüüp
Range();
Range ();
Constructor. Calling new Range() returns a Range at (0, 0) - (0, 0).
Konstruktor new Range () väljakutsumine tagastab vahemiku (0, 0) - (0, 0).
Range( Cursor start, Cursor end);
Range (Cursor algus, Cursor lõpp);
Constructor. Calling new Range( start, end) returns the Range (start, end).
Konstruktor new Range (algus, lõpp) väljakutsumine tagastab vahemiku (algus, lõpp).
Range( int startLine, int startColumn, int endLine, int endColumn);
Range (int algusRida, int algusVeerg, int lõppRida, int lõppVeerg);
Constructor. Calling new Range( startLine, startColumn, endLine, endColumn) Returns the Range from (startLine, startColumn) to (endLine, endColumn).
Konstruktor. new Range (algusRida, algusVeerg, lõppRida, lõppVeerg) tagastab vahemiku alates (algusRida, algusVeerg) kuni (lõppRida, lõppVeerg).
Range( Range other);
Range (Range other);
Copy constructor. Returns a copy of Range other.
Koopia konstruktor. Tagastab vahemiku koopia other.
Range Range. clone();
Range Range. clone ();
Returns a clone of the range.
Tagastab vahemiku klooni.
Example: var clone = range. clone();
Näide: var clone = range. clone ();
bool Range. isValid();
bool Range. isValid ();
Returns true, if both start and end cursor are valid, otherwise false.
Tagastab true, kui nii algus - kui ka lõppkursor on korrektsed, vastasel juhul false.
Example: var valid = range. isValid();
Näide: var valid = range. isValid ();
bool Range. invalid();
bool Range. invalid ();
Returns the Range from (-1, -1) to (-1, -1).
Tagastab vahemiku alates (- 1, - 1) kuni (- 1, - 1).
bool Range. contains( Cursor cursor);
bool Range. contains (Cursor kursor);
Returns true, if this range contains the cursor position, otherwise false.
Tagastab true, kui antud vahemik sisaldab kursori asukohta, vastasel juhul false.
bool Range. contains( Range other);
bool Range. contains (Range other);
Returns true, if this range contains the Range other, otherwise false.
Tagastab true, kui antud vahemik sisaldab vahemikku other, vastasel juhul false.
bool Range. containsColumn( int column);
bool Range. containsColumn (int veerg);
Returns true, if column is in the half open interval [start. column, end. column), otherwise false.
Tagastab true, kui veerg paikneb vahemikus [start. column, end. column), vastasel juhul false.
bool Range. containsLine( int line);
bool Range. containsLine (int rida);
Returns true, if line is in the half open interval [start. line, end. line), otherwise false.
Tagastab true, kui rida paikneb vahemikus [start. line, end. line), vastasel juhul false.
bool Range. overlaps( Range other);
bool Range. overlaps (Range other);
Returns true, if this range and the range other share a common region, otherwise false.
Tagastab true, kui antud vahemikul ja vahemikul other on ühine piirkond, vastasel juhul false.
bool Range. overlapsLine( int line);
bool Range. overlapsLine (int rida);
Returns true, if line is in the interval [start. line, end. line], otherwise false.
Tagastab true, kui rida paikneb vahemikus [start. line, end. line], vastasel juhul false.
bool Range. overlapsColumn( int column);
bool Range. overlapsColumn (int veerg);
Returns true, if column is in the interval [start. column, end. column], otherwise false.
Tagastab true, kui veerg paikneb vahemikus [start. column, end. column], vastasel juhul false.
bool Range. equals( Range other);
bool Range. equals (Range other);
Returns true, if this range and the Range other are equal, otherwise false.
Tagastab true, kui antud vahemik ja vahemik other on võrdsed, vastasel juhul false.
String Range. toString();
String Range. toString ();
Returns the range as a string of the form Range(Cursor(line, column), Cursor(line, column)).
Tagastab vahemiku stringina kujul Range( Cursor( rida, veerg), Cursor( rida, veerg)).
Global Functions
Globaalsed funktsioonid
void debug( String text);
void debug (String tekst);
Prints text to stdout in the console launching the application.
Näitab tekst i standardväljundis stdout samas konsoolis, kus rakendus käivitati.
The View API
Vaate API
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.
Skripti käivitamisel on alati olemas globaalne muutuja view, mis tähistab aktiivset redaktorivaadet. Järgnevalt on loetletud saadaolevad vaatefunktsioonid.
Cursor view. cursorPosition()
Cursor view. cursorPosition ()
Returns the current cursor position in the view.
Tagastab aktiivse kursori asukoha vaates.
void view. setCursorPosition( int line, int column) void view. setCursorPosition( Cursor cursor)
void view. setCursorPosition (int rida, int veerg) void view. setCursorPosition (Cursor kursor)
void view. setCursorPosition( int line, int column); void view. setCursorPosition( Cursor cursor);
void view. setCursorPosition (int rida, int veerg); void view. setCursorPosition (Cursor kursor);
Set the current cursor position to either (line, column) or to the given cursor.
Määrab aktiivse kursori asukoha kas (rida, veerg) või määratud kursori järgi.
Cursor view. virtualCursorPosition();
Cursor view. virtualCursorPosition ();
Returns the virtual cursor position with each tab counting the corresponding amount of spaces depending on the current tab width.
Tagastab virtuaalse kursori asukoha tabeldusmärgis, arvestades tabeldusmärgile taande puhul määratud tühimärkide arvu.
void view. setVirtualCursorPosition( int line, int column); void view. setVirtualCursorPosition( Cursor cursor);
void view. setVirtualCursorPosition (int rida, int veerg); void view. setVirtualCursorPosition (Cursor kursor);
Set the current virtual cursor position to (line, column) or to the given cursor.
Määrab aktiivse virtuaalse kursori asukoha kas (rida, veerg) või määratud kursori järgi.
String view. selectedText();
String view. selectedText ();
Returns the selected text. If no text is selected, the returned string is empty.
Tagastab valitud teksti. Kui teksti pole valitud, on tagastatav string tühi.
bool view. hasSelection();
bool view. hasSelection ();
Returns true, if the view has selected text, otherwise false.
Tagastab true, kui vaade sisaldab valitud teksti, vastasel juhul false.
Range view. selection();
Range view. selection ();
Returns the selected text range. The returned range is invalid if there is no selected text.
Tagastab valitud teksti vahemiku. Tagastatud vahemik on vigane, kui teksti pole valitud.
void view. setSelection( Range range);
void view. setSelection (Range vahemik);
Set the selected text to the given range.
Määrab valitud teksti valitud vahemikku.
void view. removeSelectedText();
void view. removeSelectedText ();
Remove the selected text. If the view does not have any selected text, this does nothing.
Eemaldab valitud teksti. Kui vaates pole valitud teksti, ei tee midagi.
void view. selectAll();
void view. selectAll ();
Selects the entire text in the document.
Valib kogu dokumendi teksti.
void view. clearSelection();
void view. clearSelection ();
Clears the text selection without removing the text.
Puhastab tekstivaliku ilma teksti eemaldamata.
The Document API
Dokumendi API
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.
Skripti käivitamisel on alati olemas globaalne muutuja document, mis tähistab aktiivset dokumenti. Järgnevalt on loetletud saadaolevad dokumendifunktsioonid.
String document. fileName();
String document. fileName ();
Returns the document's filename or an empty string for unsaved text buffers.
Tagastab dokumendi failinime või tühja stringi salvestamata tekstipuhvri korral.
String document. url();
String document. url ();
Returns the document's full url or an empty string for unsaved text buffers.
Tagastab dokumendi täieliku URL- i või tühja stringi salvestamata tekstipuhvri korral.
String document. mimeType();
String document. mimeType ();
Returns the document's mime type or the mime type application/ octet-stream if no appropriate mime type could be found.
Tagastab dokumendi MIME tüübi või MIME tüübi application/ octet- stream, kui sobivat MIME tüüpi ei leita.
String document. encoding();
String document. encoding ();
Returns the currently used encoding to save the file.
Tagastab faili salvestamisel kasutatava kodeeringu.
bool document. isModified();
bool document. isModified ();
Returns true, if the document has unsaved changes (modified), otherwise false.
Tagastab true, kui dokument sisaldab salvestamata muudatusi, vastasel juhul false.
String document. text();
String document. text ();
Returns the entire content of the document in a single text string. Newlines are marked with the newline character\.
Tagastab kogu dokumendi sisu üheainsa tekstistringina. Reavahetusi tähistavad reavahetussümbolid\.
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 alatesReast, int alatesVeerust, int kuniReani, int kuniVeeruni); String document. text (Cursor alates, Cursor kuni); String document. text (Range vahemik);
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.
Tagastab teksti määratud vahemikust. Lähtekoodi parema loetavuse huvides on soovitatav kasutada kursorile ja vahemikule tuginevaid versioone.
String document. line( int line);
String document. line (int rida);
Returns the given text line as string. The string is empty if the requested line is out of range.
Tagastab valitud teksti stringina. String on tühi, kui soovitud rida jääb vahemikust välja.
String document. wordAt( int line, int column); String document. wordAt( Cursor cursor);
String document. wordAt (int rida, int veerg); String document. wordAt (Cursor kursor);
Returns the word at the given cursor position.
Tagastab sõna määratud kursori asukohas.
String document. charAt( int line, int column); String document. charAt( Cursor cursor);
String document. charAt (int rida, int veerg); String document. charAt (Cursor kursor);
Returns the character at the given cursor position.
Tagastab sümboli määratud kursori asukohas.
String document. firstChar( int line);
String document. firstChar (int rida);
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.
Tagastab määratud rea
String document. lastChar( int line);
String document. lastChar (int rida);
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.
Tagastab määratud rea esimese märgi, mis ei ole tühimärk. Kui rida on tühi või sisaldab ainult tühimärke, on tagastatud string tühi.
bool document. isSpace( int line, int column); bool document. isSpace( Cursor cursor);
bool document. isSpace (int rida, int veerg); bool document. isSpace (Cursor kursor);
Returns true, if the character at the given cursor position is a whitespace, otherwise false.
Tagastab true, kui määratud kursori asukohas paiknev märk on tühimärk, vastasel juhul false.
bool document. matchesAt( int line, int column, int line, String text); bool document. matchesAt( Cursor cursor, String text);
bool document. matchesAt (int rida, int veerg, int rida, String tekst); bool document. matchesAt (Cursor kursor, String tekst);
Returns true, if the given text matches at the corresponding cursor position, otherwise false.
Tagastab true, kui määratud tekst sobib tekstiga määratud kursori asukohas, vastasel juhul false.
bool document. startsWith( int line, String text, bool skipWhiteSpaces);
bool document. startsWith (int rida, String tekst, bool skipWhiteSpaces);
Returns true, if the line starts with text, otherwise false. The argument skipWhiteSpaces controls whether leading whitespaces are ignored.
Tagastab true, kui rida algab tekstiga, vastasel juhul false. Argument skipWhiteSpaces määrab, kas alustavaid tühimärke eiratakse või mitte.
bool document. endsWith( int line, String text, bool skipWhiteSpaces);
bool document. endsWith (int rida, String tekst, bool skipWhiteSpaces);
Returns true, if the line ends with text, otherwise false. The argument skipWhiteSpaces controls whether trailing whitespaces are ignored.
Tagastab true, kui rida lõpeb tekstiga, vastasel juhul false. Argument skipWhiteSpaces määrab, kas lõpetavaid tühimärke eiratakse või mitte.
bool document. setText( String text);
bool document. setText (String tekst);
Sets the entire document text.
Määrab kogu dokumendi teksti.
bool document. clear();
bool document. clear ();
Removes the entire text in the document.
Eemaldab kogu dokumendi teksti.
bool document. truncate( int line, int column); bool document. truncate( Cursor cursor);
bool document. truncate (int rida, int veerg); bool document. truncate (Cursor kursor);
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.
Kärbib määratud rea määratud veeruga või kursori asukohaga. Tagastab true õnnestumise korral või false, kui määratud rida ei kuulu dokumendi vahemikku.
bool document. insertText( int line, int column, int line, String text); bool document. insertText( Cursor cursor, String text);
bool document. insertText (int rida, int veerg, int rida, String tekst); bool document. insertText (Cursor kursor, String tekst);
Inserts the text at the given cursor position. Returns true on success, or false, if the document is in read-only mode.
Lisab teksti määratud kursori asukohta. Tagastab true õnnestumise korral või false, kui dokument on kirjutuskaitstud.
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 alatesReast, int alatesVeerust, int kuniReani, int kuniVeeruni); bool document. removeText (Cursor alates, Cursor kuni); bool document. removeText (Range vahemik);
Removes the text in the given range. Returns true on success, or false, if the document is in read-only mode.
Eemaldab teksti määratud vahemikus. Tagastab true õnnestumise korral või false, kui dokument on kirjutuskaitstud.
bool document. insertLine( int line, String text);
bool document. insertLine (int rida, String tekst);
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.
Lisab teksti määratud reale. Tagastab true õnnestumise korral või false, kui dokument on kirjutuskaitstud või rida ei paikne dokumendi vahemikus.
bool document. removeLine( int line);
bool document. removeLine (int rida);
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.
Eemaldab määratud tekstirea. Tagastab true õnnestumise korral või false, kui dokument on kirjutuskaitstud või rida ei paikne dokumendi vahemikus.
void document. joinLines( int startLine, int endLine);
void document. joinLines (int algusRida, int lõppRida);
Joins the lines from startLine to endLine. Two succeeding text lines are always separated with a single space.
Ühendab read alates algusRida to lõppRida. Kaht järjestikust tekstirida eraldab alati üks tühik.
int document. lines();
int document. lines ();
Returns the amount of lines in the document.
Tagastab dokumendi ridade arvu.
int document. length();
int document. length ();
Returns the number of characters in the document.
Tagastab dokumendi sümbolite arvu.
int document. lineLength( int line);
int document. lineLength (int rida);
Returns the line's length.
Tagastab rea pikkuse.
void document. editBegin();
void document. editBegin ();
Starts an edit group for undo/ redo grouping. Make sure to always call editEnd() as often as you call editBegin(). Calling editBegin() internally uses a reference counter, i. e., this call can be nested.
Alustab redigeerimisrühma tagasivõtmiste või uuestitegemiste rühmitamiseks. Kontrolli, et editEnd () oleks alati sama palju välja kutsutud kui editBegin (). editBegin () väljakutse kasutab seesmiselt referentsarvestit, s. t selle väljakutse korral on võimalik pesastamine.
void document. editEnd();
void document. editEnd ();
Ends an edit group. The last call of editEnd() (i. e. the one for the first call of editBegin()) finishes the edit step.
Lõpetab redigeerimisrühma. Viimane editEnd () väljakutse (s. t see, mis vastab esimesele editBegin () väljakutsele) lõpetab redigeerimisastme.
int document. firstColumn( int line);
int document. firstColumn (int rida);
Returns the first non-whitespace column in the given line. If there are only whitespaces in the line, the return value is -1.
Tagastab määratud rea esimese mittetühimärgiga veeru. Kui real on ainult tühimärgid, tagastatakse - 1.
int document. lastColumn( int line);
int document. lastColumn (int rida);
Returns the last non-whitespace column in the given line. If there are only whitespaces in the line, the return value is -1.
Tagastab määratud rea viimase mittetühimärgiga veeru. Kui real on ainult tühimärgid, tagastatakse - 1.
int document. prevNonSpaceColumn( int line, int column); int document. prevNonSpaceColumn( Cursor cursor);
int document. prevNonSpaceColumn (int rida, int veerg); int document. prevNonSpaceColumn (Cursor kursor);
Returns the column with a non-whitespace characters starting at the given cursor position and searching backwards.
Tagastab mittetühimärkidega veeru alates aktiivsest kursori asukohast tagasisuunas otsides.
int document. nextNonSpaceColumn( int line, int column); int document. nextNonSpaceColumn( Cursor cursor);
int document. nextNonSpaceColumn (int rida, int veerg); int document. nextNonSpaceColumn (Cursor kursor);