&Anders.Lund; &Anders.Lund.mail;
Johan
Thelmén

    jth@home.se

Översättare

# Arbeta med insticksprogram

Kate använder två olika typer av insticksprogram, nämligen insticksprogram för programmet &kate; och insticksprogram för &kate;s editorkomponent. De senare är tillgängliga för alla program som använder editorkomponenten, som KDevelop, Quanta, Kile, Kwrite och många andra, medan insticksprogram för programmet är specifika för programmet &kate;.

Du kan aktivera båda typer av insticksprogram i inställningsdialogrutan, som också ger tillgång till ytterligare inställningsalternativ för insticksprogram som kräver det.

Det finns många insticksprogram för olika syften tillgängliga, och du kan söka efter fler på webben. Ett fåtal insticksprogram levereras med editorkomponenten, för att automatiskt infoga parenteser, infoga filer och exportera text som &HTML;.

## Insticksprogram för programmet &kate;

&kate; insticksprogram är ytterligare funktioner för editorn &kate;. De kan lägga till extra menyer och snabbtangenter, och utöka &kate;s funktioner. Du kan installera så många eller så få du vill, inne i &kate;. Öppna &kate;s inställningsdialogruta med Inställningar Anpassa &kate;... Använd Program Insticksprogram för att välja önskade insticksprogram.

De tillgängliga insticksprogrammen är:

- Bläddring i bakåtspårning: Navigeringsverktyg med vy av bakåtspårning

- Bygginsticksprogram: Kompilera eller bygg och tolka felmeddelanden

- Ctags-insticksprogram: Slå upp definitioner och deklarationer med Ctags

- Filsystembläddrare: Verktygsvy för filsystembläddring

- Filmallar: Skapa nya filer från mallar

- &gdb; - Tillhandahåller ett enkelt gränssnitt för &gdb;

- Jovie text-till-tal: Lägger till ett menyalternativ för att läsa upp texten

- E-posta filer: Skicka filer via e-post

- Flerraders flikrad: Lägger till en flikrad med flera rader i &kate;s huvudfönster

- Öppna deklarationsfil: Öppnar den motsvarande .h/[.cpp|.c]-filen

- Projektinsticksprogram: Projektinsticksprogram för Kate

- Python-insticksprogram: Pâté värddator för Python-insticksprogram

- Insticksprogram för sök och ersätt: Sök och ersätt mönster i alla öppna filer eller alla filer i en katalog

- Verktygsvy med kodsnuttar: Verktygsvy med inbäddad hantering av kodsnuttar

- SQL-insticksprogram - Utför en förfrågan i SQL-databaser

- Symbolvisning: Hämta och visa referenssymboler från källkod

- Flikrad: Lägger till en flikrad i &kate;s huvudfönster

- Verktygsvyn Terminal: Verktygsvy med en inbäddad grafisk terminalkomponent

- Textfilter: Enkel textfiltrering

- &XML;-validering: Validerar &XML;-filer med XMLlint

- &XML;-komplettering: Listar XML-element, attribut, attributvärden och objekt som tillåts av DTD

&plugins-part-sections;
&Anders.Lund; &Anders.Lund.mail;

## Filmallar

Insticksprogrammet Filmallar låter dig skapa filer baserade på andra filer.

När Kate först installeras, måste insticksprogrammet aktiveras.

1. Klicka på Inställningar Anpassa Kate

2. I trädet till vänster på skärmen, klicka på Insticksprogram.

3. Välj Filmallar i rutan Insticksprogramhanterare till höger, och klicka på Ok.

Du kan nu använda vilken fil som helst som mall (vilket skapar en kopia av filen med en tom webbadress). Särskilda mallfiler som kan innehålla makron för att fylla i information, som ditt namn och din e-postadress, dagens datum, och placera markören på en bekväm plats i den nya filen.

Du kan enkelt skapa en ny mall från ett öppet dokument.

Mallar som sparas i mallkatalogen listas i menyalternativet Arkiv Ny från mall.

Mallkatalogen är en del av &kde;:s filsystem, och innehåller åtminstone

- `$`KDEDIR`/share/applications/kate/plugins/katefiletemplates/templates`

- `$`KDEHOME`/share/applications/kate/plugins/katefiletemplates/templates.`

Om miljövariabeln `KDEDIRS` innehåller ytterligare kataloger, söks de dessutom igenom efter liknande underkataloger. Om mallar med samma namn hittas, väljes mallen i den lokala katalogen (KDEHOME).

### Menystruktur

Arkiv Ny från mall Vilken fil som helst...

  Visar en dialogruta för att öppna en fil, som låter dig välja vilken fil som helst som mall. Om den valda filen har filändelsen `katetemplate` tolkas den för att hitta mallinformation och makron.

Arkiv Ny från mall

  Återstoden av undermenyer innehåller länkar till mallar. Klicka på ett menyalternativ för att skapa en fil som beskrivs av menyalternativets text.

Inställningar Hantera mallar...

  Det här visar en dialogruta med en lista över mallar som hittas i mallkatalogerna, tillsammans med alternativ för att lägga till, redigera eller ta bort mallar.

### Använda en &kate;-mall

När en fil skapas från en mall som innehåller mallmakron, visas vissa makron som redigerbara variabler i texten. Sådana variabler visas som understrukna ord i texten.

Den första variabeln väljes, så du behöver bara skriva för att redigera den. Om dokumenttexten innehåller flera förekomster av samma variabel, ändras de medan du redigerar. För att gå till nästa redigerbara variabel, tryck på tabulatortangenten. När den sista variabeln redigeras, försvinner listan och tabulatortangenten fungerar som vanligt.

### Skapa dina egna mallar

Använd Inställningar Hantera mallar som startar mallhanteringsdialogrutan, för att skapa en ny mall. Klicka på Ny... i den för att starta Filmallsguiden. Du blir tillfrågad om en valfri fil att omvandla till en mall samt om mallinformationsinställningar, och en mallfil skapas åt dig.

Som ett alternativ kan du skapa mallen för hand genom att lägga till mallinformation längst upp i vilken fil som helst, lägga till text och makron, och spara den med filändelsen `katetemplate`.

Mallmenyn uppdateras automatiskt om du väljer att lagra din mall i mallkatalogen.

### Redigera mallar

Använd Inställningar Hantera mallar... för att redigera en mall. Markera mallen du vill arbeta med, och klicka på Redigera..., så öppnas mallfilen. Stäng dialogrutan, redigera mallfilen som önskas, spara och stäng den. Ändringar i mallen får omedelbart effekt, och du kan aktivera mallen för att prova dina ändringar efter du har sparat den.

### &kate;s mallformat

Om du använder filer med filändelsen `katetemplate`, tolkas de för att hitta mallinformation, makron och en markörposition.

#### Mallinformation

Medan filen läses in, behåller tolken rader som börjar med ordet `katetemplate:` och söker i dem efter mallinformation på formen VARIABELNAMN=VÄRDE. Den första raden som inte börjar med `katetemplate:` antas vara början på mallens innehåll. VÄRDE kan innehålla vilket tecken som helst utom likhetstecken (=). Riktiga variabelnamn är:

`Mall`

  Det här är mallens namn, som visas i menyn Arkiv Ny från mall.

`Group`

  Gruppen placerar mallen i en undermeny till menyn Arkiv Ny från mall.

`Name`

  Det här är namnet som dokumentet får, och som visas i fillistan och namnlisten. Om namnet innehåller `%n` ersätts det med ett nummer, som ökas om flera dokument har samma namn.

`Highlight`

  Insticksprogrammet försöker ställa in färgläggningen för det nya dokumentet till den här variabelns värde. Värdet ska vara namnet, som syns under Verktyg Färgläggning.

`Description`

  En kort informativ beskrivning av mallen. Den används för närvarande för att visa en Vad är det här-sträng för menyalternativet, men kan användas för fler syften i framtiden.

Author

  En sträng som identifierar upphovsmannen, till exempel på formen `Namn <e-postadress>`. Den används för närvarande för att visa en Vad är det här-sträng för menyalternativet, men kan användas för fler syften i framtiden.

#### Mallmakron

Medan mallens innehåll tolkas, expanderas makron på formen `%{NAMN}` eller `${NAMN}`. Om du använder prefixet `$`, behandlas det expanderade makrot som en redigerbar variabel när ett dokument skapas från mallen, medan om du använder `%` gör det inte det, om inte expansion misslyckades.

Följande makron expanderas:

`time`

  Expanderas till aktuell tid med format enligt landsinställningarna.

`date`

  Expanderas till dagens datum med kort format.

`datetime`

  Expanderas till aktuell tid och datum, formaterat som en sträng enligt landsinställningarna.

`year`

  Innevarande år som ett tal med fyra siffror.

`month`

  Fullständigt namn på innevarande månad, enligt dina landsinställningar.

`dag`

  Expanderas till dagen i innevarande månad.

`hostname`

  Expanderas till datorns värddatornamn.

`index`

  Expanderas till 'i'.

`fullname`

  Expanderas till ditt fullständiga namn, som det definieras av ägarens adress i den vanliga adressboken i &kde;.

`firstname`

  Expanderas till ditt förnamn, som det definieras av ägarens adress i den vanliga adressboken i &kde;.

`lastname`

  Expanderas till ditt efternamn, som det definieras av ägarens adress i den vanliga adressboken i &kde;.

email

  Expanderas till din e-postadress, som den definieras av ägarens adress i den vanliga adressboken i &kde;.

Ett makron som inte finns i listan ovan behandlas som en redigerbar variabel oberoende av prefix. Om samma variabel förekommer flera gånger i mallen, kan de redigeras omedelbart efter dokumentet skapats från mallen.

#### Ange markörens position

Det speciella makrot `${cursor}` ersätts med en vertikal rad och läggs till sist i listan med redigerbara variabler, oberoende av sin plats i texten.

### Tack och erkännanden

&kate;-insticksprogrammet Filmallar copyright 2004 &Anders.Lund; &Anders.Lund.mail;.

Dokumentation copyright 2004 &Anders.Lund;

&Daniel.Naber; &Daniel.Naber.mail;

## &XML;-validering

Det här insticksprogrammet kontrollerar att &XML;-filer är välformade och giltiga.

Det här insticksprogrammet kontrollerar nuvarande fil. En lista med varningar och fel visas längst ner i &kate;s huvudfönster. Du kan klicka på ett felmeddelande för att hoppa till motsvarande plats i filen. Om filen har en DOCTYPE, så används den DTD som anges av DOCTYPE för att kontrollera filens giltighet. Denna DTD förväntas finnas på en plats relativt den nuvarande filen, t.ex. om DOCTYPE refererar till DTD/xhtml1-transitional.dtd och filen heter `/home/peter/test.xml`, så förväntas denna DTD finnas under `/home/peter/DTD/xhtml1-transitional.dtd`. Dock så stöds också DTD:er som anges med HTTP.

Om filen inte har någon doctype, så kontrolleras att den är välformad.

För att ta reda på mer om &XML;, titta på de officiella W3C &XML;-sidorna.

Internt anropar insticksprogrammet det externa kommandot `xmllint`, som är en del av libxml2. Om det här programmet inte är riktigt installerat på systemet, fungerar inte insticksprogrammet.

En tillfällig fil måste skrivas i samma katalog där filen som ska kontrolleras finns, så du måste ha skrivrättigheter i denna katalog.

För att ladda insticksprogrammet, öppna först &kate;s inställningsdialogruta under Inställningar Anpassa &kate;... . Markera därefter XML-validering, som visas under Program Insticksprogram och stäng dialogrutan.

### Menystruktur

XML Validera XML

  Det här startar kontrollen, som beskrivs ovan.

### Tack och erkännanden

&kate;s insticksprogram XML-validering copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;.

Dokumentation copyright 2002 &Daniel.Naber;

&Daniel.Naber; &Daniel.Naber.mail;

## &XML;-komplettering

Det här insticksprogrammet ger tips om vad som är tillåtet på vissa ställen i en &XML;-fil, i enlighet med filens DTD. Det listar möjliga element, egenskaper, egenskapsvärden eller objekt, beroende på markörens plats (t.ex. så listas alla objekt om tecknet till vänster om markören är &). Det är också möjligt att avsluta den närmaste taggen till vänster som ännu ej avslutats.

En DTD på &XML;-format, som skapas av Perl-programmet `dtdparse` måste finnas. Den här sortens DTD:er kallas för meta-DTD:er. Vissa meta-DTD:er medföljer. De är installerade i `$KDEDIR/share/apps/katexmltools/`, som också är den förvalda katalogen när du väljer Tilldela meta-DTD.... För att skapa dina egna meta-DTD:er, hämta `dtdparse` från http://dtdparse.sourceforge.net.

### Användning

Starta &kate; och öppna inställningsdialogrutan med Inställningar Anpassa &kate;.... Markera därefter XML-komplettering, som visas i avsnittet Program Insticksprogram. Välj därefter XML Tilldela meta-DTD.... Om dokumentet inte innehåller någon DOCTYPE eller en okänd doctype, måste du välja en meta-DTD i filsystemet. Annars så laddas automatiskt den meta-DTD som hör ihop med det nuvarande dokumentets doctype.

Nu kan du använda insticksprogrammet medan du skriver in text:

< (mindre än tecken)

  Det här visar en lista med möjliga element om inte markören redan är inne i en tagg. Observera att du för närvarande inte kan använda det här för att infoga toppnivåelementet (t.ex. <html>).

</ (mindre än tecken + snedstreck)

  Att skriva in de här tecknen erbjuder att avsluta det aktuella elementet (det närmaste oavslutade till vänster om markören). Tryck på returtangenten för att acceptera förslaget. I motsats till menyalternativet Avsluta element, fungerar det här bara när en DTD har tilldelats.

" (citationstecken)

  Ett citationstecken visar en lista med möjliga attributvärden (om det finns några) när du är inne i en tagg.

(mellanslag)

  Den här tangenten visar en lista med möjliga egenskaper för det nuvarande elementet om du är inne i en tagg.

& (och-tecken)

  Den här tangenten visar en lista med namngivna objekt.

### Funktioner och begränsningar

Du kan prova alla funktioner och begränsningar genom att ladda `$KDEDIR/share/apps/katexmltools/testcases.xml` i &kate; och följa instruktionerna.

### Menystruktur

&Ctrl;Retur XML Infoga element...

  Det här visar en dialogrutan som låter dig infoga &XML;-element. Tecknen <, > och avslutande tagg infogas automatiskt. Om du har markerat text när menyalternativet utförs, omges den markerade texten av inledande och avslutande tagg. Dialogrutan erbjuder också komplettering av alla element som kan ha infogats på aktuell markörposition, om du har tilldelat en meta-DTD genom att använda Tilldela meta-DTD....

&Ctrl;< XML Avsluta element

  Det här söker i texten efter en tagg som ännu inte avslutats och avslutar den genom att sätta in motsvarande avslutningstagg. Sökningen börjar på markörens plats och går åt vänster. Om ingen tagg som inte har avslutats hittas, händer ingenting.

XML Tilldela meta-DTD...

  Det här talar om för insticksprogrammet vilken meta-DTD som ska användas för det nuvarande dokumentet. Observera att den här tilldelningen inte sparas. Du måste upprepa den när du startar &kate; nästa gång.

### Tack och erkännanden

