natgillin/translations-raw huggingface dataset:
& kate; does not (yet!) provide any means for reading document related documentation. Depending on the file you are editing, you may find the Built in Terminal Emulator helpful for viewing related & UNIX; manual pages or info documentation, or you can use & konqueror;.
& kate; tillhandahåller inte (ännu!) något sätt att läsa dokumentrelaterad dokumentation. Beroende på filen som du redigera, kan du märka att den inbyggda terminalen är användbar för att visa relaterade & UNIX; manualsidor, eller info- dokumentation, eller också så kan du använda & konqueror;.
Syntax Highlighting is what makes the editor automatically display text in different styles/ colors, depending on the function of the string in relation to the purpose of the file. In program source code for example, control statements may be rendered bold, while data types and comments get different colors from the rest of the text. This greatly enhances the readability of the text, and thus helps the author to be more efficient and productive.
Syntaxfärgläggning är det som gör att editorn automatiskt visar text med olika stilar/ färger, beroende på strängens funktion i relation till filens syfte. Till exempel i programkällkod, så kan kontrollsatser visas i fetstil, medan datatyper och kommentarer får annorlunda färg än resten av texten. Det här ökar textens läsbarhet väsentligt, och hjälper på så sätt författaren att vara effektivare och mer produktiv.
A Perl function, rendered with syntax highlighting.
En funktion i Perl, som visas med syntaxfärgläggning.
The same Perl function, without highlighting.
Samma kod utan syntaxfärgläggning.
& kate; comes with a flexible, configurable and capable system for doing syntax highlighting, and the standard distribution provides definitions for a wide range of programming, scripting and markup languages and other text file formats. In addition you can provide your own definitions in simple & XML; files.
& kate; levereras med ett flexibelt, anpassningsbart och avancerat system för att göra syntaxfärgläggning, och standarddistributionen tillhandahåller definitioner för ett brett område av programspråk, formaterings - och skriptspråk samt andra textfilformat. Dessutom kan du tillhandahålla dina egna definitioner med enkla & XML; - filer.
The styles and colors used by each syntax highlight definition can be configured using the Highlighting Text Styles tab of the Config Dialog, while the & MIME; Types it should be used for, are handled by the Modes & Filetypes tab.
Stilarna och färgerna som används av varje syntaxfärgläggningsläge kan anpassas under fliken Färgläggnińgstextstilar i inställningsdialogrutan, medan & MIME; - typerna det ska användas för hanteras under fliken Lägen och filtyper.
You can download updated or additional syntax highlight definitions from the & kate; website by clicking the Download Highlighting Files... button in the Modes & Filetypes tab of the Config Dialog.
Du kan ladda ner uppdaterade eller nya definitioner av syntaxfärgläggning från & kate; s webbplats genom att klicka på knappen Ladda ner färgläggningsfiler... på fliken Lägen och filtyper i inställningsdialogrutan.
This section will discuss the & kate; syntax highlighting mechanism in more detail. It is for you if you want to know about it, or if you want to change or create syntax definitions.
Det här avsnittet beskriver & kate; s syntaxfärgläggningsmekanism i mer detalj. Det är avsett för dig, om du vill veta mer om den, eller om du vill skapa och ändra syntaxdefinitioner.
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.
Så fort du öppnar en fil, är en av de första sakerna som & kate; - editorn gör att avgöra vilken syntaxdefinition som ska användas för filen. När filens text läses in, och medan du skriver i den, så analyserar syntaxfärgläggningssystemet texten enligt reglerna som definieras i syntaxdefinitionen och markerar var i den som olika sammanhang och stilar börjar och slutar.
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.
När du skriver in text i dokumentet, så analyseras och markeras den nya texten i farten, så att om du tar bort ett tecken som markeras som början eller slutet på ett sammanhang, så ändras stilen på den omgivande texten i enlighet med detta.
The syntax definitions used by the & kate; Syntax Highlighting System are & XML; files, containing
Syntaxdefinitioner som används av & kate; s syntaxfärgläggningssystem är & XML; - filer, som innehåller
Rules for detecting the role of text, organized into context blocks
Regler för att detektera funktionen hos text, organiserade i sammanhangsblock
Keyword lists
Listor med nyckelord
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.
När texten analyseras utvärderas detekteringsreglerna i den ordning som de definierades, och om början på den nuvarande strängen matchar en regel, så används motsvarande sammanhang. Startpunkten i texten flyttas till den sista punkten där regeln matchade, och en ny genomgång av reglerna sker, med början i sammanhanget som anges av den matchande regeln.
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.
Detekteringsreglerna är centrala för färgläggningsdetekteringssystemet. En regel är en sträng, ett tecken eller ett reguljärt uttryck som texten som ska analyseras matchas mot. Den innehåller information om vilken stil som ska användas för den delen av texten som matchar. Den kan byta arbetssammanhanget för systemet, antingen till ett sammanhang som anges explicit, eller till det föregående sammanhanget som användes av texten.
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.
Reglerna organiseras i sammanhangsgrupper. En sammanhangsgrupp används för de huvudsakliga koncepten i formatets text, till exempel textsträngar inom citationstecken eller kommentarblock i programkällkod. Det här försäkrar att färgläggningssystemet inte behöver gå igenom alla regler när det inte är nödvändigt, och att vissa teckensekvenser i texten kan hanteras annorlunda beroende på det nuvarande sammanhanget.
Contexts may be generated dynamically to allow the usage of instance specific data in rules.
Sammanhang kan skapas dynamiskt för att till exempel tillåta användning av instansspecifik data i regler.
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.
I många format finns det en lista på ord som representerar ett speciellt koncept. Till exempel i programspråk, så är kontrollsatserna ett koncept, namn på datatyper ett annat, och inbyggda funktioner i språket ett tredje. & kate; s syntaxfärgläggningssystem kan använda sådana listor för att detektera och markera ord i texten för att visa koncepten för textformaten.
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.
Om du öppnar en C++ källkodsfil, en Java källkodsfil och ett HTML- dokument i & kate;, så ser du att även om formaten är olika, och olika ord därför väljs för särskild behandling, så är färgerna som används samma. Det här beror på att & kate; har en fördefinierad lista med standardstilar, som används av varje individuell syntaxdefinition.
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.
Det här gör det lätt att känna igen liknande koncept i olika textformat. Kommentarer finns till exempel i nästa alla program -, skript - eller formateringsspråk, och när de visas med samma stil i alla språk, behöver du inte stanna och tänka efter för att identifiera dem i texten.
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.
Alla stilar i en syntaxdefinition använder en av standardstilarna. Några få syntaxdefinitioner använder fler stilar än det finns som standard, så om du ofta använder ett format, kan det vara värt att titta i inställningsdialogrutan för att se om några koncept använder samma stil. Det finns till exempel bara en standardstil för strängar, men eftersom programspråket Perl hanterar två sorters strängar, kan du utöka färgläggningen genom att ställa in dessa så att de skiljer sig något. Alla tillgängliga standardstilar förklaras senare.
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.
Det här avsnittet är en översikt av färgläggningsdefinitionernas & XML; - format. Det beskriver huvudkomponenterna och deras betydelse och användning, och går djupare in i detaljerna för detekteringsreglerna.
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.
Den formella definitionen, också kallad en DTD, lagras i filen language. dtd som ska finnas installerad på ditt system i katalogen $KDEDIR / share/ apps/ kate/ syntax.
Main sections of & kate; Highlight Definition files
Huvudkomponenter i & kate; s färgläggningsdefinitioner
A highlighting file contains a header that sets the XML version and the doctype:
En syntaxfärgläggningsfil innehåller ett huvud som anger XML- versionen och dokumenttypen:
The root of the definition file is the element language. Available attributes are:
Definitionsfilens rot är elementet language. Följande egenskaper är tillgängliga:
Required attributes:
Egenskaper som krävs:
name sets the name of the language. It appears in the menus and dialogs afterwards.
name anger språkets namn. Det visas senare i menyer och dialogrutor.
section specifies the category.
section anger kategorin.
extensions defines file extensions, like & quot; *. cpp; *. hquot;
extensions definierar filändelser, som & quot; *. cpp; *. hquot;.
Optional attributes:
Valfria egenskaper:
mimetype associates files & MIME; Type based.
mimetype kopplar filer baserat på & MIME; - typ.
version specifies the current version of the definition file.
version anger definitionsfilens aktuella version.
kateversion specifies the latest supported & kate; version.
kateversion anger senaste version av & kate; som stöds.
casesensitive defines, whether the keywords are case sensitive or not.
casesensitive definierar om nyckelord är skiftlägeskänsliga eller inte.
priority is necessary if another highlight definition file uses the same extensions. The higher priority will win.
priority krävs om en annan syntaxfärgläggningsfil använder samma filändelse. Den högsta prioriteten vinner.
author contains the name of the author and his email-address.
author innehåller författarens namn och e- postadress.
license contains the license, usually LGPL, Artistic, GPL and others.
license innehåller licensen, oftast LGPL, Artistic, GPL och andra.
hidden defines, whether the name should appear in & kate; 's menus.
hidden definierar om namnet ska visas i & kate; s menyer.
So the next line may look like this:
Nästa rad kan alltså se ut så här:
Next comes the highlighting element, which contains the optional element list and the required elements contexts and itemDatas.
Därefter kommer elementet highlighting som innehåller det valfria elementet list och det nödvändiga elementen contexts och 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.
list element innehåller en lista med nyckelord. I det här fallet är nyckelorden class och const. Du kan lägga till så många listor som du behöver.
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.
Elementet contexts innehåller alla sammanhang. Det första sammanhanget är förvalt som start för färgläggningen. Det finns två regler i sammanhanget Normal Text som matchar listan av nyckelord med namnet något- namn och en regel som detekterar ett citationstecken och byter sammanhang till string. För att lära dig mer om regler, läs nästa kapitel.
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.
Den tredje delen är elementet itemDatas. Det innehåller alla färger och teckenstilar som behövs av sammanhangen och reglerna. I det här exemplet används itemData Normal Text, String och Keyword.
& 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; något- namnquot; 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; något- namnquot; / 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;
The last part of a highlight definition is the optional general section. It may contain information about keywords, code folding, comments and indentation.
Den sista delen av färgläggningsdefinitionen är den valfria sektionen general. Den kan innehålla information om nyckelord, kodvikning, kommentarer och indentering.
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.
Sektionen comment definierar den sträng som enradskommentarer inleds med. Du kan också definiera flerradskommentarer med multiLine och den ytterligare egenskapen end. Det är användbart när användaren trycker på snabbtangenten som motsvarar kommentera/ avkommentera.
The keywords section defines whether keyword lists are casesensitive or not. Other attributes will be explained later.
Sektionen keywords definierar om listor med nyckelord är skiftlägeskänsliga eller inte. Andra egenskaper förklaras senare.
The Sections in Detail
Sektionerna i detalj
This part will describe all available attributes for contexts, itemDatas, keywords, comments, code folding and indentation.
Den här delen beskriver alla tillgängliga egenskaper för sammanhang, itemData, nyckelord, kommentarer, kodvikning och indentering.
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:
Elementet context hör till gruppen contexts. Själva sammanhanget definierar sammanhangsspecifika regler, som vad som ska ske om färgläggningssystemet når slutet på en rad. Tillgängliga egenskaper är:
name the context name. Rules will use this name to specify the context to switch to if the rule matches.
name är sammanhangets namn. Regler använder namnet för att ange sammanhanget att byta till om regeln matchar.
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 definierar sammanhanget som färgläggningssystemet byter till om det når ett radslut. Det kan antingen vara namnet på ett annat sammanhang, # stay för att inte byta sammanhang (dvs. göra ingenting) eller # pop som gör att sammanhanget lämnas. Det är till exempel möjligt att använda # pop# pop# pop för att återgå tre steg.
lineBeginContext defines the context if a begin of a line is encountered. Default: #stay.
lineBeginContext definierar sammanhanget om början på en rad påträffas. Förval: # stay.
fallthrough defines if the highlight system switches to the context specified in fallthroughContext if no rule matches. Default: false.
fallthrough definierar om färgläggningssystemet byter till sammanhanget som anges i fallthroughContext om ingen regel matchar. Förval: false.
fallthroughContext specifies the next context if no rule matches.
fallthroughContext anger nästa sammanhang om ingen regel matchar.
dynamic if true, the context remembers strings/ placeholders saved by dynamic rules. This is needed for HERE documents for example. Default: false.
dynamic om true kommer sammanhanget ihåg strängar/ platsmarkörer som sparats av dynamiska regler. Det behövs till exempel för HERE- dokument. Förval: 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:
Elementet itemData är i gruppen itemDatas. Det definierar teckenstilen och färgerna. Det är alltså möjligt att definiera egna stilar och färger, men vi rekommenderar dock att du håller dig till standardstilarna om möjligt, så att användaren alltid ser samma färger använda i olika språk. Ibland finns det dock inget annat sätt, och det är nödvändigt att ändra färg - och teckenegenskaper. Egenskapens namn och defStyleNum krävs, övriga är valfria. Tillgängliga egenskaper är:
name sets the name of the itemData. Contexts and rules will use this name in their attribute attribute to reference an itemData.
name anger namnet på itemData. Sammanhang och regler använder namnet i egenskapen attribute för att referera till itemData.
defStyleNum defines which default style to use. Available default styles are explained in detail later.
defStyleNum definierar vilken standardstil som ska användas. Tillgängliga standardstilar förklaras i detalj senare.
color defines a color. Valid formats are '#rrggbb 'or '#rgb'.
color definierar en färg. Giltiga format är '# rrggbb' eller '# rgb'.
selColor defines the selection color.
selColor definierar markeringens färg.
italic if true, the text will be italic.
italic om true, är texten kursiv.
bold if true, the text will be bold.
bold om true, är texten i fetstil.
underline if true, the text will be underlined.
underline om true, är texten understruken.
strikeout if true, the text will be stroked out.
strikeout om true, är texten överstruken.
The element keywords in the group general defines keyword properties. Available attributes are:
Elementet keywords i gruppen general definierar nyckelordens egenskaper. Tillgängliga egenskaper är:
casesensitive may be true or false. If true, all keywords are matched casesensitive
casesensitive kan vara true eller false. Om det är true, matchas alla nyckelord skiftlägeskänsligt.
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 är en lista med tecken som inte fungerar som ordavgränsare. Punkt '.' är till exempel en ordavgränsare. Med antagandet att ett nyckelord i en list innehåller en punkt, matchar det bara om du anger att punkten är en svag avgränsare.
additionalDeliminator defines additional delimiters.
additionalDeliminator definierar ytterligare avgränsare.
wordWrapDeliminator defines characters after which a line wrap may occur.
wordWrapDeliminator definierar tecken som en radbrytning kan ske efter.
Default delimiters and word wrap delimiters are the characters. ():! +, -lt; =gt; %amp; */;? []^{_BAR_}~\\, space ('') and tabulator ('\\t ').
Standardavgränsare och radbrytningsavgränsare är tecknen. ():! +, - lt; =gt;% amp; * /;? [] ^{ _BAR_} ~\\, mellanslag ('') och tabulator ('\\ t').
The element comment in the group comments defines comment properties which are used for Tools Comment and Tools Uncomment. Available attributes are:
Elementet comment i gruppen comments definierar kommentaregenskaper som används för Verktyg Kommentera och Verktyg Avkommentera. Tillgängliga egenskaper är: