<appendix id="highlight">
<appendixinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
&erik.kjaer.pedersen.role; 
</authorgroup>
</appendixinfo>
<title
>Arbejde med Fremhævning</title>

<sect1 id="highlight-overview">

<title
>Overblik</title>

<para
>Syntaksfremhævning er det der får en editor til automatisk at vise tekst i forskellig stil/farve, afhængig af funktionen for strengen  i relation til filens formål. I kildekode til et program for eksempel, kan kontroludsagn blive vist som fede, mens datatyper og kommentarer får forskellige farver fra resten af teksten. Dette gør det meget nemmere at læse teksten, og hjælper således forfatteren med at være mere effektiv og produktiv.</para>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="highlighted.png"/></imageobject>
<textobject
><phrase
>En perl-funktion, vist med syntaksfremhævning.</phrase
></textobject>
<caption
><para
>En perl-funktion, vist med syntaksfremhævning.</para>
</caption>
</mediaobject>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject>
<textobject
><phrase
>Den samme perl-funktion, uden fremhævning.</phrase
></textobject>
<caption
><para
>Den samme perl-funktion, uden fremhævning.</para
></caption>
</mediaobject>

<para
>Af de to eksempler, hvilket er nemmest at læse?</para>

<para
>&kate; kommer med et fleksibelt, indstilleligt og brugbart system til at lave syntaksfremhævning, og standarddistributionen giver definitioner for et vidt omfang af programmeringssprog, opmarkerings og script-sprog og andre tekstfil-formater. Derudover kan du give dine egne definitions i simple &XML;-filer.</para>

<para
>&kate; vil detektere de rigtige syntaksregler automatisk når du åbner en fil, baseret på filens &MIME;-type, bestemt ved dens endelse, eller, hvis den ingen har, indholdet. Skulle du komme ud for et dårligt valg, kan du sætte syntaksen der skal bruges manuelt fra <menuchoice
><guimenu
>Dokumenter</guimenu
><guisubmenu
>Fremhævningstilstand</guisubmenu
></menuchoice
>-menuen.</para>

<para
>Stil og farver brugt af hver syntaksfremhævnings-definition, så vel som hvilke &MIME;-typer de skal bruges på, kan indstilles ved brug af <link linkend="config-dialog-editor-hl"
> Fremhæv</link
>-siden i <link linkend="config-dialog"
>Config-dialogen</link
>.</para>

<note>
<para
>Syntaksfremhævning er der for at gøre det nemmer at læse rigtig tekst, men du kan ikke stole på at det vil være en godkendelse af din tekst. Markering af tekst for syntaks er vanskeligt og afhængigt af det format du bruger, og i visse tilfælde vil forfatterne af syntaksreglerne være stolte hvis 98% af teksten blive vist rigtigt, selvom du for det meste skal bruge en sjælden stil for at se de ukorrekte 2%.</para>
</note>

<tip>
<para
>Du kan nedtage opdaterede eller ekstra syntaksfremhævningsdefinitioner fra &kate;'s netside ved at klikke på <guibutton
>Nedtag</guibutton
>-knappen i <link linkend="config-dialog-editor-hl"
>Fremhæv siden</link
> for <link linkend="config-dialog"
>Config-dialogen</link
>.</para>
</tip>

</sect1>

<sect1 id="katehighlight-system">

<title
>&kate;'s syntaksfremhævning-system</title>

<para
>dette afsnit vil diskutere &kate;'s syntaksfremhævning-mekanismen i større detalje. Det er beregnet på dig, hvis du gerne vil kende til det, eller hvis du ønsker at ændre eller lave syntaksdefinitioner.</para>

<sect2 id="katehighlight-howitworks">

<title
>Hvordan virker det</title>

<para
>Når du åbner en fil er en af de første ting som &kate;-editoren gør at detektere hvilke syntaksdefinitioner der skal bruges for filen. Mens filens tekst læses, og mens du skriver i den, vil syntaksfremhævningssystemet analysere teksten ved brug af de regler der er defineret af syntaksdefinitioner og markere i filen hvor forskellige sammenhænge og stiler begynder og slutter.</para>