&kate;s insticksprogram &XML;-validering copyright 2001, 2002 &Daniel.Naber; &Daniel.Naber.mail;.

KDE programvarusamling 4 version copyright 2010 Tomáš Trnka

Dokumentation copyright 2001,2002 &Daniel.Naber;

## Export

### Menystruktur

Arkiv Exportera som HTML...

  Exportera filen med &HTML;-format så att dokumentet kan visas som en webbsida.

Redigera Kopiera som HTML...

  Kopierar markerad text med syntaxfärgläggningen som HTML-text.

&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Sök och ersätt

### Inledning

&kappname;s insticksprogram Sök i filer låter dig söka efter text eller reguljära uttryck i många olika filer på en gång. Du kan söka i alla öppna filer, eller i alla filer i en katalog och valfritt i dess underkataloger. Du kan till och med filtrera enligt filnamn, exempelvis för att bara söka i filer som slutar med en viss filändelse.

### Gränssnitt

#### Sökbegrepp

Följande alternativ visas alltid längst upp i verktygsvyn Sök i filer:

Ny flik

  Du kan ha så många sökningar som du vill igång samtidigt. Klicka helt enkelt på knappen Ny flik längst upp till vänster i sökverktygets vy, så öppnas en ny resultatflik som låter dig utföra en ny sökning.

Fråga

  Den långa textrutan längst upp är stället där du skriver in vad du vill söka efter. Du kan skriva in vanlig text, eller ett reguljärt uttryck om det är aktiverat.

Sök

  När du är klar med att ställa in allting, klicka bara på knappen Sök för att utföra sökningen. Du kan också trycka på returtangenten i frågerutan för att åstadkomma samma sak.

Plats

  Det här har två alternativ. Välj i öppna filer för att söka i alla filer som för närvarande är öppna i &kappname;. Välj i katalog för att söka inne i en katalog och valfritt i dess underkataloger.

Alternativ

  Det finns två tillgängliga alternativ. Om aktiverat, begränsar Matcha skiftläge sökresultaten till bara de som har exakt samma kombination av stora och små bokstäver som sökbegreppet. Reguljärt uttryck låter dig använda reguljära uttryck istället för vanlig text som sökbegrepp.

Växla resultat

  Neråtpilen i övre högra hörnet av verkygsvyn Sök i filer växlar nedre halvan av verktygsvyn mellan att visa ytterligare alternativ för katalogsökläget och resultatet av sökningarna.

#### Alternativ för sök i katalog

Alternativen visas under de tidigare nämnda sökalternativen. Om sökresultaten visas istället, klicka på knappen Växla resultat för att visa dem. Alternativen gäller bara när katalogsökläget är aktiverat. Om sökning i öppna filer är valt, är de inaktiverade.

Katalog

  Du kan skriva in sökvägen för katalogen som du vill söka i. Du kan exempelvis skriva in `~/utveckling/kde/kate/` om du skulle vilja söka i &kate;s källkod.

Öppna fildialogruta

  Tryck på knappen för att bestämma katalogen med skrivbordets katalogbläddrare.

Upp

  Klicka på knappen för att ändra Katalog till den överliggande katalogen till katalogen som för närvarande är vald.

Återställ nuvarande katalog

  Den här knappen ändrar Katalog till den katalog där dokumentet som för närvarande är öppet finns.

Filter

  Det här låter dig enbart söka efter filnamn som motsvarar ett visst mönster. För att exempelvis bara söka efter filer som är skrivna i C++, ändra det till `*.cpp`. För att söka efter filer som börjar med `kate`, ändra det till `kate*`. Du kan skriva in flera filter åtskilda med kommatecken (`,`). För att använda det för att undanta filer från sökningen, lägg till ett minustecken (`-`) i listan.

Rekursiv

  Om alternativet är aktiverat, söker &kappname; också i alla underkataloger till den valda katalogen.

inkludera dolda

  Om alternativet är aktiverat, söker &kappname; också i filer eller kataloger som normalt är dolda av operativsystemet.

Följ symboliska länkar

  Insticksprogrammet Sök i filer, följer normalt inte symboliska länkar. När det här alternativet är aktiverat, följer insticksprogrammet dem och söker i filerna eller katalogerna de refererar till.

  Det är möjligt för symboliska länkar att referera till en katalog som är överliggande katalog till den katalog som för närvarande söks igenom, eller andra kataloger som innehåller symboliska länkar till sina överliggande kataloger. Om en sådan länk finns i en katalog som söks igenom och det här alternativet är aktiverat, kommer &kappname; följa länken upprepade gånger och söka igenom katalogen, och sökningen kommer aldrig att avslutas.

#### Sökresultat

Sökresultaten visas under sökalternativen. Om alternativen för Sök i katalog visas, klicka helt enkelt på knappen Växla resultat för att visa dem. De visas också automatiskt så fort en sökning utförs.

Sökresultaten visar tre kolumner som tillhandahåller information om varje resultat av sökningen. Kolumnen Fil visar filnamnet. Kolumnen Rad visar radnumret sökningen hittades på. Kolumnen Text visar hela texten på den raden.

För att öppna filen som resultatet hittades i, dubbelklicka helt enkelt på den. &kappname; öppnar filen om det behövs, och placerar markören i början av texten i sökbegreppet som hittades i filen.

### Menystruktur

Visa Verktygsvyer Visa Sök i filer

  Visar eller döljer &kate;s verktyg Sök i filer.

## E-posta filer

### Menystruktur

Arkiv Skicka e-post...

  Öppnar ditt e-postprogram och lägger till filen som bilaga i brevet.

## Filsystembläddrare

Filsystembläddraren är en katalogvy, som låter dig öppna filer i en katalog som visas i den nuvarande rutan.

### Menystruktur

Visa Verktygsvyer Visa Filsystembläddrare

  Visar eller döljer &kate;s filsystembläddrare

### Gränssnitt

Uppifrån och ner, består filsystembläddraren av följande delar:

En verktygsrad

  Den här innehåller vanliga navigationsknappar:

  Tillbaka

    Gör att katalogvyn byter till katalogen som tidigare visades i historiken med kommandot `cd`. Knappen är inaktiv om det inte finns någon tidigare katalog.

  Framåt

    Gör att katalogvyn byter till nästa katalog i historiken med kommandot `cd`. Knappen är inaktiv om det inte finns någon nästa katalog.

  Bokmärken

    Visar en undermeny för att redigera eller lägga till bokmärken, och för att lägga till en ny bokmärkeskatalog.

  Aktuell dokumentkatalog

    Den här knappen gör att katalogvyn byter till katalogen för det nuvarande aktiva dokumentet med kommandot `cd`, om möjligt. Knappen är inaktiv om det nuvarande dokumentet är en ny, osparad fil, eller om katalogen som den finns i inte kan bestämmas.

  Alternativ
    Kort format

      Visar bara filnamnen.

    Detaljerat format

      Visar filernas Namn, Datum, Storlek och Typ.

    Trädformat

      Som Kort format, men kataloger kan expanderas för att se deras innehåll.

    Detaljerat trädformat

      Det tillåter också att kataloger expanderas, men visar de ytterligare kolumnerna tillgängliga i Detaljerat format.

    Visa dolda filer

      Visar filer som normalt döljs av operativsystemet.

    Synkronisera automatiskt med aktuellt dokument

      När alternativet är aktiverat använder filsystembläddraren `cd` för att automatiskt gå till katalogen där dokumentet som för närvarande är öppet i redigeringsområdet finns, varje gång det ändras.

En platsangivelse

  Den visar en länkstig till katalogen som för närvarande är öppen, som i &dolphin;. Du kan klicka på vilken katalog som helst för att gå till den, eller klicka på någon av pilarna till vänster om en katalog för att välja vilken katalog som helst under den. Du kan också välja i listan med platser genom att klicka på ikonen längst till vänster i länkstigen, där en ikon visas som representerar nuvarande platser.

  Du kan också klicka till höger om länkstigen för att ändra den till en textruta, där du kan skriva in sökvägen till katalogen som ska visas. Inmatningsrutan behåller en lista med de senast inskrivna sökvägarna. För att välja en, använd pilknappen till höger om fältet.

  Inmatningsrutan har automatisk komplettering av kataloger. Kompletteringsmetoden kan anges via menyn som visas genom att klicka med höger musknapp på textfältet.

En katalogvy

  Det här är &kde;:s standardkatalogvy.

Ett filterfält

  Filterfältet låter dig skriva in ett filter för filerna som visas i katalogvyn. Filtret använder vanliga jokertecken, där mönster måste skiljas åt av blanktecken. Till exempel: `*.cpp *.h *.moc`.

  För att visa alla filer, skriv in en ensam asterisk `*`.

  Filterfältet sparar de senaste tio filtren mellan sessioner. För att använda ett, tryck på pilknappen till höger i fältet och välj önskad filtersträng. Filtret kan inaktiveras genom att klicka på knappen Rensa text till vänster om pilknappen för automatisk komplettering.

### Inställning

Insticksprogrammet kan anpassas på sidan Filsystembläddrare i &kate;s inställningsruta.

Verktygsrad

  Anpassa knapparna i filsystembläddrarens verktygsrad genom att flytta de du vill ha aktiverade till listan Markerade åtgärder, och ordna dem med pilknapparna vid sidan om listan.

Martin
Gergov
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Textsnuttar för Kate

### Inledning

Textsnuttar för Kate är ett insticksprogram som används för att spara tid åt dig genom att lägga till stöd för så kallade "textsnuttar" (återanvändbar källkod, maskinkod eller text). Insticksprogrammet har också stöd för kodkomplettering och QtScript.

### Menystruktur

Visa Verktygsvyer Visa Textsnuttar

  Visar en panel som innehåller alla textsnuttar i ditt arkiv som gäller för den aktuella filtypen.

### Textsnuttpanel

Textsnuttpanel för Kate
Textsnuttpanel för Kate.

Panelen för Kate textsnuttar.

Panelen ska visa en lista över textsnuttarkiv, tillsammans med alternativ för att skapa dina egna, hämta dem från internet, eller ladda dem från en lokal fil. Varje arkiv har en kryssruta som kan användas för att aktivera eller inaktivera det. Det finns också knappar för att redigera eller ta bort befintliga arkiv.

#### Ladda textsnuttarkivfiler

Du kan ladda ner textsnuttarkiv från internet. Klicka bara på Hämta nya textsnuttar, så visas ett fönster med en lista över textsnuttarkiv. När du har laddat ner den textsnutt du önskar, försäkra dig om att du har aktiverat den.

Du kan också ladda textsnuttarkiv från en lokal fil genom att använda filbläddraren längst ner i panelen. Klicka på Kopiera till arkiv när du är klar.

#### Skapa och redigera textsnuttar

Textsnutteditor
Textsnutteditorn.

Redigeringsgränssnittet för textsnuttar.

För att skapa ett nytt textsnuttarkiv, klicka på Ny textsnuttfil. Nu ska en dialogruta visas som frågar efter namnet på den nya textsnuttfilen, licens och upphovsman. Efter att du har gjort dina val, klicka på Skapa, så visas textsnutteditorn.

Textsnutteditorn innehåller följande alternativ:

Filtyp

  Välj filtypen eller filtyperna som du vill att textsnuttarkivet ska gälla. Det är normalt inställt till * så att arkivet gäller alla filer. Det kan exempelvis ändras till något som `C++`, eller väljas från en lista genom att klicka på Redigera. Du kan ange mer än en filtyp genom att skilja dem åt med `;`.

Upphovsmän

  Ange namnen på upphovsmännen till textsnuttfilen.

Textsnuttlista

  Innehåller alla textsnuttar som definieras i textsnuttfilen. Du kan helt enkelt klicka på en textsnutt som listas där för att redigera den.

Lägg till (+)

  Använt för att lägga till en ny textsnutt.

Ta bort (-)

  Använt för att ta bort en textsnutt.

Matchning eller namn

  Visas i listan över textsnuttar i verktygsvyn och söks också igenom när funktionen för textkomplettering används.

Visningsprefix, Visningssuffix och Visningsargument

  Används för att visa användbar information när kodkomplettering används. Prefix och postfix visas före och efter namnet, medan argumenten visas omedelbart efter namnet inom parenteser.

Textsnuttens innehåll

  Återanvändbar text eller kod. Detta är vad som syns i dokumentet när textsnutten används.

Under Textsnuttens innehåll kan du ange variabler med `${namn}` eller `%{namn}`. De kan fyllas i av QtScript eller när textsnutten används. Det finns en speciell variabel, ${cursor} eller %{cursor}, som automatiskt flyttar markören till dess första förekomst.

### Använda textsnuttar

Textsnuttar för Kate under användning
Åtkomst av textsnuttar för Kate från en verktygsvy och kombinationsruta.

Välj i en lista med textsnuttar.

Textsnuttar kan anropas på två sätt:

- Genom att välja textsnutten i verktygsvyn.

- Under tiden du skriver, kan du trycka på &Ctrl;Mellanslag, som visar alla textsnuttar i ett bekvämt fönster där du kan välja ett. Du kan skriva in början av textsnuttens namn innan eller efter du trycker på tangentkombinationen, vilket tillhandahåller en funktion som liknar kodkomplettering.

Om textsnutten innehåller variabler (förutom `${cursor}`) flyttas markören automatiskt till den första förekomsten av en variabel och väntar på att något ska skrivas in. När du är klar kan du trycka på tabulatortangenten för att gå till nästa variabel, och så vidare.

### Tack och erkännanden

Kate textsnuttar är skrivet av Joseph Wenninger.

Särskilt tack till deltagaren i Google Code-In 2011, Martin Gergov, för att ha skrivit stora delar av det här avsnittet.

Salma
Sultana
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Bygginsticksprogram

### Inledning

Bygginsticksprogrammet låter dig utföra åtgärder som bygg, rensa och kompilera för ett projekt.

### Använda bygginsticksprogrammet

Bygginsticksprogrammet lägger till verktygsvyn Byggutmatning längst ner och menyn Bygg i menyraden. Verktygsvyn kan användas för att anpassa inställningar av byggmål, medan menyn kan användas för att bygga, rensa och kompilera.

Verktygsvyn Byggutmatning har tre flikar:

- Fel och varningar

- Utmatning

- Målinställningar

#### Fliken målinställningar

Fliken målinställningar kan användas för att anpassa diverse byggmål.

Varje mål innehåller fyra inställningsalternativ:

Arbetskatalog

  Här kan sökvägen till projektet anges. Lämna den tom för att använda katalogen där aktuellt dokument finns.

Bygg

  Alternativen låter dig definiera byggkommandot. Det är normalt inställt till `make`.

Rensa

  Alternativen låter dig definiera rensningskommandot. Det är normalt inställt till `make clean`.

Snabbkompilering

  Alternativen låter dig definiera snabbkompileringskommandot. Det är normalt inställt till `gcc -Wall -g %f`.

Man kan skapa ett nytt mål genom att använda knappen Ny. Knappen Kopiera kan användas för att skapa en kopia av ett befintligt mål. Använd knappen Ta bort för att ta bort ett mål.

#### Fliken Utmatning

Fliken Utmatning visar terminalutmatningen som genererades av det senaste kommandot.

#### Fel och varningar

Fliken Fel och varningar listar felen och varningarna som orsakades av det senaste kommandot.

