natgillin/translations-raw huggingface dataset:
Sempre que obriu un fitxer, una de les primeres coses que fa l' editor de & kate; és detectar quina definició de sintaxi s' usarà per al fitxer. Mentre va llegint el text del fitxer, i mentre hi va escrivint, el sistema de ressaltat de sintaxi analitza el text usant les regles establertes per la definició de sintaxi i marcant a on comencen i acaben els diferents contexts i estils.
Whenever you open a file, one of the first things the & kate; editor does is detect which syntax definition to use for the file. While reading the text of the file, and while you type away in it, the syntax highlighting system will analyze the text using the rules defined by the syntax definition and mark in it where different contexts and styles begin and end.
Quan escriviu en el document, el text nou és analitzat i marcat al vol, de manera que si esborreu un caràcter que marca el començament o el final d' un context, l' estil del text adjacent canviarà en conseqüència.
When you type in the document, the new text is analyzed and marked on the fly, so that if you delete a character that is marked as the beginning or end of a context, the style of surrounding text changes accordingly.
Les definicions de sintaxi usades pel sistema de ressaltat de sintaxi de & kate; són fitxers & XML;, que contenen
The syntax definitions used by the & kate; Syntax Highlighting System are & XML; files, containing
Regles per a detectar el paper del text, organitzades en blocs de context
Rules for detecting the role of text, organized into context blocks
Llistes de paraules clau
Keyword lists
Definicions d' ítems d' estil
Style Item definitions
Quan s' analitza el text, les regles de detecció són avaluades en l' ordre en el que estan definides, i si el començament de la cadena actual coincideix amb la regla, s' usarà el context relacionat. El punt d' inici del text es mou al punt final en el que la regla coincideix i comença un nou cicle de regles, començant en el context establert per la regla coincident.
When analyzing the text, the detection rules are evaluated in the order in which they are defined, and if the beginning of the current string matches a rule, the related context is used. The start point in the text is moved to the final point at which that rule matched and a new loop of the rules begins, starting in the context set by the matched rule.
Les regles de detecció són el nucli del sistema de detecció de ressaltat. Una regla és una cadena, un caràcter o una expressió regular contra la que haurà de coincidir el text que s' està analitzant. Conté informació sobre l' estil a usar per a la part coincident del text. Es pot canviar el context de treball del sistema, ja sigui cap a un context mencionat explícitament o cap l' anterior context usat pel text.
The detection rules are the heart of the highlighting detection system. A rule is a string, character or regular expression against which to match the text being analyzed. It contains information about which style to use for the matching part of the text. It may switch the working context of the system either to an explicitly mentioned context or to the previous context used by the text.
Les regles s' organitzen en grups de context. Un grup de context s' usa per als conceptes del text principal dins del format, per exemple, les cadenes de text entre cometes o els blocs de comentaris en el codi font d' un programa. Això garanteix que el sistema de ressaltat no necessita realitzar un cicle per a totes les regles quan no és necessari, i que algunes seqüències de caràcters del text es poden tractar de forma diferent depenent del context actual.
Rules are organized in context groups. A context group is used for main text concepts within the format, for example quoted text strings or comment blocks in program source code. This ensures that the highlighting system does not need to loop through all rules when it is not necessary, and that some character sequences in the text can be treated differently depending on the current context.
En les regles és possible generar contexts dinàmicament per a permetre l' ús de dades específiques d' una instància.
Contexts may be generated dynamically to allow the usage of instance specific data in rules.
Estils i paraules clau del context
Context Styles and Keywords
En alguns llenguatges de programació, els números enters són tractats pel compilador (el programa que converteix el codi font en un executable binari) d' una forma diferent als de coma flotant, i poden haver- hi caràcters que tinguin un significat especial dins d' una cadena entre cometes. En aquests casos, te sentit processar- los de diferent manera que el text adjacent, per a que resultin fàcils d' identificar. De manera que si no representen contexts especials, poden ser vistos com a tals pel sistema de ressaltat de sintaxi, així que són marcats per a un processat diferent.
In some programming languages, integer numbers are treated differently than floating point ones by the compiler (the program that converts the source code to a binary executable), and there may be characters having a special meaning within a quoted string. In such cases, it makes sense to render them differently from the surroundings so that they are easy to identify while reading the text. So even if they do not represent special contexts, they may be seen as such by the syntax highlighting system, so that they can be marked for different rendering.
Una definició de sintaxi pot contenir tants estils com siguin requerits per a cobrir tots els conceptes del format per al que s' usa.
A syntax definition may contain as many styles as required to cover the concepts of the format it is used for.
En molts formats hi ha llistes de paraules que representen un concepte específic. Per exemple, en els llenguatges de programació, les sentències de control són un concepte, els noms de tipus de dades un altra, i les funcions encastades en el llenguatge són un tercer. El sistema de ressaltat de sintaxi de & kate; pot usar dites llistes per a detectar i marcar paraules en el text per emfatitzar conceptes dels formats de text.
In many formats, there are lists of words that represent a specific concept. For example in programming languages, the control statements is one concept, data type names another, and built in functions of the language a third. The & kate; Syntax Highlighting System can use such lists to detect and mark words in the text to emphasize concepts of the text formats.
Estils per omissió
Default Styles
Si obriu un fitxer de codi font de C++, un fitxer font de & Java; i un fitxer HTML en & kate; podreu comprovar que tot i que els formats són diferents, i per tant les paraules que reben un tractament especial també són diferents, els colors usats són els mateixos. Això es deu a que & kate; te una llista per omissió d' estils per omissió, que s' empren en les definicions de sintaxi individuals.
If you open a C++ source file, a & Java; source file and an HTML document in & kate;, you will see that even though the formats are different, and thus different words are chosen for special treatment, the colors used are the same. This is because & kate; has a predefined list of Default Styles which are employed by the individual syntax definitions.
Això facilita el reconèixer conceptes similars en diferents formats de text. Per exemple, els comentaris estan presents en pràcticament qualsevol llenguatge de programació, scripts o descripció, i si es presenten usant el mateix estil en tots els llenguatges, no haureu de parar- vos a pensar i identificar la seva posició en el text.
This makes it easy to recognize similar concepts in different text formats. For example comments are present in almost any programming, scripting or markup language, and when they are rendered using the same style in all languages, you do not have to stop and think to identify them within the text.
Tots els estils de definició de sintaxi usen un dels estils per omissió. Hi ha poques definicions de sintaxi que usin més estils dels que hi ha per omissió, així que, si useu un format molt sovint, potser us val la pena obrir el diàleg de configuració per a veure si alguns conceptes estan usant el mateix estil. Per exemple, tan sols hi ha un estil per omissió per a les cadenes, però com el llenguatge de programació Perl usa dos tipus de cadena, podeu millorar el ressaltat configurant ambdues de forma lleugerament diferent. Més endavant s' explicaran tots els estils per omissió disponibles.
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 dialog 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. All available default styles will be explained later.
El format & XML; de definició de ressaltat
The Highlight Definition & XML; Format
Aquesta secció és una introducció al format & XML; de definició de ressaltat. Descriu els components principals, el seu significat i utilització. La següent secció entra en detalls amb les regles de detecció.
This section is an overview of the Highlight Definition & XML; format. Based on a small example it will describe the main components and their meaning and usage. The next section will go into detail with the highlight detection rules.
La definició formal, és a dir, el DTD, es desa en el fitxer language. dtd, el qual hauria d' estar instal· lat en la carpeta $KDEDIR / share/ apps/ katepart/ syntax del vostre sistema.
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/ katepart/ syntax.
Principals seccions dels fitxers de definicions de ressaltat de & kate;
Main sections of & kate; Highlight Definition files
Tots els fitxers de ressaltat contenen un capçalera que estableix la versió XML i el doctype (tipus de document):
A highlighting file contains a header that sets the XML version and the doctype:
& 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;
La part principal del fitxer de definició es l' ítem languaje. Els atributs disponibles són:
The root of the definition file is the element language. Available attributes are:
Atributs requerits:
Required attributes:
name estableix el nom del llenguatge. Després apareixerà en el menú i en els diàlegs.
name sets the name of the language. It appears in the menus and dialogs afterwards.
section especifica la categoria.
section specifies the category.
extensions defineix les extensions dels fitxers, com & quot; *. cpp; *. hquot;
extensions defines file extensions, like & quot; *. cpp; *. hquot;
Atributs opcionals:
Optional attributes:
mimetype fitxers associats al tipus & MIME; en que es basen.
mimetype associates files & MIME; Type based.
version especifica la versió actual del fitxer de definició.
version specifies the current version of the definition file.
kateversion especifica la última versió suportada per & kate;.
kateversion specifies the latest supported & kate; version.
casesensitive defineix quan les paraules clau són o no sensibles a majúscules i minúscules.
casesensitive defines, whether the keywords are case sensitive or not.
priority es necessària si una altra definició de ressaltat usa les mateixes extensions. S' usarà la de major prioritat.
priority is necessary if another highlight definition file uses the same extensions. The higher priority will win.
author conté el nom de l' autor i la seva adreça de correu electrònic.
author contains the name of the author and his email-address.
license conté la llicència, normalment LPGL, Artistic, GPL i d' altres.
license contains the license, usually LGPL, Artistic, GPL and others.
hidden defineix quan hauria d' aparèixer el nom en els menús de & kate;.
hidden defines, whether the name should appear in & kate; 's menus.
De manera que dita línia pot tenir un aspecte similar a:
So the next line may look like this:
& 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;
A continuació estaria l' element highlighting, el qual conté l' element opcional list i els elements requerits contexts i itemDatas.
Next comes the highlighting element, which contains the optional element list and the required elements contexts and itemDatas.
Els elements list contenen una llista de paraules clau. En aquest cas les paraules clau són class i const. Podeu afegir tantes llistes com us calguin.
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.
L' element contexts conté tots els contexts. El primer és l' usat per omissió i amb aquest s' iniciarà el ressaltat. Hi ha dues regles en el context Normal Text, que faran coincidir la llista de paraules clau amb el nom algun_ nom i una regla que detecta una cometa i canvia el context a cadena. Per aprendre més sobre les regles llegiu el següent capítol.
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.
La tercera part és l' ítem itemDatas. Conté tots els colors i tipus de lletra que necessiten els contexts i les regles. En aquest exemple, s' usen itemData Normal Text, String i Keyword.
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.
& lt; highlightinggt; & lt; list name=quot; algun_ nomquot; gt; & lt; itemgt; class & lt; / itemgt; & lt; itemgt; const & lt; / itemgt; & lt; / listgt; & lt; contextsgt; & lt; context attribute=quot; text_ normalquot; lineEndContext=quot; # popquot; name=quot; text_ normalquot; & gt; & lt; keyword attribute=quot; paraula_ clauquot; context=quot; # stayquot; String=quot; algun_ nomquot; / gt; & lt; DetectChar attribute=quot; cadenaquot; context=quot; stringquot; char=quot; amp; quot; quot; / gt; & lt; / contextgt; & lt; context attribute=quot; cadenaquot; lineEndContext=quot; # stayquot; name=quot; cadenaquot; & gt; & lt; DetectChar attribute=quot; cadenaquot; context=quot; # popquot; char=quot; amp; quot; quot; / gt; & lt; / contextgt; & lt; / contextsgt; & lt; itemDatasgt; & lt; itemData name=quot; text_ normalquot; defStyleNum=quot; dsNormalquot; / gt; & lt; itemData name=quot; paraula_ clauquot; defStyleNum=quot; dsParaula_ clauquot; / gt; & lt; itemData name=quot; cadenaquot; defStyleNum=quot; dsCadenaquot; / gt; & lt; / itemDatasgt; & lt; / highlightinggt;
& 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;
L' última part de la definició de ressaltat és la secció opcional general. Pot contenir informació sobre paraules clau, plegat de codi, comentaris i sagnat.
The last part of a highlight definition is the optional general section. It may contain information about keywords, code folding, comments and indentation.
La secció comment defineix amb quina cadena s' introdueix un comentari en una línia senzilla. També podeu definir comentaris en múltiples línies usant multiLine amb l' atribut addicional end. Això s' usa si l' usuari prem la drecera corresponent per a comenta/ descomenta.
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.
La secció keywords defineix si les llistes de paraules clau són sensibles a majúscules i minúscules o no. Més endavant s' explicaran d' altres atributs.
The keywords section defines whether keyword lists are casesensitive or not. Other attributes will be explained later.
& 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;
Les seccions al detall
The Sections in Detail
Aquesta part descriu tots els atributs disponibles per als contexts, llistes de dades, paraules clau, comentaris, plegat de codi i sagnat.
This part will describe all available attributes for contexts, itemDatas, keywords, comments, code folding and indentation.
L' element context pertany al grup contexts. Un context defineix les regles específiques de context que s' han de seguir quan el sistema de ressaltat abasta el final d' una línia. Els atributs disponibles són:
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:
name és el nom del context. Les regles usaran el nom per especificar el context al que canviar si les regles coincideixen.
name the context name. Rules will use this name to specify the context to switch to if the rule matches.
lineEndContext defineix el context al que canviarà el sistema de ressaltat si abasta el final de la línia. Pot ser un nom o un altra context, # stay permetrà que no es canviï el context (pex;, no fer res) o # pop farà que es surti aquest context. És possible usar per exemple # pop# pop# pop per a sortir tres vegades.
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.
lineBeginContext defineix el context si es troba el començament d' una línia. Per omissió: # stay.
lineBeginContext defines the context if a begin of a line is encountered. Default: #stay.
fallthrough defineix si el sistema de ressaltat canviarà al context especificat en fallthroughtContext si no coincideixen les regles. Per omissió: false.
fallthrough defines if the highlight system switches to the context specified in fallthroughContext if no rule matches. Default: false.
fallthroughContext especifica el context següent si no hi ha regles que coincideixin.
fallthroughContext specifies the next context if no rule matches.
dynamic si està a true, el context recordarà cadenes/ ítems substituïbles desats per les regles dinàmiques. Això es necessita per als documents HERE, per exemple. Per omissió: false.
dynamic if true, the context remembers strings/ placeholders saved by dynamic rules. This is needed for HERE documents for example. Default: false.
L' element itemData es troba en el grup itemDatas. Defineix l' estil i els colors dels tipus de lletra. Per tant és possible definir els vostres propis estils i colors, encara que recomanem usar els estils per omissió, atès que així l' usuari veurà colors homogenis per als diferents llenguatges. Si be, algunes vegades no hi ha altres possibilitats i és necessari canviar el color i els atributs dels tipus de lletra. Els atributs name i defStyleNum són necessaris, els altres són opcionals. Els atributs disponibles són:
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:
name estableix el nom del itemData. Els contexts i les regles usaran aquest nom en els seus atributs attribute per a fer referència a un itemData.
name sets the name of the itemData. Contexts and rules will use this name in their attribute attribute to reference an itemData.
defStyleNum defineix quin estil s' usarà per omissió. Més endavant s' explicaran els estils per omissió disponibles.
defStyleNum defines which default style to use. Available default styles are explained in detail later.
color defineix un color. Els formats vàlids són '# rrggbb' o '# rgb'.
color defines a color. Valid formats are '#rrggbb 'or '#rgb'.
selColor defineix el color de la selecció.
selColor defines the selection color.
italic si està a true, el text es mostrarà en cursiva.
italic if true, the text will be italic.
bold si està a true, el text es mostrarà en negreta.
bold if true, the text will be bold.
underline si està a true, el text es mostrarà subratllat.
underline if true, the text will be underlined.
strikeout si està a true, el text es mostrarà taxat.
strikeout if true, the text will be stroked out.
L' element keywords en el grup general defineix les propietats keyword. Els atributs disponibles són:
The element keywords in the group general defines keyword properties. Available attributes are:
casesensitive pot ser true o false. Si està a true, totes les paraules clau seran sensibles a majúscules i minúscules.
casesensitive may be true or false. If true, all keywords are matched casesensitive
weakDeliminator és una llista de caràcters que no actuen com a delimitadors de paraules (delimitador feble). Per exemple el punt '.' és un delimitador de paraula. Si tenim una paraula clau en una list que conté un punt, tan sols la trobareu si especifiqueu el punt com a delimitador feble.
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.
additionalDeliminator defineix delimitadors addicionals.
additionalDeliminator defines additional delimiters.
wordWrapDeliminator defineix els caràcters al darrera dels quals pot ocórrer un ajust de línia.
wordWrapDeliminator defines characters after which a line wrap may occur.
Els delimitadors per omissió i els d' ajust de línia són els caràcters. ():! +, - lt; =gt;% amp; * /;? [] ^{ _BAR_} ~\\, space ('') i tabulació ('\\ t').
Default delimiters and word wrap delimiters are the characters. ():! +, -lt; =gt; %amp; */;? []^{_BAR_}~\\, space ('') and tabulator ('\\t ').
L' element comment en el grup comments defineix les propietats dels comentaris emprats per Eines Comenta i Eines Descomenta. Els atributs disponibles són:
The element comment in the group comments defines comment properties which are used for Tools Comment and Tools Uncomment. Available attributes are: