natgillin/translations-raw huggingface dataset:
name pot ser singleLine o multiLine. Si escolliu multiLine es necessiten els atributs end i region.
name is either singleLine or multiLine. If you choose multiLine the attributes end and region are required.
start defineix la cadena que s' usa per iniciar un comentari. En C++ seria & quot; / * quot;.
start defines the string used to start a comment. In C++ this would be & quot; /*quot;.
end defineix la cadena usada per a tancar un comentari. En C++ seria & quot; * / quot;.
end defines the string used to close a comment. In C++ this would be & quot; */ quot;.
region serà el nom amb el que es desarà el comentari multi- línia. Si assumim que tenim una regió beginRegion=" Comentari "... endRegion=" Comentari" en les vostres regles, haureu d' usar region=" Comentari ". D' aquesta manera es descomentarà fins i tot si no heu seleccionat tot el text en un comentari multi- línia. Tan sols és necessari que el cursor estigui dins del comentari multi- línia.
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.
L' element folding en el grup general defineix les propietats de plegat de codi. Els atributs disponibles són:
The element folding in the group general defines code folding properties. Available attributes are:
indentationsensitive si està a true, els marcadors de plegat de codi seran afegits al sagnat, com en el llenguatge d' script Python. Normalment no us caldrà establir- lo, pel que per omissió és false.
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.
L' element indentation en el grup general defineix quin sagnat s' usarà, encara que us recomanem fervorosament que l' ometeu, atès que el sagnat sol ser establert en el tipus de fitxer o a l' afegir el mode de línia al fitxer de text. Tot i que si especifiqueu un sagnat, podreu forçar un sagnat específic per a un usuari, per un altra que us agradi més. Els atributs disponibles són:
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:
mode és el nom del sagnat. Els sagnats disponibles a la dreta són: normal, cstyle, csands, xml, python i varindent.
mode is the name of the indenter. Available indenters right now are: normal, cstyle, csands, xml, python and varindent.
Estils per omissió disponibles
Available Default Styles
Els estils per omissió ja s' han explicat, a mode de resum: Els estils per omissió estan predefinits per als estils de colors i tipus de lletra.
Default Styles were already explained, as a short summary: Default styles are predefined font and color styles.
Veurem la llista dels estils per omissió disponibles:
So here only the list of available default styles:
dsNormal, usat per al text normal.
dsNormal, used for normal text.
dsKeyword, usat per a les paraules clau.
dsKeyword, used for keywords.
dsDataType, usat per als tipus de dades.
dsDataType, used for data types.
dsDecVal, usat per als valors decimals.
dsDecVal, used for decimal values.
dsBaseN, usat per als valors en una base diferent a 10.
dsBaseN, used for values with a base other than 10.
dsFloat, usat per a valors de coma flotant.
dsFloat, used for float values.
dsChar, usat per a un caràcter.
dsChar, used for a character.
dsString, usat per a cadenes.
dsString, used for strings.
dsComment, usat per a comentaris.
dsComment, used for comments.
dsOthers, usat per a d ''altres 'coses.
dsOthers, used for'other 'things.
dsAlert, usat per a missatges d' avis.
dsAlert, used for warning messages.
dsFunction, usat per a crides a funcions.
dsFunction, used for function calls.
dsRegionMarker, usat per a marcadors de regió.
dsRegionMarker, used for region markers.
dsError, usat per a errors de ressaltat i sintaxi incorrecta.
dsError, used for error highlighting and wrong syntax.
Regles de detecció del ressaltat
Highlight Detection Rules
Aquesta secció descriu les regles de detecció del ressaltat.
This section describes the syntax detection rules.
Cada regla pot coincidir en cap o amb varis caràcters del començament de la cadena amb la que es comparen. Si la regla coincideix, als caràcters coincidents se' ls assigna l' estil o attribute definit per la regla, tan mateix una regla pot demanar que es canviï el context actual.
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.
Una regla te aquest aspecte:
A rule looks like this:
& lt; NomRegla attribute=quot; (identificador) quot; context=quot; (identificador) quot; [atributs específics de la regla] / gt;
& lt; RuleName attribute=quot; (identifier)quot; context=quot; (identifier)quot; [rule specific attributes] / gt;
L 'attribute identifica l' estil que usaran els caràcters coincidents per nom, i el context identifica el context a usar des d' aquí.
The attribute identifies the style to use for matched characters by name, and the context identifies the context to use from here.
El context es pot identificar per:
The context can be identified by:
Un identifier, que és el nom dels altres contexts.
An identifier, which is the name of the other context.
Una order us indica al motor que romandrà en el context actual (# stay), o que salti al context anterior (# pop).
An order telling the engine to stay in the current context (#stay), or to pop back to a previous context used in the string (#pop).
Per a retrocedir més passes, es pot repetir la paraula clau # pop: # pop# pop# pop
To go back more steps, the #pop keyword can be repeated: #pop#pop#pop
Algunes regles poden tenir regles fill que s' executen únicament si la regla pare resulta aplicable. A tota la cadena coincident se us donarà l' atribut definit per la regla pare. Una regla amb regles fills te aquest aspecte:
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:
& lt; NomRegla (atributs) gt; & lt; NomReglaFill (atributs) / gt;... & lt; / NomReglagt;
& lt; RuleName (attributes)gt; & lt; ChildRuleName (attributes) / gt;... & lt; /RuleNamegt;
Els atributs específics de la regla varien, i es descriuen en les següents seccions.
Rule specific attributes varies and are described in the following sections.
Atributs comuns
Common attributes
Totes les regles tenen els següents atributs comuns i estan disponibles sempre que apareixen (atributs comuns). attribute i context són atributs requerits, els demés són opcionals.
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.
attribute: Un mapa d' atributs d' un definit itemData.
attribute: An attribute maps to a defined itemData.
context: Especifica el context al que canviarà el sistema de ressaltat si les regles coincideixen.
context: Specify the context to which the highlighting system switches if the rule matches.
beginRegion: Inicia un bloc de plegat de codi. Per omissió: unset.
beginRegion: Start a code folding block. Default: unset.
endRegion: Tanca un bloc de plegat de codi. Per omissió: unset.
endRegion: Close a code folding block. Default: unset.
lookAhead: Si està a true, el sistema de ressaltat no processarà les longituds coincidents. Per omissió: false.
lookAhead: If true, the highlighting system will not process the matches length. Default: false.
firstNonSpace: Tan sols coincidiran si la cadena no conté un espai en blanc al començament de la línia. Per omissió: false.
firstNonSpace: Match only, if the string is the first non-whitespace in the line. Default: false.
column: Tan sols coincideix, si la columna coincideix. Per omissió: unset.
column: Match only, if the column matches. Default: unset.
Regles dinàmiques
Dynamic rules
Algunes regles permeten l' atribut opcional dynamic de tipus lògic que per omissió és false. Si dynamic està a true, la regla podrà usar arguments que representin el text coincident amb una regla d' una expressió regular que canviï al context actual per al contingut en els atributs string o char. En un string, l' argument% N (a on N és un número) es substituirà amb la corresponent N capturada des de l' expressió regular cridada. En un char l' argument haurà de ser un número N i serà substituït amb el primer caràcter de la corresponent N capturada des de l' expressió regular cridada. Sempre que un regla permeti aquest atribut haurà de contenir un (dynamic).
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).
dinàmic: pot ser (true_BAR_false).
dynamic: may be (true_BAR_false).
Les regles en detall
The Rules in Detail
DetectChar
DetectChar
Detecta un únic caràcter específic. Normalment s' usa per a trobar el final de les cadenes entre cometes.
Detect a single specific character. Commonly used for example to find the ends of quoted strings.
& lt; DetectChar char=quot; (caràcter) quot; (atributs comuns) (dinàmic) / gt;
& lt; DetectChar char=quot; (character)quot; (common attributes) (dynamic) / gt;
L' atribut char defineix el caràcter a comparar.
The char attribute defines the character to match.
Detect2Chars
Detect2Chars
Detecta dos caràcters especificats en l' ordre definit.
Detect two specific characters in a defined order.
& lt; Detect2Chars char=quot; (caràcter) quot; char1=quot; (caràcter) quot; (atributs comuns) (dinàmic) / gt;
& lt; Detect2Chars char=quot; (character)quot; char1=quot; (character)quot; (common attributes) (dynamic) / gt;
L' atribut char defineix el primer caràcter a comparar, char1 el segon.
The char attribute defines the first character to match, char1 the second.
AnyChar
AnyChar
Detecta un caràcter d' un conjunt de caràcters especificats.
Detect one character of a set of specified characters.
& lt; AnyChar String=quot; (cadena) quot; (atributs comuns) / gt;
& lt; AnyChar String=quot; (string)quot; (common attributes) / gt;
L' atribut String defineix el conjunt de caràcters.
The String attribute defines the set of characters.
StringDetect
StringDetect
Detecta una cadena exacta.
Detect an exact string.
& lt; StringDetect String=quot; (cadena) quot; [insensitive=quot; true_BAR_falsequot;] (atributs comuns) (dinàmic) / gt;
& lt; StringDetect String=quot; (string)quot; [insensitive=quot; true_BAR_falsequot;] (common attributes) (dynamic) / gt;
L' atribut String defineix la cadena a comparar. L' atribut insensitive per omissió és a false i es passa a la funció de comparació de cadena. Si el valor és true la comparació no serà sensible a majúscules i minúscules.
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.
RegExpr
RegExpr
Cerca la coincidència amb una expressió regular.
Matches against a regular expression.
& lt; RegExpr String=quot; (cadena) quot; [insensitive=quot; true_BAR_falsequot;] [minimal=quot; true_BAR_falsequot;] (atributs comuns) (dinàmic) / gt;
& lt; RegExpr String=quot; (string)quot; [insensitive=quot; true_BAR_falsequot;] [minimal=quot; true_BAR_falsequot;] (common attributes) (dynamic) / gt;
L' atribut String defineix l' expressió regular.
The String attribute defines the regular expression.
insensitive per omissió és a false i és passada al motor d' expressions regulars.
insensitive defaults to false and is passed to the regular expression engine.
minimal per omissió és a false i és passada al motor d' expressions regulars.
minimal defaults to false and is passed to the regular expression engine.
Atès que les regles coincideixen amb el començament de la cadena actual, una expressió regular que comenci amb el símbol del barret (^) indica que la regla tan sols s' haurà de comparar amb el començament d' una línia.
Because the rules are always matched against the beginning of the current string, a regular expression starting with a caret (^) indicates that the rule should only be matched against the start of a line.
Mireu la secció sobre expressions regulars per a obtenir més informació.
See Regular Expressions for more information on those.
keyword
keyword
Detecta una paraula clau des d' una llista especificada.
Detect a keyword from a specified list.
& lt; keyword String=quot; (nom de la llista) quot; (atributs comuns) / gt;
& lt; keyword String=quot; (list name)quot; (common attributes) / gt;
L' atribut String identifica la llista de paraules clau pel seu nom. Haurà d' existir una llista amb aquest nom.
The String attribute identifies the keyword list by name. A list with that name must exist.
Detecta un número enter.
Detect an integer number.
& lt; Int (atributs comuns) (dinàmic) / gt;
& lt; Int (common attributes) (dynamic) / gt;
Aquesta regla no te atributs específics. Les regles fill normalment s' usen per a detectar combinacions de L i U després del número, indicant el tipus d' enter en el codi del programa. En realitat s' admeten totes les regles com a regles fill, tot i que, el DTD tan sols permet la regla fill StringDetect.
This rule has no specific attributes. Child rules are typically used to detect combinations of L and U after the number, indicating the integer type in program code. Actually all rules are allowed as child rules, though, the DTD only allows the child rule StringDetect.
El següent exemple troba números enters seguits del caràcter 'L'.
The following example matches integer numbers follows by the character'L '.
& lt; Int attribute=" Decimal "context=" # stay "& gt; & lt; StringDetect attribute=" Decimal" context= "# stay" String=" L "insensitive=" true" / gt; & lt; / Intgt;
& lt; Int attribute="Decimal "context="#stay" & gt; & lt; StringDetect attribute="Decimal "context="#stay" String="L "insensitive="true"/ gt; & lt; /Intgt;
Flotant
Float
Detecta un número de coma flotant.
Detect a floating point number.
& lt; Float (atributs comuns) / gt;
& lt; Float (common attributes) / gt;
Aquesta regla no te atributs específics. Es permet AnyChar com a regla fill i normalment s' usa per a detectar combinacions, mireu la regla Int com a referència.
This rule has no specific attributes. AnyChar is allowed as a child rules and typically used to detect combinations, see rule Int for reference.
HlCOct
HlCOct
Detecta una representació numèrica d' un número octal.
Detect an octal point number representation.
& lt; HlCOct (atributs comuns) / gt;
& lt; HlCOct (common attributes) / gt;
Aquesta regla no te atributs específics.
This rule has no specific attributes.
HlCHex
HlCHex
Detecta una representació numèrica d' un número hexadecimal.
Detect a hexadecimal number representation.
& lt; HlCHex (atributs comuns) / gt;
& lt; HlCHex (common attributes) / gt;
HlCStringChar
HlCStringChar
Detecta un caràcter escapat.
Detect an escaped character.
& lt; HlCStringChar (atributs comuns) / gt;
& lt; HlCStringChar (common attributes) / gt;
Localitza representacions literals de caràcters que s' usen habitualment en el codi de programació, per exemple\ (nova línia) o\\ t (TAB).
It matches literal representations of characters commonly used in program code, for example\ (newline) or \\t (TAB).
Els següents caràcters coincideixen amb la regla si segueixen a una barra invertida (\\): abefnrtvquot; '?\\. A més seran vàlids els números hexadecimals escapats com per exemple\\ xff, i els números octals escapats, per exemple\\ 033.
The following characters will match if they follow a backslash (\\): abefnrtvquot; '?\\. Additionally, escaped hexadecimal numbers like for example \\xff and escaped octal numbers, for example \\033 will match.
HlCChar
HlCChar
Detecta un caràcter C.
Detect an C character.
& lt; HlCChar (atributs comuns) / gt;
& lt; HlCChar (common attributes) / gt;
Localitza caràcters C tancats en una marca (Exemple: 'c'). La marca pot ser un caràcter simple o un caràcter escapat. Veure HICStringChar per a localitzar seqüències de caràcters escapats.
It matches C characters enclosed in a tick (Example: 'c '). So in the ticks may be a simple character or an escaped character. See HlCStringChar for matched escaped character sequences.
RangeDetect
RangeDetect
Detecta una cadena amb caràcters d' inici i de final definits.
Detect a string with defined start and end characters.
& lt; RangeDetect char=quot; (caràcter) quot; char1=quot; (caràcter) quot; (atributs comuns) / gt;
& lt; RangeDetect char=quot; (character)quot; char1=quot; (character)quot; (common attributes) / gt;
char defineix el caràcter que inicia l' interval, char1 el caràcter que finalitza l' interval.
char defines the character starting the range, char1 the character ending the range.
És molt útil per a detectar per exemple petites cadenes entre cometes i similars, però tingueu en compte que el motor de ressaltat tan sols pot treballar amb una cada vegada, així que no es detectaran cadenes que estiguin dividides en dues línies o més.
Useful to detect for example small quoted strings and the like, but note that since the highlighting engine works on one line at a time, this will not find strings spanning over a line break.
LineContinue
LineContinue
Localitza el final de la línia.
Matches at end of line.
& lt; LineContinue (atributs comuns) / gt;
& lt; LineContinue (common attributes) / gt;
Aquesta regla és pràctica per a canviar el context al final de la línia, si l' últim caràcter és una barra invertida ('\\'). Això és necessari per exemple en C/ C++ per a continuar macros o cadenes.
This rule is useful for switching context at end of line, if the last character is a backslash ('\\ '). This is needed for example in C/ C++ to continue macros or strings.
IncludeRules
IncludeRules
Inclou regles des d' un altra context o llenguatge/ fitxer.
Include rules from another context or language/ file.
& lt; IncludeRules context=quot; contextlinkquot; [includeAttrib=quot; true_BAR_falsequot;] / gt;
& lt; IncludeRules context=quot; contextlinkquot; [includeAttrib=quot; true_BAR_falsequot;] / gt;
L' atribut context defineix el context a incloure.
The context attribute defines which context to include.
Si és una cadena simple inclou totes les regles definides en el context actual, exemple:
If it a simple string it includes all defined rules into the current context, example:
& lt; IncludeRules context=quot; anotherContextquot; / gt;
& lt; IncludeRules context=quot; anotherContextquot; / gt;
Si la cadena comença amb ## el sistema de ressaltat cercarà una altra definició de llenguatge amb el nom indicat, exemple:
If the string begins with ## the highlight system will look for another language definition with the given name, example:
& lt; IncludeRules context=quot; ## C++quot; / gt;
& lt; IncludeRules context=quot; ##C++quot; / gt;
Si l' atribut includeAttrib està a true, canvia l' atribut de destí per un altra de la font. Això és necessari, per exemple, per al treball comentar, si el text coincideix amb el context introduït s' usa un ressaltat diferent que amb el context amfitrió.
If includeAttrib attribute is true, change the destination attribute to the one of the source. This is required to make for example commenting work, if text matched by the included context is a different highlight than the host context.
DetectSpaces
DetectSpaces
Detecta espais en blanc.
Detect whitespaces.
& lt; DetectSpaces (atributs comuns) / gt;
& lt; DetectSpaces (common attributes) / gt;
Useu aquesta regla si sabeu que hi poden haver varis espais en blanc al davant, per exemple, al començament de les línies sagnades. Aquesta regla ometrà tots els espais en blanc a la vegada, en comptes de comprovar múltiples regles i saltar si no hi ha coincidències.
Use this rule if you know that there can several whitespaces ahead, for example in the beginning of indented lines. This rule will skip all whitespace at once, instead of testing multiple rules and skipping one at the time due to no match.
DetectIdentifier
DetectIdentifier
Detecta identificadors de cadenes (com una expressió regular: [a- zA- Z _] [a- zA- Z0- 9 _] *).
Detect identifier strings (as a regular expression: [a-zA-Z_][a-zA-Z0-9_]*).
& lt; DetectIdentifier (atributs comuns) / gt;
& lt; DetectIdentifier (common attributes) / gt;
Useu aquesta regla per a saltar d' una vegada una cadena de paraula de caràcters, en comptes de comprovar múltiples regles i saltar si no hi ha coincidències.
Use this rule to skip a string of word characters at once, rather than testing with multiple rules and skipping one at the time due to no match.
Consells i trucs
Tips & Tricks
Una vegada que hageu entès com funciona el canvi de context serà fàcil escriure definicions de ressaltat. Tot i que hauria de tenir cura de comprovar quina situació s' hauria de seleccionar una regla. Les expressions regulars són molt potents, però són lentes en comparació amb d' altres regles. Per això haureu de tenir en compte els següents consells.
Once you have understood how the context switching works it will be easy to write highlight definitions. Though you should carefully check what rule you choose in what situation. Regular expressions are very mighty, but they are slow compared to the other rules. So you may consider the following tips.
Si tan sols heu de localitzar dos caràcters useu Detect2Chars en comptes de StringDetect. El mateix s' aplica a DetectChar.
If you only match two characters use Detect2Chars instead of StringDetect. The same applies to DetectChar.
Les expressions regulars són fàcils d' usar però a vegades hi ha formes molt més ràpides d' obtenir el mateix resultat. Imagineu que tan sols desitgeu localitzar el caràcter '#' si aquest és el primer caràcter de la línia. Una solució basada en una expressió regular seria quelcom semblant a això: lt; RegExpr attribute=quot; Macroquot; context=quot; macroquot; String=quot; ^\\ s * # quot; / gt; Podeu aconseguir el mateix molt més ràpid usant: lt; DetectChar attribute=quot; Macroquot; context=quot; macroquot; char=quot; # quot; firstNonSpace=quot; truequot; / gt; Si desitgeu que l' expressió regular localitzi '^ #' també podeu usar DetectChar amb l' atribut column=quot; 0quot;. L' atribut column compta els caràcters base, per tant el tabulador és tan sols un caràcter.
Regular expressions are easy to use but often there is another much faster way to achieve the same result. Consider you only want to match the character '# 'if it is the first character in the line. A regular expression based solution would look like this: lt; RegExpr attribute=quot; Macroquot; context=quot; macroquot; String=quot; ^\\s*#quot; / gt; You can achieve the same much faster in using: lt; DetectChar attribute=quot; Macroquot; context=quot; macroquot; char=quot; #quot; firstNonSpace=quot; truequot; / gt; If you want to match the regular expression '^#' you can still use DetectChar with the attribute column=quot; 0quot;. The attribute column counts character based, so a tabulator still is only one character.