Varje rad innehåller ett meddelande, filnamnet och radnumret om tillgängligt. Att klicka på felet eller varningen går till lämplig fil och placerar markören på motsvarande radnummer.

För att gå till föregående fel, tryck på &Ctrl;&Alt;Vänster. För att gå till nästa fel, tryck på &Ctrl;&Alt;Höger.

### Menystruktur

Bygg Bygg

  Kör kommandot Bygg för målet som för närvarande är valt.

Bygg Rensa

  Kör kommandot Rensa för målet som för närvarande är valt.

Bygg Snabbkompilering

  Kör kommandot Snabbkompilera för målet som för närvarande är valt.

&Ctrl;&Alt;Left Bygg Föregående fel

  Flyttar markören till platsen för det föregående felet i dokumentet.

&Ctrl;&Alt;Höger Bygg Nästa fel

  Flyttar markören till platsen för det nästa felet i dokumentet.

Bygg Mål

  Välj från en lista med mål inställda av användaren.

Bygg Nästa mål

  Byt till nästa mål inställt av användaren.

### Tack och erkännanden

&kate;s bygginsticksprogram är skrivet av Kåre Särs.

Särskilt tack till deltagaren i Google Code-In 2011, Salma Sultana, för att ha skrivit stora delar av det här avsnittet.

Ömer
Faruk
ORUÇ
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## SQL-insticksprogram

### Inledning

Structured Query Language (SQL) är ett specialiserat språk för att uppdatera, ta bort och efterfråga information i databaser.

Kates SQL-insticksprogram låter dig:

- Skapa en databas

- Ansluta till befintliga databaser

- Infoga och ta bort data i databasen

- Utföra en förfrågan

- Visa resultat i en tabell

### Ansluta till en databas

Använd Lägg till anslutning i menyn SQL eller i verktygsraden, och välj därefter den Qt-databasdrivrutin du vill använda (inklusive QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 och QPSQL). Om du inte kan se en önskad drivrutin, måste den installeras. Klicka därefter på Nästa.

Om databasen du valde använder en fil, ange helt enkelt databasens plats och klicka på knappen Nästa. Om den kräver anslutning till en server, måste du skriva in serverns värddatornamn, ditt användarnamn och lösenord, och eventuell ytterligare information som just den drivrutinen kräver. Klicka därefter på Nästa.

Ge till sist anslutningen ett namn, och klicka på Slutför.

### Starta en förfrågan

#### INSERT/DELETE/UPDATE

Du kan infoga, ta bort och uppdatera data med SQL-insticksprogrammet, precis som du skulle göra på kommandoraden eller inne i ett program. Skriv helt enkelt in en förfrågan och klicka på knappen Utför förfrågan.

##### Några exempel på en förfrågan

`INSERT`

      INSERT INTO tabellnamn ("nyckel-1", "nyckel-2", "nyckel-3", "nyckel-4", "nyckel-5")
      VALUES ("värde-1", "värde-2", "värde-3", "värde-4", "värde-5" )

`DELETE`

      DELETE FROM tabellnamn WHERE name = "text"

`UPDATE`

      UPDATE tabellnamn SET "nyckel-1" = "text", "nyckel-2" = "text", "nyckel-3" = "text", "nyckel-4" = "text", "nyckel-5" = "text"

#### SELECT

Efter att ha utfört förfrågan `SELECT`, kan resultatet ses som en tabell som dyker upp i verktygsvyn SQL-datautmatning längst ner i &kappname;, eller som text under SQL-textutmatning. Om ett fel uppstår visas det i textutmatningen.

##### Exempel på `SELECT`-förfrågan

    SELECT * FROM tabellnamn

I verktygsvyn SQL-datautmatning finns några knappar:

Ändra storlek på kolumner till innehållet

  Ändra storlek på kolumner så att de passar till innehållet.

Ändra storlek på rader till innehållet

  Ändra storlek på rader så att de passar till innehållet.

Kopiera

  Markerar hela tabellens innehåll och kopierar det till klippbordet.

Exportera

  Exporterar hela tabellens innehåll till en fil, eller det nuvarande dokumentet med formatet kommaseparerade värden (CSV).

Rensa

  Ta bort allt från tabellvyn.

Nu kan du ändra färgerna som visas i tabellen på sidan SQL i Inställningar Anpassa Kate .

### Bläddring

Du kan bläddra i databasen med verktygsvyn SQL-schemabläddrare till vänster. Informationen som visas beror på vilken databasdrivrutin som används.

Högerklicka var som helst i verktygsvyn och välj Uppdatera för att uppdatera listan. För att skapa en förfrågan för någon post i listan, högerklicka på en post, välj Skapa och välj frågetyp (SELECT, UPDATE, INSERT eller DELETE) i undermenyn som visas.

### Menystruktur

SQL Lägg till anslutning...

  Lägger till en ny anslutning med användning av vilken databasdrivrutin som helst.

SQL Ta bort anslutning

  Tar bort den markerade anslutningen.

SQL Redigera anslutning...

  Redigerar den nuvarande anslutningens inställningar.

Anslutningar

  Alla databasanslutningar som du har skapat listas mellan menyalternativen Redigera anslutning och Utför förfrågan. Välj en för att utföra en förfrågan eller göra ändringar i den.