<para
>Når du skriver i dokumentet, bliver den nye tekst analyseret og markeret langs af sted, så hvis du sletter et tegn der er markeret som begyndelsen eller slutningen af en sammenhæng, vil stilen for den omgivende tekst ændret tilsvarende.</para>

<para
>De syntaksdefinitioner der bruges af &kate;'s syntaksfremhævningssystem er &XML;-filer der indeholder <itemizedlist>
<listitem
><para
>Regler til at detektere tekstens rolle, organiseret i sammenhængsblokke</para
></listitem>
<listitem
><para
>Nøgleordslister</para
></listitem>
<listitem
><para
>Stilpunkt-definitioner</para
></listitem>
</itemizedlist>
</para>

<para
>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.</para>

</sect2>

<sect2 id="highlight-system-rules">
<title
>Regler</title>

<para
>Detektionsreglerne er hjertet af fremhævnings-detektionssystemet. En regel er en streng, et tegn eller et <link linkend="regular-expressions"
>regulært udtryk</link
> 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.</para>

<para
>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. </para>

</sect2>

<sect2 id="highlight-context-styles-keywords">
<title
>Sammenhængsstil og nøgleord</title>

<para
>I visse programmeringssprog, bliver heltal behandlet anderledes end decimaltal af compileren (det program der konverterer kildekode til en binær kørbar), og der kan være tegn der har en speciel betydning indenfor en citeret streng. I sådanne tilfælde, giver det mening at vise dem anderledes end omgivelserne, så de er nemme at identificere mens man læser teksten. Så selvom de ikke repræsenterer specielle sammenhænge, kan de ses som sådan af syntaksfremhævningssystemet, så de kan markeres til en anderledes fremvisning.</para>

<para
>En syntaksdefinition kan indeholde så mange stile som krævet for at dække begreberne for det format den bruges til.</para>

<para
>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.</para>

</sect2>

<sect2 id="kate-highlight-system-default-styles">
<title
>Standardstil</title>

<para
>Hvis du åbner en  C++ kildefil, en &Java; kildefil og et <acronym
>HTML</acronym
>-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.</para>

<para
>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.</para>

<tip>
<para
>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.</para>
</tip>

</sect2>

</sect1>

<sect1 id="katehighlight-xml-format">
<title
>Fremhævningsdefinitionen &XML;-format</title>

<sect2>
<title
>Overblik</title>

<para
>Dette afsnit er et overblik over fremhævningsdefinitionen &XML;-format. Det vil beskrive hovedkomponenterne og deres betydning og brug, og gå i detalje med detektionsreglerne.</para>

<para
>Den formelle definition, også kendt som <acronym
>DTD</acronym
> gemmes i filen <filename
>language.dtd</filename
> som skal være installeret på dit system i mappen <filename
>$<envar
>KDEDIR</envar
>/share/apps/kate/syntax</filename
>.</para>

<variablelist>
<title
>Hovedkomponenter i &kate;'s fremhævningsdefinitioner</title>

<varlistentry>
<term
>Det generelle afsnit</term>
<listitem>
<para
>Det generelle afsnit indeholder information om kommentarformatet for det beskrevne sprog, og definerer om nøgleord er versalfølsomme.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
>Fremhævning</term>
<listitem>
<para
>Fremhævningsafsnittet indeholder alle data der kræves for at analysere og vise teksten. Dette inkluderer:</para>

<variablelist>
<varlistentry>
<term
>Punktdata</term>
<listitem
><para
>Indeholder punktdata-elementer, hver definerer en stil.</para
></listitem
> 
</varlistentry>

<varlistentry>
<term
>Nøgleordslister</term>
<listitem>
<para
>Hver liste har et navn, og kan indeholde et vilkårligt antal punkter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Sammenhænge</term>
<listitem>
<para
>Indeholder sammenhænge, som igen indeholder syntaksdetektionsregler.</para>
</listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-highlight-rules-detailled">
<title
>Fremhævningsdetektionsregler</title>

<para
>Dette afsnit beskriver syntaksdetektionsregler.</para>

<para
>Hver regel kan matche nul eller flere tegn i begyndelsen af strengen de bliver bedt om at teste. Hvis reglen matcher, bliver de matchende tegn tilknyttet stilen eller <emphasis
>attributten</emphasis
> defineret af reglen, og en regel vil måske spørge om den aktuelle sammenhæng er skiftet.</para>

