natgillin/translations-raw huggingface dataset:
& lt; ?xml version=quot; 1.0quot; encoding=quot; UTF-8quot; ?gt; & lt; !DOCTYPE language SYSTEM & quot; language. dtdquot; gt;
& lt;? xml version=quot; 1. 0quot; encoding=quot; UTF- 8quot;? gt; & lt;! DOCTYPE language SYSTEM & quot; language. dtdquot; gt;
The root of the definition file is the element language. Available attributes are:
Definitsioonifaili juureks on element language. Võimalikud atribuudid on järgmised:
Required attributes:
Nõutavad atribuudid:
name sets the name of the language. It appears in the menus and dialogs afterwards.
name määrab keele nime. Seda näeb ka menüüdes ja dialoogides.
section specifies the category.
section määrab kategooria.
extensions defines file extensions, like & quot; *. cpp; *. hquot;
extensions määrab faililaiendid, näiteks & quot; *. cpp; *. hquot;
Optional attributes:
Lisaatribuudid:
mimetype associates files & MIME; Type based.
mimetype seostab failid & MIME; tüübiga.
version specifies the current version of the definition file.
version määrab definitsioonifaili versiooni.
kateversion specifies the latest supported & kate; version.
kateversion määrab viimase toetatud & kate; versiooni.
casesensitive defines, whether the keywords are case sensitive or not.
casesensitive määrab, kas võtmesõnad on tõstutundlikud või mitte.
priority is necessary if another highlight definition file uses the same extensions. The higher priority will win.
priority on vajalik juhul, kui samu laiendeid kasutab mõni muu esiletõstu definitsiooni fail. Sel juhul saab eelistuse kõrgem prioriteet.
author contains the name of the author and his email-address.
author sisaldab autori nime ja tema e- posti aadressi.
license contains the license, usually LGPL, Artistic, GPL and others.
license sisaldab litsentsi (tavaliselt LGPL, Artistic, GPL vms.).
hidden defines, whether the name should appear in & kate; 's menus.
hidden määrab, kas nimi esineb & kate; menüüs või mitte.
So the next line may look like this:
Niisiis võib järgmine rida näha välja selline:
& lt; language name=quot; C++quot; version=quot; 1.00quot; kateversion=quot; 2.4quot; section=quot; Sourcesquot; extensions=quot; *. cpp; *. hquot; / gt;
& lt; language name=quot; C++quot; version=quot; 1. 00quot; kateversion=quot; 2. 4quot; section=quot; Sourcesquot; extensions=quot; *. cpp; *. hquot; / gt;
Next comes the highlighting element, which contains the optional element list and the required elements contexts and itemDatas.
Seejärel tuleb element highlighting, mis võib sisaldada endas elementi list ja kus peavad leiduma elemendid contexts ja itemDatas.
list elements contain a list of keywords. In this case the keywords are class and const. You can add as many lists as you need.
Element list sisaldab võtmesõnade nimekirja. Antud juhul on võtmesõnadeks class ja const. Nimekirju võib lisada nii palju, kui neid parajasti vaja läheb.
The contexts element contains all contexts. The first context is by default the start of the highlighting. There are two rules in the context Normal Text, which match the list of keywords with the name somename and a rule that detects a quote and switches the context to string. To learn more about rules read the next chapter.
Element contexts sisaldab kõiki kontekste. Esimene kontekst on vaikimisi esiletõstu alguses. Kontekstis Tavaline tekst on kaks reeglit, millest üks sobitab võtmesõnade nimekirja nimega minginimi ja teine tuvastab jutumärgid ning lülitub kontekstile string. Reeglitest räägib lähemalt järgmine peatükk.
The third part is the itemDatas element. It contains all color and font styles needed by the contexts and rules. In this example, the itemData Normal Text, String and Keyword are used.
Kolmas osa on element itemDatas. See sisaldab kõiki värvi - ja fondistiile, mida kontekstid ja reeglid vajavad. Antud näites on kasutusel itemData Tavaline tekst, String ja Võtmesõna.
& lt; highlightinggt; & lt; list name=quot; somenamequot; gt; & lt; itemgt; class & lt; /itemgt; & lt; itemgt; const & lt; /itemgt; & lt; /listgt; & lt; contextsgt; & lt; context attribute=quot; Normal Textquot; lineEndContext=quot; #popquot; name=quot; Normal Textquot; & gt; & lt; keyword attribute=quot; Keywordquot; context=quot; #stayquot; String=quot; somenamequot; / gt; & lt; DetectChar attribute=quot; Stringquot; context=quot; stringquot; char=quot; amp; quot; quot; / gt; & lt; /contextgt; & lt; context attribute=quot; Stringquot; lineEndContext=quot; #stayquot; name=quot; stringquot; & gt; & lt; DetectChar attribute=quot; Stringquot; context=quot; #popquot; char=quot; amp; quot; quot; / gt; & lt; /contextgt; & lt; /contextsgt; & lt; itemDatasgt; & lt; itemData name=quot; Normal Textquot; defStyleNum=quot; dsNormalquot; / gt; & lt; itemData name=quot; Keywordquot; defStyleNum=quot; dsKeywordquot; / gt; & lt; itemData name=quot; Stringquot; defStyleNum=quot; dsStringquot; / gt; & lt; /itemDatasgt; & lt; /highlightinggt;
& lt; highlightinggt; & lt; list name=quot; minginimiquot; gt; & lt; itemgt; class & lt; / itemgt; & lt; itemgt; const & lt; / itemgt; & lt; / listgt; & lt; contextsgt; & lt; context attribute=quot; Tavaline tekstquot; lineEndContext=quot; # popquot; name=quot; Tavaline tekstquot; & gt; & lt; keyword attribute=quot; Võtmesõnaquot; context=quot; # stayquot; String=quot; minginimiquot; / gt; & lt; DetectChar attribute=quot; Stringquot; context=quot; stringquot; char=quot; amp; quot; quot; / gt; & lt; / contextgt; & lt; context attribute=quot; Stringquot; lineEndContext=quot; # stayquot; name=quot; stringquot; & gt; & lt; DetectChar attribute=quot; Stringquot; context=quot; # popquot; char=quot; amp; quot; quot; / gt; & lt; / contextgt; & lt; / contextsgt; & lt; itemDatasgt; & lt; itemData name=quot; Tavaline tekstquot; defStyleNum=quot; dsNormalquot; / gt; & lt; itemData name=quot; Võtmesõnaquot; defStyleNum=quot; dsVõtmesõnaquot; / gt; & lt; itemData name=quot; Stringquot; defStyleNum=quot; dsStringquot; / gt; & lt; / itemDatasgt; & lt; / highlightinggt;
The last part of a highlight definition is the optional general section. It may contain information about keywords, code folding, comments and indentation.
Esiletõstu definitsiooni viimane osa on mittekohustuslik sektsioon general. See võib sisaldada infot võtmesõnade, koodi voltimise, kommentaaride ja treppimise kohta.
The comment section defines with what string a single line comment is introduced. You also can define a multiline comments using multiLine with the additional attribute end. This is used if the user presses the corresponding shortcut for comment/ uncomment.
Sektsioon comment määrab, millise stringiga algab üherealine kommentaar. Määrata võib ka mitmerealise kommentaari, kasutades atribuuti multiLine koos lisaatribuudiga end. Seda kasutatakse siis, kui kasutaja tarvitab kommentaari lisamise/ eemaldamise kiirklahvi.
The keywords section defines whether keyword lists are casesensitive or not. Other attributes will be explained later.
Sektsioon keywords määrab, kas võtmesõnade nimekirjad on tõstutundlikud või mitte. Teisi atribuute selgitame hiljem.
& lt; generalgt; & lt; commentsgt; & lt; comment name="singleLine "start="#"/ gt; & lt; /commentsgt; & lt; keywords casesensitive="1"/ gt; & lt; /generalgt; & lt; /languagegt;
& lt; generalgt; & lt; commentsgt; & lt; comment name=" singleLine "start=" # "/ gt; & lt; / commentsgt; & lt; keywords casesensitive=" 1" / gt; & lt; / generalgt; & lt; / languagegt;
The Sections in Detail
Sektsioonid üksikasjalikult
This part will describe all available attributes for contexts, itemDatas, keywords, comments, code folding and indentation.
Selles osas kirjeldame kõiki saadaolevaid konteksti, 'itemData', võtmesõnade, kommentaaride, koodi voltimise ja treppimise atribuute.
The element context belongs into the group contexts. A context itself defines context specific rules like what should happen if the highlight system reaches the end of a line. Available attributes are:
Element context kuulub gruppi contexts. Kontekst määrab kontekstispetsiifilised reeglid, näiteks selle, mis juhtub siis, kui esiletõstu süsteem jõuab oma tegevuses rea lõppu. Võimalikud atribuudid on järgmised:
name the context name. Rules will use this name to specify the context to switch to if the rule matches.
name määrab konteksti nime. Reeglid kasutavad seda määramaks konteksti, millele lülituda, kui reegel sobib.
lineEndContext defines the context the highlight system switches to if it reaches the end of a line. This may either be a name of another context, #stay to not switch the context (eg;. do nothing) or #pop which will cause to leave this context. It is possible to use for example #pop#pop#pop to pop three times.
lineEndContext määrab konteksti, millele esiletõstu süsteem lülitub rea lõppu jõudes. See võib olla mõne teise konteksti nimi, # stay, mis keelab konteksti vahetamise, või # pop, mis sunnib kontekstist loobuma. Võimalik on ka kasutada näiteks # pop# pop# pop, et kolm korda järjest kontekstist loobuda.
lineBeginContext defines the context if a begin of a line is encountered. Default: #stay.
lineBeginContext määrab konteksti, kui ette tuleb reaalgus. Vaikimisi # stay.
fallthrough defines if the highlight system switches to the context specified in fallthroughContext if no rule matches. Default: false.
fallthrough määrab, kas lülituda kontekstile, mille määrab fallthroughContext, kui ühtegi sobivat reeglit ei leita, või mitte. Vaikimisi väär (false).
fallthroughContext specifies the next context if no rule matches.
fallthroughContext määrab järgmise konteksti, kui ei leita ühtegi sobivat reeglit.
dynamic if true, the context remembers strings/ placeholders saved by dynamic rules. This is needed for HERE documents for example. Default: false.
dynamic: kui on tõene (true), jätab kontekst meelde dünaamiliste reeglite salvestatud stringid/ kohatäitjad. Seda on vaja näiteks HERE- dokumentide jaoks. Vaikimisi väär (false).
The element itemData is in the group itemDatas. It defines the font style and colors. So it is possible to define your own styles and colors, however we recommend to stick to the default styles if possible so that the user will always see the same colors used in different languages. Though, sometimes there is no other way and it is necessary to change color and font attributes. The attributes name and defStyleNum are required, the other optional. Available attributes are:
Element itemData kuulub gruppi itemDatas. See määrab fondistiili ja värvid. Nii saab määrata ka omaenda stiilid ja värvid, kuid soovitatav oleks võimaluse korral siiski kasutada vaikestiile, et kasutaja näeks alati ka erinevates keeltes ühesuguseid värve. Vahel on siiski mõttekas ja vajalik värvide ja fontide atribuute muuta. Nõutav on atribuudi nimi ja defStyleNum, ülejäänud pole kohustuslikud. Võimalikud atribuudid on järgmised:
name sets the name of the itemData. Contexts and rules will use this name in their attribute attribute to reference an itemData.
name määrab itemData nime. Kontekstid ja reeglid kasutavad seda nime oma atribuudis atribuut itemData' le viidates.
defStyleNum defines which default style to use. Available default styles are explained in detail later.
defStyleNum määrab kasutatava vaikestiili. Saadaolevaid vaikestiile tutvustame edaspidi.
color defines a color. Valid formats are '#rrggbb 'or '#rgb'.
color määrab värvi. Sobiv vorming on '# rrggbb' või '# rgb'.
selColor defines the selection color.
selColor määrab valiku värvi.
italic if true, the text will be italic.
italic: kui on tõene (true), on tekst kaldkirjas.
bold if true, the text will be bold.
bold: kui on tõene (true), on tekst rasvases kirjas.
underline if true, the text will be underlined.
underline: kui on tõene (true), on tekst allajoonitud.
strikeout if true, the text will be stroked out.
strikeout: kui on tõene (true), on tekst läbikriipsutatud.
The element keywords in the group general defines keyword properties. Available attributes are:
Element keywords grupis general määrab võtmesõna omadused. Võimalikud atribuudid on järgmised:
casesensitive may be true or false. If true, all keywords are matched casesensitive
casesensitive võib olla tõene (true) või väär (false). Kui see on tõene, on kõik võtmesõnad tõstutundlikud.
weakDeliminator is a list of characters that do not act as word delimiters. For example the dot '.' is a word delimiter. Assume a keyword in a list contains a dot, it will only match if you specify the dot as a weak delimiter.
weakDeliminator on märkide nimekiri, mida ei kasutata sõnaeraldajana. Näiteks punkt '.' on sõnaeraldaja. Eeldusel, et võtmesõna atribuudis list sisaldab punkti, leitakse sobivus ainult siis, kui määrad punkti nõrgaks eraldajaks.
additionalDeliminator defines additional delimiters.
additionalDeliminator määrab lisaeraldajad.
wordWrapDeliminator defines characters after which a line wrap may occur.
wordWrapDeliminator määrab märgid, mille järel võib rida murda.
Default delimiters and word wrap delimiters are the characters. ():! +, -lt; =gt; %amp; */;? []^{_BAR_}~\\, space ('') and tabulator ('\\t ').
Vaikimisi on eraldajateks ja sõnamurdmise eraldajateks märgid. ():! +, - lt; =gt;% amp; * /;? [] ^{ _BAR_} ~\\, tühikumärk ('') ja tabeldusmärk ('\\ t').
The element comment in the group comments defines comment properties which are used for Tools Comment and Tools Uncomment. Available attributes are:
Element comment grupis comments määrab kommentaari omadused, mida kasutatakse menüükäskude Tööriistad Kommentaar ja Tööriistad Kommentaari eemaldamine jaoks. Võimalikud atribuudid on järgmised:
name is either singleLine or multiLine. If you choose multiLine the attributes end and region are required.
name on kas singleLine või multiLine. Kui valida multiLine, on vajalikud ka atribuudid end ja region.
start defines the string used to start a comment. In C++ this would be & quot; /*quot;.
start määrab stringi, millega alustatakse kommentaari. C++ korral on see näiteks & quot; / * quot;.
end defines the string used to close a comment. In C++ this would be & quot; */ quot;.
end määrab stringi, millega lõpetatakse kommentaar. C++ korral on see näiteks & quot; * / quot;.
region should be the name of the foldable multiline comment. Assume you have beginRegion="Comment "... endRegion="Comment" in your rules, you should use region="Comment ". This way uncomment works even if you do not select all the text of the multiline comment. The cursor only must be in the multiline comment.
region on mitmerealise kokkuvolditava kommentaari nimi. Eeldusel, et su reeglites on beginRegion=" Comment "... endRegion=" Comment", tuleb kasutada region=" Comment ". Sel juhul toimib kommentaari eemaldamine ka siis, kui sa ei vali kogu mitmerealise kommentaari teksti - lihtsalt kursor peab asuma mitmerealise kommentaari sees.
The element folding in the group general defines code folding properties. Available attributes are:
Element folding grupis general määrab koodivoltimise omadused. Võimalikud atribuudid on järgmised:
indentationsensitive if true, the code folding markers will be added indentation based, like in the scripting language Python. Usually you do not need to set it, as it defaults to false.
indentationsensitive: kui see on tõene (true), lisatakse koodivoltimise markerid vastavalt treppimisele (näiteks skriptikeeles Python). Tavaliselt pole seda vaja ning vaikimisi ongi see väär (false).
The element indentation in the group general defines which indenter will be used, however we strongly recommend to omit this element, as the indenter usually will be set by either defining a File Type or by adding a mode line to the text file. If you specify an indenter though, you will force a specific indentation on the user, which he might not like at all. Available attributes are:
Element indentation grupis general määrab, millist treppimist kasutada. Soovitatav on siiski seda elementi vältida, sest treppimine määratakse tavaliselt kas failitüüpi defineerides või režiimirida tekstifailile lisades. Kui see siiski määrata, sunnitakse kasutajale peale konkreetne treppimine, mis aga ei pruugi alati kuigi hästi sobida. Võimalikud atribuudid on järgmised:
mode is the name of the indenter. Available indenters right now are: normal, cstyle, csands, xml, python and varindent.
mode on treppimise nimi. Praegu on saada järgmised treppimised: tavaline, cstyle, csands, xml, python ja varindent.
Available Default Styles
Saadaolevad vaikestiilid
Default Styles were already explained, as a short summary: Default styles are predefined font and color styles.
Vaikestiile me lühidalt juba tutvustasime: need on eelnevalt määratud fondi - ja värvistiilid.
So here only the list of available default styles:
Seepärast loetleme siin lihtsalt saadaolevad vaikestiilid:
dsNormal, used for normal text.
dsNormal tavalise teksti jaoks.
dsKeyword, used for keywords.
dsKeyword võtmesõnade jaoks.
dsDataType, used for data types.
dsDataType andmetüüpide jaoks.
dsDecVal, used for decimal values.
dsDecVal murdarvväärtuste jaoks.
dsBaseN, used for values with a base other than 10.
dsBaseN väärtuste jaoks, mille aluseks ei ole 10.
dsFloat, used for float values.
dsFloat ujukomaväärtuste jaoks.
dsChar, used for a character.
dsChar märkide jaoks.
dsString, used for strings.
dsString stringide jaoks.
dsComment, used for comments.
dsComment kommentaaride jaoks.
dsOthers, used for'other 'things.
dsOthers 'muude asjade' jaoks.
dsAlert, used for warning messages.
dsAlert hoiatuste jaoks.
dsFunction, used for function calls.
dsFunction funktsiooni väljakutsete jaoks.
dsRegionMarker, used for region markers.
dsRegionMarker regiooni markerite jaoks.
dsError, used for error highlighting and wrong syntax.
dsError vigade ja vigase süntaksi esiletõstmiseks.
Each rule can match zero or more characters at the beginning of the string they are test against. 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.
Iga reegel otsib sobivust null või enama märgi osas stringis, mida ta testib. Kui reegel leiab sobivuse, omistatakse sobivatele märkidele reeglis määratud stiil või atribuut ning reegel võib soovitada konteksti vahetamist.
& lt; RuleName attribute=quot; (identifier)quot; context=quot; (identifier)quot; [rule specific attributes] / gt;
& lt; ReegliNimi atribuut=quot; (identifikaator) quot; kontekst=quot; (identifikaator) quot; [reegli spetsiifilised atribuudid] / gt;
The attribute identifies the style to use for matched characters by name, and the context identifies the context to use from here.
Atribuut identifitseerib nime või indeksi järgi stiili, mida kasutada sobivate märkide puhul, ning kontekst identifitseerib vajaliku konteksti.
An identifier, which is the name of the other context.
identifikaatori järgi, mis on mingi teise konteksti nimi.
Some rules can have child rules which are then evaluated 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:
Mõnel reeglil võivad olla alamreeglid, mida kaalutakse siis ja ainult siis, kui põhireegel on sobivuse leidnud. Kogu sobivale stringile antakse põhireeglis määratud atribuut. Alamreegliga reegel näeb välja selline:
Rule specific attributes varies and are described in the following sections.
Reegli spetsiifilised atribuudid on mitmekesised ja neid kirjeldatakse järgnevates sektsioonides.
Common attributes
Üldatribuudid
All rules have the following attributes in common and are available whenever (common attributes) appears. attribute and context are required attributes, all others are optional.
Järgmised atribuudid on ühised kõigile reeglitele ja neid kasutatakse alati, kui esinevad (üldatribuudid). Nõutavad atribuudid on attribute ja context, teised pole kohustuslikud.
attribute: An attribute maps to a defined itemData.
attribute: atribuut on seotud määratud itemData 'ga.
context: Specify the context to which the highlighting system switches if the rule matches.
context: määrab konteksti, millele esiletõstu süsteem lülitub, kui reegel sobib.
beginRegion: Start a code folding block. Default: unset.
beginRegion: alustab koodivoltimise plokki. Vaikimisi määramata (unset).
endRegion: Close a code folding block. Default: unset.
endRegion: lõpetab koodivoltimise ploki. Vaikimisi määramata (unset).
lookAhead: If true, the highlighting system will not process the matches length. Default: false.
lookAhead: kui on tõene (true), ei arvesta esiletõstu süsteem sobivuse pikkus. Vaikimisi väär (false).
firstNonSpace: Match only, if the string is the first non-whitespace in the line. Default: false.
firstNonSpace: sobib ainult juhul, kui string on esimene mittetühimärk real. Vaikimisi väär (false).
column: Match only, if the column matches. Default: unset.
column: sobib ainult siis, kui veerg sobib. Vaikimisi määramata (unset).
Dynamic rules
Dünaamilised reeglid
Some rules allow the optional attribute dynamic of type boolean that defaults to false. If dynamic is true, a rule can use placeholders representing the text matched by a regular expression rule that switched to the current context in its string or char attributes. In a string, the placeholder %N (where N is a number) will be replaced with the corresponding capture N from the calling regular expression. In a char the placeholder must be a number N and it will be replaced with the first character of the corresponding capture N from the calling regular expression. Whenever a rule allows this attribute it will contain a (dynamic).
Mõned reeglid lubavad määrata lisaatribuudi dynamic, mis kasutab tõeväärtust (vaikimisi on see väär ehk false). Kui dynamic on tõene (true), võib reegel kasutada teksti esindavaid kohatäitjaid, mis sobivad regulaaravaldise reeglile, mis lülitub aktiivsele kontekstile oma atribuudiga string või char. Atribuudi string korral asendatakse kohatäitja% N (kus N on arv) vastava kohaga N väljakutsutavas regulaaravaldises. Atribuudi char korra peab kohatäitja olema arv N ja see asendatakse esimese märgiga vastavas kohas N väljakutsutavas regulaaravaldises. Kui reegel vähegi seda atribuuti lubab, sisaldub selles (dynamic).
dynamic: may be (true_BAR_false).
dynamic: võib olla tõene või väär ((true_BAR_false)).
& lt; DetectChar char=quot; (character)quot; (common attributes) (dynamic) / gt;
& lt; DetectChar char=quot; (märk) quot; (üldatribuudid) (dynamic) / gt;
& lt; Detect2Chars char=quot; (character)quot; char1=quot; (character)quot; (common attributes) (dynamic) / gt;
& lt; Detect2Chars char=quot; (märk) quot; char1=quot; (märk) quot; (üldatribuudid) (dynamic) / gt;
& lt; StringDetect String=quot; (string)quot; [insensitive=quot; true_BAR_falsequot;] (common attributes) (dynamic) / gt;
& lt; StringDetect String=quot; (string) quot; [insensitive=quot; true_BAR_false; quot;] (üldatribuudid) (dynamic) / gt;
The String attribute defines the string to match. The insensitive attribute defaults to false and is passed to the string comparison function. If the value is true insensitive comparing is used.
Atribuut String määrab otsitava stringi. Atribuut insensitive on vaikimisi false ning seda kasutab stringivõrdlusfunktsioon. Kui väärtus on true, kasutatakse tõstutundetut võrdlust.
& lt; RegExpr String=quot; (string)quot; [insensitive=quot; true_BAR_falsequot;] [minimal=quot; true_BAR_falsequot;] (common attributes) (dynamic) / gt;
& lt; RegExpr String=quot; (string) quot; [insensitive=quot; true_BAR_false; quot;] [minimal=quot; true_BAR_falsequot;] (üldatribuudid) (dynamic) / gt;
insensitive defaults to false and is passed to the regular expression engine.
insensitive on vaikimisi false ja seda kasutab regulaaravaldise mootor.
minimal defaults to false and is passed to the regular expression engine.
minimal on vaikimisi false ja seda kasutab regulaaravaldise mootor.
& lt; Int (common attributes) (dynamic) / gt;
& lt; Int (üldatribuudid) (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. Actually all rules are allowed as child rules, though, the DTD only allows the child rule StringDetect.
Sellel reeglil ei ole spetsiifilisi atribuute. Tihti kasutatakse alamreegleid, et tuvastada arvu järel L ja U kombinatsioone, mis osutavad programmikoodis täisarvu tüübile. Õigupoolest on alamreeglina lubatud kõik reeglid, kuid DTD lubab siiski ainult alamreeglit StringDetect.