&Ctrl;E SQL Utför förfrågan

  Utför din förfrågan.

### Tack och erkännanden

SQL-insticksprogrammet är skrivet av Marco Mentasti.

Särskilt tack till deltagaren i Google Code-In 2011, Ömer Faruk Oruç, för att ha skrivit stora delar av det här avsnittet.

Martin
Gergov
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Insticksprogram för &gdb;

### Inledning

Insticksprogrammet för &gdb; i &kappname; tillhandahåller ett enkelt gränssnitt för den populära avlusaren från &GNU;-projektet.

Tidigare erfarenhet av &gdb; rekommenderas starkt. För mer information om att använda &gdb;, besök &gdb;:s hemsida.

Insticksprogrammet för &gdb; kan aktiveras på sidan med insticksprogram i &kappname;s inställningar.

För att insticksprogrammet ska fungerar riktigt, måste du ha en källkodsfil (av vilken typ som helst som stöds av &gdb;) och ett körbart program.

Om du kompilerar med &gcc;/`g++` bör du kanske använda kommandoradsväljaren ``-ggdb``.

Efter dessa förberedelser har gjorts, öppna källkodsfilen i &kappname;, skriv in sökvägen till det körbara programmet under fliken Inställningar i verktygsvyn Avlusningsvy, och välj Avlusa Starta avlusning i menyn för att komma igång.

### Meny- och verktygsradstruktur

Alla dessa alternativ är tillgängliga i &kappname;s menyer, och många är också tillgängliga från avlusningsverktygsraden.

Visa Verktygsvyer Visa avlusningsvy

  Visar en verktygsvy som innehåller utmatning från &gdb;, kommandoraden för &gdb; som använts, och andra inställningar.

Visa Verktygsvyer Visa lokala objekt

  Visar en lista med alla variabler som för närvarande är inlästa och deras värden.

Visa Verktygsvyer Visa anropsstack

  Visar en bakåtspårning från &gdb;.

Avlusa Mål

  En undermeny som innehåller en lista med mål (körbara program).

Avlusa Argumentlistor

  En undermeny som innehåller alla argumentlistor.

Avlusa Starta avlusning

  Startar &gdb; med ett mål.

Avlusa Döda eller stoppa avlusning

  Stoppar &gdb;.

Avlusa Starta om avlusning

  Startar om &gdb;.

Avlusa Växla brytpunkt

  Sätt en brytpunkt på markörens nuvarande position.

Avlusa Stega in i

  Kör aktuell sats (funktionsanrop avlusas).

Avlusa Stega förbi

  Kör aktuell sats (funktionsanrop avlusas inte)

Avlusa Stega ut ur

  Återupptar körning till programmet som kör avslutas.

Avlusa Flytta programräknare

  Flyttar programräknaren (nästa körning).

Avlusa Kör till markören

  Kör programmet till det når nuvarande markörposition.

Avlusa Fortsätt

  Ignorerar eventuella brytpunkter och kör programmet till det avslutas (med lyckat resultat eller inte).

Avlusa Skriv ut värde

  Skriver ut värdet på variabeln som markören för närvarande pekar på.

Inställningar Visade verktygsrader Insticksprogram för &gdb;

  Visar avlusningsverktygsraden.

### Avlusningsvy

Verktygsvyn Avlusningsvy består av flera flikar:

Utmatning från &gdb;

  Innehåller utmatning från &gdb; och en &gdb; kommandorad.

  Fliken Utmatning
  Fliken Utmatning.

  Fliken Utmatning visar utmatningen från en avlusningssession.

Inställningar
  Mål

    Sökväg till mål (körbart program) att avlusa.

  Arbetskatalog

    Nuvarande arbetskatalog som tillhandahålls till målet.

  Argumentlista

    Argument som skickas till programmet.

  Behåll fokus

    Behåller fokus på &gdb;:s kommandorad.

  Omdirigera in- och utmatning

    Visar en ny flik för I/O i Avlusningsvyn där du kan se utmatning från och ge inmatning till programmet som kör.

  Fliken Inställningar
  Fliken Inställningar.

  Fliken Inställningar visar inställningen för en avlusningssession.

I/O

  Innehåller ett område som visar utmatning från programmet som kör och en kommandorad där du kan ange inmatning till det.

  Fliken I/O
  Fliken I/O.

  Fliken I/O som visar utmatning från ett enkelt testprogram.

### Anropsstack och lokala objekt

Verktygsvyn Anropsstack innehåller en lista av formaterad bakåtspårning som returneras från &gdb;.

Verktygsvyn Anropsstack i &gdb;
Verktygsvyn Anropsstack.

Verktygsvyn Anropsstack i insticksprogrammet för &gdb;.

Verktygsvyn Lokala objekt innehåller en lista över alla variabler som för närvarande är laddade från programmet, och deras motsvarande värden.

Verktygsvyn Lokala objekt i &gdb;
Verktygsvyn Lokala objekt

Verktygsvyn Lokala objekt i insticksprogrammet för &gdb;.

### Tack och erkännanden

Särskilt tack till deltagaren i Google Code-In 2011, Martin Gergov, för att ha skrivit stora delar av det här avsnittet.