<para
><emphasis
>Attributten</emphasis
> og <emphasis
>sammenhængs</emphasis
> attributterne er fælles for alle regler.</para>

<para
>En regel ser sådan her ud:</para>

<programlisting
>&lt;RuleName attribute=&quot;(identifier)&quot; context=&quot;(identifier|order)&quot; [regelspecifikke attributter] /&gt;</programlisting>

<para
><emphasis
>Attributten</emphasis
> identificerer den stil der skal bruges til matchede tegn ved navn eller indeks, og <emphasis
>sammenhængen</emphasis
> identificerer sammenhængen der skal bruges fra nu af.</para>

<para
><emphasis
>Attributten</emphasis
> kan identificeres enten ved navn, eller ved sit nul-baserede indeks i ItemDatas-grupperne.</para>

<para
><emphasis
>Sammenhængen</emphasis
> kan identificeres ved:</para>

<itemizedlist>
<listitem>
<para
>En <emphasis
>identifikator</emphasis
>, for øjeblikket kun dens nul-baserede indeks i sammenhængsgruppen.</para>
</listitem>
<listitem>
<para
>En <emphasis
>rækkefølge</emphasis
> der fortæller maskinen at den skal forblive i den aktuelle sammenhæng (<userinput
>#stay</userinput
>), eller poppe tilbage til en tidligere sammenhæng brugt i strengen (<userinput
>#pop</userinput
>).</para
> 
<para
>For at flere trin tilbage, kan #pop-nøgleordet gentages: <userinput
>#pop#pop#pop</userinput
></para
> 
</listitem>
</itemizedlist>

<para
>Nogle regler kan have <emphasis
>afledte regler</emphasis
> som så bliver evaluerede hvis og kun hvis den oprindelige regel matches. Hele den matchede streng vil blive givet attributten defineret af den oprindelige regel. En regel med afledte regler ser sådan her ud:</para>

<programlisting
>&lt;RuleName (attributes)&gt;
  &lt;ChildRuleName (attributes) /&gt;
  ...
&lt;/RuleName&gt;
</programlisting>


<para
>Regelspecifikke attributter varierer og beskrives i følgende liste.</para
> 

<variablelist>
<title
>Reglerne i detalje</title>

