natgillin/translations-raw huggingface dataset:
Nøgleordslister
Keyword lists
Når teksten analyseres, bliver detektionsreglerne evalueret i den rækkefølge i hvilken de er defineret, og hvis begyndelsen af den aktuelle streng matcher en regel, bruges den relaterede sammenhæng. Startpunktet i teksten flyttes til slutpunktet for hvilket denne regel matcher og en ny løkke af regler begynder, startende i den sammenhæng der er sat af den matchede regel.
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.
Detektionsreglerne er hjertet af fremhævnings- detektionssystemet. En regel er en streng, et tegn eller et regulært udtryk mod hvilken den tekst der bliver analyseret skal matches. Den indeholder information om hvilken stile der skal bruges for den matchende del af teksten. Den vil muligvis skifte arbejdssammenhæng for systemet enten til en eksplicit nævnt sammenhæng eller til den tidligere sammenhæng brugt af teksten.
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.
Regler er organiserede i sammenhængsgrupper. En sammenhængsgruppe bruges til hovedtekstbegreber indenfor formatet, for eksempel citerede tekststrenge eller kommentar- blokke i programmers kildekode. Dette sikrer at fremhævningen ikke behøver at gå i løkke gennem alle regler når det ikke er nødvendigt, og at visse tegnsekvenser i teksten kan behandles anderledes afhængig af den aktuelle sammenhæng.
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.
Sammenhænge kan skabes dynamisk for eksempel for at tillade brug af instansspecifikke data i regler.
Contexts may be generated dynamically to allow the usage of instance specific data in rules.
I mange formater, er der lister af ord der repræsenterer et bestemt begreb. For eksempel i programmeringssprog, er kontroludsagn et begreb, datatypenavne et andet, og indbyggede funktioner i sproget et tredje. & kate; 's syntaksfremhævningssystem kan bruge sådanne lister til at detektere og markere ord i teksten for at understrege begreber fra tekstformaterne.
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.
Hvis du åbner en C++ kildefil, en & Java; kildefil og et HTML - dokument i & kate;, vil du se at selvom formaterne er forskellige, og forskellige ord således vælges til speciel behandling, er de brugte farver de samme. Det er fordi & kate; har en prædefineret liste af standardstile, som anvendes af de individuelle syntaksdefinitioner.
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.
Dette gør det nemt at genkende lignende begreber i forskellige tekstformater. For eksempel er kommentarer til stede i næsten programmerings -, script - eller opmarkeringssprog, og når de vises ved brug af den samme stil i alle sprog, skal du ikke stoppe op og tænke dig om for at identificere dem indenfor teksten.
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.
Alle stile i en syntaksdefinition bruger en af stadardstilene. Nogle få syntaksdefinitioner bruger flere stile end der er som standard, så hvis du bruger et format ofte, er det måske besværet værd at starte indstillingsdialogen for at se om nogle begreber bruger den samme stil. For eksempel er der kun en standardstil for strenge, men da perl programmeringssproget opererer med to typer strenge, kan du udvide fremhævningen ved at indstille disse til at være en smule forskellige. Alle tilgængelige standardstiler vil blive forklaret senere.
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.
Dette afsnit er et overblik over fremhævningsdefinitionen & XML; - format. Det vil beskrive hovedkomponenterne og deres betydning og brug, baseret på et lille eksempel. Næste afsnit vil gå i detaljer angående fremhævningsdetektionsreglerne.
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.
Den formelle definition, også kendt som DTD gemmes i filen language. dtd som skal være installeret på dit system i mappen $KDEDIR / share/ apps/ katepart/ syntax.
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.
Hovedafsnit i & kate; 's fremhævningsdefinitioner
Main sections of & kate; Highlight Definition files
En syntaksfremhævelsesfil indeholder et hoved som angiver XML- versionen og dokumenttypen:
A highlighting file contains a header that sets the XML version and the doctype:
Definitionsfilens rod er elementet language. Følgende egenskaber er tilgængelige:
The root of the definition file is the element language. Available attributes are:
Egenskaber som kræves:
Required attributes:
section angiver kategorien.
section specifies the category.
extensions definerer filendelser, som & quot; *. cpp; *. hquot;.
extensions defines file extensions, like & quot; *. cpp; *. hquot;
Valgfrie egenskaber:
Optional attributes:
mimetype tilknytter filer baseret på & MIME; - type.
mimetype associates files & MIME; Type based.
version angiver definitionsfilens nuværende version.
version specifies the current version of the definition file.
kateversion angiver seneste version af & kate; som understøttes.
kateversion specifies the latest supported & kate; version.
casesensitive definerer om nøgleord er versalfølsomme eller ej.
casesensitive defines, whether the keywords are case sensitive or not.
priority kræves hvis en anden syntaksfremhævelsesfil bruger samme filendelse. Den højeste prioritet vinder.
priority is necessary if another highlight definition file uses the same extensions. The higher priority will win.
author indeholder forfatterens navn og e- mail- adresse.
author contains the name of the author and his email-address.
license indeholder licensen, oftest LGPL, Artistic, GPL og andre.
license contains the license, usually LGPL, Artistic, GPL and others.
hidden definerer om navnet skal vises i & kate; s menuer.
hidden defines, whether the name should appear in & kate; 's menus.
Næste linje kan altså se sådan her ud:
So the next line may look like this:
Derefter kommer elementet highlighting som indeholder det valgfrie element list og de krævede elementer contexts og itemDatas.
Next comes the highlighting element, which contains the optional element list and the required elements contexts and itemDatas.
list elementer indeholder en liste med nøgleord. I dette tilfælde er nøgleordene class og const. Du kan tilføje så mange lister som du behøver.
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.
Elementet contexts indeholder alle sammenhænge. Den første sammenhæng er standard som start for fremhævelsen. Der er to regler i sammenhængen Normal Text som matcher listen af nøgleord med navnet et- navn og en regel som detekterer et citationstegn og skifter sammenhæng til string. For at lære dig mere om regler, læs næste kapitel.
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.
Den tredje del er elementet itemDatas. Det indeholder alle farver og skrifttypestiler som behøves af sammenhængen og reglerne. I dette eksempel bruges itemData Normal Text, String og 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; 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; 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;
Den sidste del af fremhævelsesdefinitionen er det valgfrie afsnit general. Det kan indeholde information om nøgleord, kodefoldning, kommentarer og indentering.
The last part of a highlight definition is the optional general section. It may contain information about keywords, code folding, comments and indentation.
Afsnittet comment definerer den streng som kommentarer på en linje indledes med. Du kan også definere kommentarer på flere linjer med multiLine og den yderligere egenskab end. Dette er nyttigt når brugeren trykker på genvejstaster som svarer til kommentér/ afkommentér.
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.
Afsnittet keywords definerer om lister med nøgleord er versalfølsomme eller ej. Andre egenskaber forklares senere.
The keywords section defines whether keyword lists are casesensitive or not. Other attributes will be explained later.
Afsnittene i detalje
The Sections in Detail
Denne del beskriver alle tilgængelige egenskaber for sammenhæng, itemData, nøgleord, kommentarer, kodefoldning og indentering.
This part will describe all available attributes for contexts, itemDatas, keywords, comments, code folding and indentation.
Elementet context hører til gruppen contexts. Selve sammenhænget definerer sammenhængsspecifikke regler, såsom hvad der skal ske hvis fremhævelsessystemet når slutningen på en linje. Tilgængelige egenskaber er:
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 er sammenhængens navn. Regler bruger navnet til at angive sammenhængen at skifte til hvis reglen matcher.
name the context name. Rules will use this name to specify the context to switch to if the rule matches.
lineEndContext definerer sammenhængen som fremhævelsessystemet skifter til hvis det når til et linjebrud. Det kan enten være navnet på en andet sammenhæng, # stay for ikke at skifte sammenhæng (dvs. gøre ingenting) eller # pop som gør at sammenhængen forlades. Det er for eksempel muligt at bruge # pop# pop# pop for at gå tre skridt tilbage.
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 definerer sammenhængen hvis begyndelsen på en linje mødes. Standard: # stay.
lineBeginContext defines the context if a begin of a line is encountered. Default: #stay.
fallthrough definerer om fremhævelsessystemet skifter til sammenhængen som angives i fallthroughContext hvis ingen regel matcher. Standard: false.
fallthrough defines if the highlight system switches to the context specified in fallthroughContext if no rule matches. Default: false.
fallthroughContext angiver næste sammenhæng hvis ingen regel matcher.
fallthroughContext specifies the next context if no rule matches.
dynamic hvis true husker sammenhængen strenge/ pladsmarkører som gemt af dynamiske regler. Det behøves for eksempel for HERE- dokumenter. Standard: false.
dynamic if true, the context remembers strings/ placeholders saved by dynamic rules. This is needed for HERE documents for example. Default: false.
Elementet itemData er i gruppen itemDatas. Det definerer skrifttypestilen og farverne. Det er altså muligt at definere egne stiler og farver, men vi anbefaler dog at du holder dig til standardstil om muligt, så brugeren altid ser samme farver brugt i forskellige sprog. Sommetider er der dog ingen anden måde, og det er nødvendigt at ændre farve - og tegnegenskaber. Egenskabens navn og defStyleNum kræves, øvrige er valgfrie. Tilgængelige egenskaber er:
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 angiver navnet på itemData. Sammenhæng og regler bruger navnet i egenskaben attribute til at referere til itemData.
name sets the name of the itemData. Contexts and rules will use this name in their attribute attribute to reference an itemData.
defStyleNum definerer hvilken standardstil som skal bruges. Tilgængelige standardstiler forklares i detalje senere.
defStyleNum defines which default style to use. Available default styles are explained in detail later.
color definerer en farve. Gyldige formater er '# rrggbb' eller '# rgb'.
color defines a color. Valid formats are '#rrggbb 'or '#rgb'.
selColor definerer markeringens farve.
selColor defines the selection color.
italic hvis true, er teksten kursiv.
italic if true, the text will be italic.
bold hvis true, er teksten i fede typer.
bold if true, the text will be bold.
underline hvis true, er teksten understreget.
underline if true, the text will be underlined.
strikeout hvis true, er teksten overstreget.
strikeout if true, the text will be stroked out.
Elementet keywords i gruppen general definerer nøgleordenes egenskaber. Tilgængelige egenskaber er:
The element keywords in the group general defines keyword properties. Available attributes are:
casesensitive kan være true eller false. Hvis det er true, matches alle nøgleord versalfølsomt.
casesensitive may be true or false. If true, all keywords are matched casesensitive
weakDeliminator er en liste med tegn som ikke fungerer som ordgrænser. Punktum '.' er for eksempel en ordgrænse. Antag at et nøgleord i en list indeholder et punktum, så matcher det kun hvis du angiver at punktummet er en svag afgrænser.
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 definerer yderligere grænser.
additionalDeliminator defines additional delimiters.
wordWrapDeliminator definerer tegn som et linjeskift kan ske efter.
wordWrapDeliminator defines characters after which a line wrap may occur.
Standardgrænser og linjeskiftgrænser er tegnene. ():! +, - lt; =gt;% amp; * /;? [] ^{ _BAR_} ~\\, mellemrum ('') og tabulator ('\\ t').
Default delimiters and word wrap delimiters are the characters. ():! +, -lt; =gt; %amp; */;? []^{_BAR_}~\\, space ('') and tabulator ('\\t ').
Elementet comment i gruppen comments definerer kommentaregenskaber som bruges for Værktøj Kommentér og Værktøj Afkommentér. Tilgængelige egenskaber er:
The element comment in the group comments defines comment properties which are used for Tools Comment and Tools Uncomment. Available attributes are:
name er enten singleLine eller multiLine. Hvis du vælger multiLine kræves egenskaberne end og region.
name is either singleLine or multiLine. If you choose multiLine the attributes end and region are required.
start definerer strengen som bruges til at indlede en kommentar. I C++ ville det være & quot; / * quot;.
start defines the string used to start a comment. In C++ this would be & quot; /*quot;.
end definerer strengen som bruges til at afslutte en kommentar. I C++ ville det være & quot; * / quot;.
end defines the string used to close a comment. In C++ this would be & quot; */ quot;.
region skal være navnet på den foldelige kommentar på flere linjer. Antag at du har beginRegion=" Comment "... endRegion=" Comment" i dine regler, så skal du bruge region=" Comment ". På denne måde fungerer afkommentering også selvom du ikke markerer al tekst i en kommentar på flere linjer. Markøren skal blot være inde i multilinjekommentaren.
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.
Elementet folding i gruppen general definerer kodefoldningsegenskaber. Tilgængelige egenskaber er:
The element folding in the group general defines code folding properties. Available attributes are:
indentationsensitive hvis true tilføjes kodefoldningsmarkørerne baseret på indentering, ligesom i scriptsproget Python. Som regel behøver du ikke angive det, eftersom det har standardværdien 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.
Elementet indentation i gruppen general definerer hvilken identerer som skal bruges, selvom vi stærkt anbefaler at udelade elementet, eftersom intentereren oftest angives ved at definere en filtype eller ved at tilføje tilstandslinjer i tekstfilen. Hvis du alligevel angiver en indenterer, tvinger du brugeren til at bruge en specifik indentering, hvilket måske ikke værdsættes over hovedet. Tilgængelige egenskaber er:
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 er navnet på indentereren. Indenterere som for øjeblikket er tilgængelige er: normal, cstyle, csands, xml, python og varindent.
mode is the name of the indenter. Available indenters right now are: normal, cstyle, csands, xml, python and varindent.
Tilgængelige standardstiler
Available Default Styles
Standardstiler er allerede forklaret. En kort sammenfatning: Standardstiler er fordefinerede stiler for skrifttype og farver.
Default Styles were already explained, as a short summary: Default styles are predefined font and color styles.
Så her er altså blot listen med tilgængelige standardstiler:
So here only the list of available default styles:
dsNormal, bruges til normal tekst.
dsNormal, used for normal text.
dsKeyword, bruges til nøgleord.
dsKeyword, used for keywords.
dsDataType, bruges til datatyper.
dsDataType, used for data types.
dsDecVal, bruges til decimale værdier.
dsDecVal, used for decimal values.
dsBaseN, bruges til værdier med en basis andet end 10.
dsBaseN, used for values with a base other than 10.
dsFloat, bruges til decimaltal.
dsFloat, used for float values.
dsChar, bruges til et tegn.
dsChar, used for a character.
dsString, bruges til strenge.
dsString, used for strings.
dsComment, bruges til kommentarer.
dsComment, used for comments.
dsOthers, bruges til 'andre' ting.
dsOthers, used for'other 'things.
dsAlert, bruges til advarselsmeddelelser.
dsAlert, used for warning messages.
dsFunction, bruges til funktionskald.
dsFunction, used for function calls.
dsRegionMarker, bruges til områdesmarkeringer.
dsRegionMarker, used for region markers.
dsError, bruges til fremhævning af fejl og forkert syntaks.
dsError, used for error highlighting and wrong syntax.
Hver regel kan matche nul eller flere tegn i begyndelsen af strengen de bliver bedt om at teste imod. Hvis reglen matcher, bliver de matchende tegn tilknyttet stilen eller attributten defineret af reglen, og en regel vil måske spørge om den aktuelle sammenhæng er skiftet.
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.
& lt; RuleName attribute=quot; (identifier) quot; context=quot; (identifier) quot; [regelspecifikke attributter] / gt;
& lt; RuleName attribute=quot; (identifier)quot; context=quot; (identifier)quot; [rule specific attributes] / gt;