<varlistentry>
<term
>DetectChar</term>
<listitem>
<para
>Detekterer et enkelt tegn. Almindeligt brugt for eksempel til at finde slutningen af citerede strenge.</para
> 
<programlisting
>&lt;DetectChar char=&quot;(character)&quot; (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>char</userinput
>-attributten definerer tegnet der skal matches.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
>Detect2Chars</term>
<listitem>
<para
>Detekterer to specifikke tegn i en defineret rækkefølge.</para>
<programlisting
>&lt;Detect2Chars char=&quot;(character)&quot; char1=&quot;(character)&quot; (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>char</userinput
>-attributten definerer det første tegn der skal matches, <userinput
>char1</userinput
> det andet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>AnyChar</term>
<listitem>
<para
>Detekterer et tegn fra et bestemt sæt angivne tegn.</para>
<programlisting
>&lt;AnyChar String=&quot;(string)&quot; (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>Streng</userinput
>-attributten definerer sættet af tegn.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>StringDetect</term>
<listitem>
<para
>Detekterer en eksakt streng.</para>
<programlisting
>&lt;StringDetect String=&quot;(string)&quot; [insensitive=&quot;TRUE|FALSE;&quot;] (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>Streng</userinput
>-attributten definerer strengen der skal matches. <userinput
>insensitive</userinput
>-attributten er som standard <userinput
>FALSE</userinput
> og fødes til strengsammenligningsfunktionen. Hvis værdien er <userinput
>TRUE</userinput
> bruges insensitive sammenligning.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
>RegExpr</term>
<listitem>
<para
>Matcher mod et regulært udtryk.</para>
<programlisting
>&lt;RegExpr String=&quot;(string)&quot; [insensitive=&quot;TRUE|FALSE;&quot;] [minimal=&quot;TRUE|FALSE&quot;] (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>Streng</userinput
>-attributten definerer det regulære udtryk.</para>
<para
><userinput
>insensitive</userinput
> er som standard <userinput
>FALSE</userinput
> og fødes til den regulære udtryk maskine.</para>
<para
><userinput
>minimal</userinput
> er som standard <userinput
>FALSE</userinput
> og fødes til den regulære udtryk maskine.</para>
<para
>Fordi reglerne altid matches imod begyndelsen af den aktuelle streng, vil et regulært udtryk der starter med en karet (<literal
>^</literal
>) indikere at reglen kun skal matches mod begyndelsen af en linje.</para>
<para
>Se <link linkend="regular-expressions"
>Regulære udtryk</link
> for yderligere oplysninger om disse.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
>Nøgleord</term>
<listitem>
<para
>Detektér et nøgleord fra en bestemt liste.</para>
<programlisting
>&lt;keyword String=&quot;(list name)&quot; (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>String</userinput
>-attributten identificerer nøgleordslisten ved navn. En liste med dette navn skal eksistere.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Int</term>
<listitem>
<para
>Detektér et heltal.</para>
<para
><programlisting
>&lt;Int (almindelige attributter) /&gt;</programlisting
></para>
<para
>Denne regel har ingen specifikke attributter. Afledte regler bruges typisk til at detektere kombinationer af <userinput
>L</userinput
> og <userinput
>U</userinput
> efter tallet, indikerende heltalstypen i programkode.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Decimaltal</term>
<listitem>
<para
>Detektér et decimaltal.</para>
<para
><programlisting
>&lt;Float (almindelige attributter)
/&gt;</programlisting
></para
> 
<para
>Denne regel har ingen specifikke attributter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>HlCOct</term>
<listitem>
<para
>Detektér en oktal pointnummer repræsentation.</para>
<para
><programlisting
>&lt;HlCOct (almindelige attributter) /&gt;</programlisting
></para>
<para
>Denne regel har ingen specifikke attributter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>HlCHex</term>
<listitem>
<para
>Detektér en hexadecimal nummerrepræsentation.</para>
<para
><programlisting
>&lt;Int (almindelige attributter) /&gt;</programlisting
></para>
<para
>Denne regel har ingen specifikke attributter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>HlCStringChar</term>
<listitem>
<para
>Detektér et escape-tegn.</para>
<para
><programlisting
>&lt;HlCStringChar (almindelige attributter)
/&gt;</programlisting
></para>
<para
>Denne regel har ingen specifikke attributter.</para>

<para
>Den matcher bogstavelige repræsentationer af usynlige tegn som er almindeligt brugte i programkode, for eksempel <userinput
>\n</userinput
> (nylinje) eller <userinput
>\t</userinput
> (TAB).</para>

<para
>Følgende tegn vil matche hvis de følger efter en baglæns skråstreg (<literal
>\</literal
>): <userinput
>abefnrtv&quot;'?</userinput
>. Derudover vil escape-hexadecimale tal som for eksempel <userinput
>\xff</userinput
> og escape-oktale tal, for eksempel <userinput
>\033</userinput
> matche.</para>

</listitem>
</varlistentry>

<varlistentry>
<term
>RangeDetect</term>
<listitem>
<para
>Detekterer en streng med defineret start- sluttegn.</para>
<programlisting
>&lt;RangeDetect char=&quot;(character)&quot;  char1=&quot;(character)&quot; (almindelige attributter) /&gt;</programlisting>
<para
><userinput
>char</userinput
> definerer tegnet der starter området, <userinput
>char2</userinput
> tegnet der afslutter området.</para>
<para
>Nyttigt til at detektere for eksempel små citerede strenge og den slags, men bemærk at fordi hl-maskinen virker på én linje af gangen, vil den ikke finde strenge der går udover et linjebrud.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>LineContinue</term>
<listitem>
<para
>Matcher slutningen af linjen.</para>
<programlisting
>&lt;LineContinue (almindelige attributter) /&gt;</programlisting>
<para
>Denne regel har ingen specifikke attributter.</para>
<para
>Denne regel er nyttig til at skifte sammenhæng for enden af en linje.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

</appendix>
