Det här avsnittet beskriver några av alternativen på menyn Visa så att du snabbt kan få Kate att fungera som du vill.

När du startar Kate för första gången, kommer du att se två fönster med vit bakgrund. Över de två fönstren finns en verktygsrad med de vanliga ikonerna. Och ovanför den, en menyrad.

Fönstret till vänster är en dockningsbar sidorad. Det kombinerar Dokument och Filsystembläddraren. Byt mellan de två genom att klicka på flikarna till vänster om fönstret.

Om du har startat Kate med en fil, kommer fönstret till höger att visa filen du redigerar och Dokument i sidoraden kommer att visa filens namn. Använd fönstret Filsystembläddraren för att öppna filer.

Du kan visa eller dölja alla sidoradsfönster i menyn Visa → Verktygsvyer eller använda Ctrl+Alt+Skift+F. Menyn ger dig ditt första intryck av hur kraftfullt och anpassningsbart Kate är.

Under Verktygsvyer finns en lista över alla aktiverade insticksprogram. Klicka på kryssrutan framför varje alternativ, eller klicka med vänster musknapp på verktygsknapparna i sidoraden för att sätta på eller stänga av verktygsvyn.

Många av snabbtangenterna i Kate är konfigurerbara i menyn Inställningar. Vanligtvis har Kate följande snabbtangenter.

Dessutom kan genvägarna som tillhandahålls av komponenten KatePart och av alla aktiverade Kate insticksprogram.

Fönster, vy, dokument, ram, editor... Vad betyder de allihop i Kates terminologi, och hur får man ut så mycket som möjligt av dem? Det här kapitlet förklarar allt detta, och lite till.

Kate klarar av att ha mer än ett dokument öppet på samma gång, och också att dela redigeringsområdet i hur många rutor som helst, vilket fungerar på ett liknande sätt som till exempel Konqueror eller den populära texteditorn emacs. På det här sättet kan du titta på flera dokument samtidigt, eller flera instanser av samma dokument, vilket är praktiskt om ditt dokument till exempel innehåller definitioner längst upp som du ofta vill referera till. Eller du skulle kunna titta på en deklarationsfil för ett program i en ruta, medan du redigerar implementeringsfilen i en annan.

När ett dokument är tillgängligt i mer än en editor, så visas omedelbart ändringar i en editor också i de andra. Det här omfattar ändringar i texten, samt markering av texten. Sökoperationer eller förflyttning av markören visas bara i den nuvarande editorn.

Det är för närvarande inte möjligt att ha flera instanser av samma dokument öppna, på det sättet att en instans redigeras medan den andra inte gör det.

När editorn delas i två delar, delas den upp i två lika stora rutor, som båda visar det nuvarande dokumentet i editorn. Den nya rutan är längst ner (i fallet med en horisontell delning) eller till höger (för en vertikal delning). Den nya rutan får fokus, vilket visas med en liten grön punkt i rutan som har fokus.

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.

Kates hemsida tillhandahåller några artiklar och handledningar med ytterligare information utanför den här handbokens omfattning.

Att redigera ett verktyg visar en inställningsdialogruta som tillåter finkornig inställning av verktyget:

Knappen Förval är bara synlig för verktyg som levereras med Kate. När den klickas, återgår alla verktygets inställningar till förvalda värden (fabriksinställning).

Visa redigeringsfält såsom Körbart program, Väljare, Inmatning och Arbetskatalog stöder variabler som expanderas när verktyget används. Det indikeras med ikonen {} som visas när väl ett av dessa textinmatningsfält har fokus (se den röda cirkeln).

Att hålla musen över ett av textinmatningsfälten visar också ett verktygstips med den nuvarande expanderade texten. Dessutom visas en dialogruta som listar alla tillgängliga variabler vid klick på alternativet {}:

Funktionen erbjuder stor flexibilitet när ett externt verktyg definieras, eftersom alla variabler på formen %{...} expanderas när verktyget startas. Det finns två sorters variabler som stöds:

Den första formen %{variabelnamn} ersätter helt enkelt variabeln med dess innehåll. Exempelvis ersätts variabeln %{Document:FileName} med det aktuella dokumentets filnamn utan sökväg. Den andra formen %{variabelnamn:≶värde>} får <värde> som innehåll. Det kan exempelvis användas för att expandera en miljövariabel med %{ENV:HOME}, eller för att få dagens datum med önskat format, såsom %{Date:yyyy-MM-dd}.

Flera verktyg levereras som förval. Om du har fler användbara verktyg, bidra gärna med dem via (kwrite-devel AT kde.org) så att vi kan lägga till dem i listan. Alla förvalda verktyg är normalt synliga i listan. Dock kan alla verktyg ändras som du vill, inklusive kategori eller till och med ta bort verktyg. Borttagna verktyg kan läggas till igen genom att klicka på knappen Lägg till på inställningssidan som beskrivs ovan.

Insticksprogrammet är avsett för utvecklare och användare har troligtvis begränsad användning av det. Det visar en bakåtspårning levererad av gdb i en listvy i en Kate verktygsvy. Att klicka på ett objekt öppnar den markerade filen och går till rätt radnummer. Det fungerar för bakåtspårningar skapade på den egna datorn, men fungerar också för bakåtspårningar från andra, t.ex. /home/exempel/qt-copy/.../qwidget.cpp hittas också på andra datorer. För att det ska fungera måste katalogerna där källkoden finns indexeras.

Ibland finns det flera filer med samma namn, t.ex.

För att välja rätt alternativ, väljer insticksprogrammet webbadressens två sista delarna, som i detta fall skulle vara

Och därefter hittar insticksprogrammet oftast den rätta.

Indexering av master och en gren leder naturligtvis till kollisioner.

Lägg till katalogerna som innehåller källkoden på inställningssidan.

Anpassa sökvägar med verktygsvyn i Bläddring i bakåtspårning

Att klicka på Ok påbörjar indexeringen. Öppna verktygsvyn Bläddring i bakåtspårning när indexeringen är klar.

Nu kan en bakåtspårning läsas in från klippbordet (t.ex. om du klickat på Kopiera till klippbordet i DrKonqi) eller från en fil.

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

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 två flikar:

Fliken målinställningar

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

För att ändra namn eller kommandon, dubbelklicka på posterna i tabellen och använd kombinationsrutan för att välja aktiv måluppsättning. Använd kryssrutan framför varje mål för att definiera ett standardvärde.

En ny måluppsättning innehåller flera olika 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.

Config

Alternativet låter dig definiera kommandot config. Det är normalt inställt till cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../

Längst upp har insticksprogrammet en verktygsrad med följande knappar:

Bygg markerat mål

Lägg till nytt mål

Skapa en ny byggmåluppsättning

Kopiera kommando eller måluppsättning

Ta bort nuvarande kommando eller måluppsättning

Kates 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.

Insticksprogrammet låter dig stänga en grupp dokument baserat på deras filändelse och sökväg.

Antag att följande dokument är öppna i Kate:

Då har du följande alternativ för att stänga dokument, som visas på skärmbilden:

Använd kryssrutan för det sista alternativet i listan för att aktivera eller inaktivera en bekräftelsedialogruta. Det valda alternativet gäller båda stängningsalternativen.

Insticksprogrammet lägger till en färggranskare/färghämtare på plats i texten (t.ex. #FFFFFF, vit).

För att ladda insticksprogrammet, öppna först Kates inställningsdialogruta under Inställningar → Anpassa Kate... . Markera därefter Färghämtare och stäng dialogrutan.

På färghämtarens inställningssida i Kates inställningar kan du ställa in följande alternativ för insticksprogrammets beteende.

Insticksprogrammet Färgade parenteser färglägger matchande parentespar med olika färger för att förbättra läsbarheten. Dock färgläggs inte alla parenteser, En parentes vars matchande inledande eller avslutande tecken inte är synligt ignoreras. På samma sätt, färgläggs inte ett parentespar som är det enda paret på en rad.

Insticksprogrammet tillhandahåller inte några inställningar.

CTags skapar en indexfil (eller taggfil) av språkobjekt som hittas i källkodsfiler, som gör det möjligt att snabbt och enkelt lokalisera objekten med det här insticksprogrammet i Kate.

En tagg betecknar ett språkobjekt som har en indexpost tillgänglig (eller alternativt, indexposten skapad för objektet).

Att skapa taggar stöds för de här programspråken.

Insticksprogrammet CTags använder två olika databasfiler för indexet.

På CTags inställningssida i Kates inställningar kan kataloger som innehåller källkod läggas till eller tas bort, och den gemensamma CTags databasen kan genereras om.

Gemensamt index

Anpassa CTags globala databas

Längst ner på inställningssidan kan CTags-kommando anpassas.

För mer information om alla tillgängliga väljare, läs CTags manualsida. Manualsidan är tillgänglig i Hjälpcentralen, och det går också att skriva in webbadressen man:/ctags direkt i Konqueror.

Att klicka på Uppdatera startar indexeringen. Stäng dialogrutan när indexeringen är färdig.

Placera muspekaren på ett språkobjekt, såsom en funktion, symbol, etc., som du är intresserad av och välj därefter en av åtgärderna i menyn CTags för att gå till raden och filen där objektet är definierat eller deklarerat.

Normalt har alternativen i menyn CTags inga tilldelade genvägar. Använd editorn av snabbtangenter för att ställa in egna genvägar.

Som alternativ, använd sökfältet under fliken Slå upp i CTags vyn.

Att skriva in tecken i sökfältet påbörjar sökningen och visar matchande namn på språkobjekt som funktioner, klasser, symboler, etc., tillsammans med typ och filnamn.

Välj ett objekt i listan för att gå till motsvarande rad i källkodsfilen.

Insticksprogrammet aktiverar en direkt förhandsgranskning av textdokumentet som för närvarande redigeras med det slutliga formatet i sidoraden. Så när t.ex. Markdown-text eller en SVG-bild redigeras, är resultatet omedelbart synligt intill källtexten.

Insticksprogrammet använder KParts-insticksprogrammet som för närvarande är valt som det föredragna för dokumentets MIME-typ för visning. Om det inte finns något KParts-insticksprogram för typen är inte någon förhandsgranskning möjlig.

För att ändra föredraget insticksprogram öppna modulen Filbindningar i systeminställningarna och redigera Önskad ordning av tjänster under fliken Inbäddning.

Knapparna ovanför förhandsgranskningsfönstret tillhandahåller följande åtgärder:

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

Insticksprogrammet kan anpassas på sidan Filsystembläddrare i Kates inställningsruta.

Dokumentlistan visar en lista över alla dokument som för närvarande är öppna i Kate. Ändrade filer har en liten diskettikon till vänster för att ange tillståndet.

Längst upp har dokumentlistan en verktygsrad med följande knappar:

Skapa nytt dokument

Öppna ett befintligt dokument

Föregående dokument

Nästa dokument

Spara aktuellt dokument

Spara aktuellt dokument med ett nytt namn

Normalt visas dokumentlistan i Trädläge, vilket visar katalogstrukturen som omger alla öppna dokument. Listläge är också tillgängligt, som visar en enkel lista över alla öppna dokument. Det går att byta läge genom att högerklicka på listan och välja i menyn Visningsläge.

Om två eller flera filer med samma namn (placerade i olika kataloger) är öppna i Listläge, namnet på den andra inleds med ”(2)” och så vidare. Filens verktygstips visar det fullständiga namnet inklusive sökvägen, vilket gör det möjligt att välja den önskade.

Klicka på dokumentnamnet i listan för att visa ett dokument i fönstret som för närvarande är aktivt.

Den sammanhangsberoende menyn har några vanliga alternativ från menyn Arkiv.

Dessutom finns filhanteringsalternativ för att byta namn på eller ta bort filen. Med Kopiera plats kan dokumentets fullständiga sökväg kopieras till klippbordet.

Det går att sortera listan på några olika sätt genom att högerklicka på listan och välja i menyn Sortera enligt. Alternativen är:

Dokumentlistan visar normalt historiken genom att skugga posterna för de senaste dokumenten med en bakgrundsfärg. Om dokumentet har redigerats, tonas extra färg in. Det senaste dokumentet har starkast färg, så att du lätt hittar dokumenten du arbetar med. Funktionen kan stängas av på sidan Dokument i inställningsdialogrutan.

Den normala platsen för dokumentlistan i Kates fönster är till vänster om redigeringsområdet.

Insticksprogrammet för GDB i Kate tillhandahåller ett enkelt gränssnitt för den populära avlusaren från GNU-projektet.

Insticksprogrammet för GDB kan aktiveras på sidan med insticksprogram i Kates 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.

Efter dessa förberedelser har gjorts, öppna källkodsfilen i Kate, 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.

Alla dessa alternativ är tillgängliga i Kates menyer, och många är också tillgängliga från avlusningsverktygsraden.

Verktygsvyn Avlusningsvy består av flera flikar:

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

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 insticksprogrammet för GDB.

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

Grundidén med projektinsticksprogrammet är att ha en strukturerad fillista som hör till projektet med följande egenskaper:

När projektinsticksprogrammet väl har laddats från Kates inställningssida, öppna en fil i ett projekt så visas en sidorad där alla projekt samt projektfilerna listas på följande sätt:

Som synes är projektet som för närvarande är aktivt ”Kate”, och dess innehåll listas i trädvyn. Genom att klicka på filer i trädvyn öppnas de i editorn. Dessutom tillhandahålls en sammanhangsberoende meny som gör att filer kan öppnas med andra program, såsom en .ui-fil med Qt Designer.

Det går att filtrera objekt genom att skriva in en del av filnamnet som du söker efter på sökraden längst ner i listan.

Idén är att man aldrig ska behöva öppna ett projekt manuellt, det stöds överhuvudtaget inte. Vad som sålunda sker om en fil öppnas är att projektinsticksprogrammet snabbt söker igenom katalogen och dess överliggande kataloger för att hitta filen .kateproject. Om den hittas, läses projektet automatiskt in.

Dessutom om ett annat dokument öppnas i Kate som hör till ett annat projekt, byter projektinsticksprogrammet automatiskt aktuellt projekt. Alltså är intuitivt alltid rätt projekt aktivt. Man kan naturligtvis också byta projekt som för närvarande är aktivt genom att använda kombinationsrutan.

Kate har insticksprogrammet Sök och ersätt som dyker upp i den nedre sidoraden. Om ett projekt är inläst, öppna sidoraden Sök och ersätt, och byt till läget för att söka och ersätta i det aktuella projektet:

Med kunskap om alla filer som hör till ett projekt, tillhandahåller projektinsticksprogrammet enkel automatisk komplettering baserat på CTags. Om ett projekt just har öppnats, tolkar CTags alla projektfiler i en bakgrundstråd och sparar CTags-information i /tmp. Filen används sedan för att fylla i rutan med automatisk komplettering i Kate.

I motsats, utan automatisk komplettering klarar Kate bara av att visa objekt för automatisk komplettering baserat på ord i den nuvarande filen. Alltså är den automatiska kompletteringen som tillhandahålls av projektinsticksprogrammet mycket kraftfullare.

Om CTags saknas, varnas du om problemet av en passiv meddelanderuta. Det är också värt att notera att CTags-filen i /tmp städas bort när Kate avslutas, så insticksprogrammet förorenar inte någon katalog med oönskade filer.

Eftersom att klicka på filer i trädvyn inte är det snabbaste sättet att öppna en fil, tillhandahåller Kate en inbyggd mekanism för snabböppning som kan aktiveras med Ctrl+Alt+O. Vad du då får är en sådan här lista:

Du kan också filtrera genom att skriva in delar av filnamnet som du letar efter, och du kan också navigera med piltangenterna, Page Up och Page Down i listan. Genom att trycka på returtangenten aktiveras den markerade filen, medan Esc döljer snabböppningsvyn igen.

Dessutom kommer snabböppna ihåg föregående fil. Så när du byter till snabböppningsvyn är den föregående aktiva filen automatiskt markerad och du behöver bara trycka på returtangenten, vilket ibland är mycket bekvämt.

En annan funktion är att ha stöd för insticksprogrammet Bygg så att det automatiskt ställs in på ett riktigt sätt.

Genom att använda Projekt → Gå till (Alt+1) kan vyn Aktuellt projekt öppnas längst ner i editorns fönster med fyra flikar:

Menyn Projekt låter dig byta mellan projekt som för närvarande är öppna. Den visas av insticksprogrammet Projekt.

Om det passar, nämns ett motsvarande LSP-kommando också i förklaringen nedan, och dokumentationen av det kan då ge ytterligare bakgrund och tolkning, även om det kan bero på själva språket. Uttrycket 'aktuell symbol' gäller symbolen som motsvarar markörens aktuella position, och sålunda bestämd av språket och serverimplementeringen.

LSP-klienten kan hjälpa till att gå till vilken symbol som helst i projektet eller den aktuella filen. För att gå till vilken symbol som helst i filen, använda verktygsvyn "LSP-klienten symbolöversikt" vid Kates högra kant. Verktygsvyn listar alla symbolers som servern hittat i det aktuella dokumentet.

Kommandot för att byta källkodsdeklaration i Clangd stöds. För att byta källkodsdeklaration i ett C eller C++ projekt, använda antingen alternativet "Byt källkodsdeklaration" i den sammanhangsberoende menyn eller genvägen F12.

Du kan snabbt gå till en symbol genom att placera musen över symbolen och sedan trycka på Ctrl + vänster musknapp.

Insticksprogrammets inställningssida tillåter i huvudsak en bestående inställning av vissa av menyalternativen ovan. Dock finns det en ytterligare post för att ange serverns inställningsfil. Det är en JSON-fil som kan användas för att ange LSP-servern som ska startas (och sedan kommuniceras med via standardinmatning och standardutmatning). Av bekvämlighetsskäl inkluderas en standardinställning, som kan granskas på insticksprogrammets inställningssida. Som hjälp i förklaringen nedan, ges ett utdrag ur inställningen här:

{
    "servers": {
        "bibtex": {
            "use": "latex",
            "highlightingModeRegex": "^BibTeX$"
        },
        "c": {
            "command": ["clangd", "-log=error", "--background-index"],
            "commandDebug": ["clangd", "-log=verbose", "--background-index"],
            "url": "https://clang.llvm.org/extra/clangd/",
            "highlightingModeRegex": "^(C|ANSI C89|Objective-C)$"
        },
        "cpp": {
            "use": "c",
            "highlightingModeRegex": "^(C\\+\\+|ISO C\\+\\+|Objective-C\\+\\+)$"
        },
        "d": {
            "command": ["dls", "--stdio"],
            "url": "https://github.com/d-language-server/dls",
            "highlightingModeRegex": "^D$"
        },
        "fortran": {
            "command": ["fortls"],
            "rootIndicationFileNames": [".fortls"],
            "url": "https://github.com/hansec/fortran-language-server",
            "highlightingModeRegex": "^Fortran.*$"
        },
        "javascript": {
            "command": ["typescript-language-server", "--stdio"],
            "rootIndicationFileNames": ["package.json", "package-lock.json"],
            "url": "https://github.com/theia-ide/typescript-language-server",
            "highlightingModeRegex": "^JavaScript.*$",
            "documentLanguageId": false
        },
        "latex": {
            "command": ["texlab"],
            "url": "https://texlab.netlify.com/",
            "highlightingModeRegex": "^LaTeX$"
        },
        "go": {
            "command": ["go-langserver"],
            "commandDebug": ["go-langserver", "-trace"],
            "url": "https://github.com/sourcegraph/go-langserver",
            "highlightingModeRegex": "^Go$"
        },
        "python": {
            "command": ["python3", "-m", "pyls", "--check-parent-process"],
            "url": "https://github.com/palantir/python-language-server",
            "highlightingModeRegex": "^Python$"
        },
        "rust": {
            "command": ["rls"],
            "path": ["%{ENV:HOME}/.cargo/bin", "%{ENV:USERPROFILE}/.cargo/bin"],
            "rootIndicationFileNames": ["Cargo.lock", "Cargo.toml"],
            "url": "https://github.com/rust-lang/rls",
            "highlightingModeRegex": "^Rust$"
        },
        "ocaml": {
            "command": ["ocamlmerlin-lsp"],
            "url": "https://github.com/ocaml/merlin",
            "highlightingModeRegex": "^Objective Caml.*$"
        }
    }
}

Observera att varje "kommando" kan vara ett fält eller en sträng (som delas till ett fält i detta fall). Dessutom tas också hänsyn till en toppnivå "global" post (intill "server"): se nedan. Den angivna binärfilen eftersöks på vanligt sätt, t.ex. genom att använda PATH. Om den är installerad på en egen plats, måste den senare utökas. Eller, som alternativ, kan en (symbolisk) länk eller omgivande skript användas på en plats som finns inom den vanliga PATH. Som åskådliggörs ovan, kan man också ange en "sökväg" som söks igenom efter de vanliga platserna.

Alla posterna i "command", "root" och "path" är föremål för variabelexpansion.

Posten "highlightingModeRegex" används för att konvertera färgläggningsläget som det används av Kate till serverns språkidentifikation. Om inget reguljärt uttryck anges, används själva språkidentifikationen. Om posten "documentLanguageId" är false, tillhandahålls ingen språkidentifikation till servern när dokumentet öppnas. Det kan ge bättre resultat på vissa servrar som är mer noggranna med att avgöra dokumenttypen än att bara göra det baserat på en inställning i Kate.

Kärnan är förmodligen klar från ovanstående exempel. Dessutom kan varje serverobjekt också ha posten "initializationOptions", som skickas med till servern som en del av metoden 'initialize'. Om den finns, skickas posten "settings" till servern via underrättelsen 'workspace/didChangeConfiguration'.

Diverse steg av överskridning och sammanfogning utförs:

En serverinstans används per kombinationen (root, servertype). Om "root" anges som en absolut sökväg används den som den är, annars är den relativ till ”projectBase” (som bestämd av projektinsticksprogrammet), om tillämpligt, eller annars relativt till dokumentets katalog. Om den inte anges och "rootIndicationFileNames" är ett fält av filnamn, väljes en överliggande katalog till den aktuella dokumentet som innehåller en sådan fil. Som en sista reserv, väljes hemkatalogen som "root". För alla dokument bestämmer resulterande "root" sedan om en separat instans behövs eller ej. Om det är fallet, skickas "root" över som rootUri/rootPath.

I allmänhet rekommenderas att roten lämnas ospecificerad, eftersom den inte är så viktig för en server (ditt resultat kan dock avvika). Färre serverinstanser är uppenbarligen effektivare, och de har också en 'bredare' vy än många separata instanser.

Som nämndes ovan, utförs variabelexpansion för flera poster. Ett passade tillämpning av det kombinerat med "omgivningsskript" tillåter anpassning till ett stort antal omständigheter. Antag exempelvis ett utvecklingsscenario för Python som består av flera projekt (t.ex. git-arkiv), vart och ett med sin egen inställda virtuella miljö. Med standardinställningen, är inte språkservern för Python medveten om den virtuella miljön. Det kan dock avhjälpas med följande tillvägagångssätt. Först kan följande fragment matas in under insticksprogrammets för LSP-klienten "Användarserverinställningar":

{
        "servers":
        {
                "python":
                {
                        "command": ["pylsp_in_env"], ["%{Project:NativePath}"],
                        "root": "."
                }
        }
}

Rotposten ovan är relativ till projektkatalogen och säkerställer att en separat språkserver startas för varje projekt, vilket är nödvändigt i det här fallet eftersom vart och ett har en separat virtuell miljö.

pylsp_in_env är ett litet "omgivningsskript" som måste placeras i PATH med följande (anpassade) innehåll:

#!/bin/bash
cd $1
# kör servern (python-lsp-server) inne i virtualenv
# (dvs. med variabeltilldelningar från virtualenv)
# så gör alltså source på virtualenv
source XYZ
# serverns prestanda eller argument kan variera
exec myserver

{
    "servers": {
        "python": {
            "settings": {
                "pyls": {
                    "plugins": {
                        "pylint": {
                            "enable": true
                        }
                    }
                }
            }
        }
    }
}

{
    "servers": {
        "c": {
            "suppressions": {
                "rulename": ["filnamn", "exempel"],
                "clang_pointer": ["", "clang-tidy", "clear_pointer"],
            }
        }
    }
}

Kates insticksprogram Sök och ersätt 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, alla filer i en katalog och valfritt i dess underkataloger, eller i den aktiva filen. Du kan till och med filtrera enligt filnamn, exempelvis för att bara söka i filer som slutar med en viss filändelse.

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 JavaScript.

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.

Skapa och redigera arkiv

För att skapa ett nytt textsnuttarkiv, klicka på Lägg till arkiv. 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å Ok.

Arkiveditorns gränssnitt.

Arkiveditorn för textsnuttar innehåller följande alternativ:

Name

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

Namnrymd

Prefix använt medan kodkomplettering används.

Licens

Välj licens för arkivet med textsnuttar.

Upphovsmän

Ange namnen på upphovsmännen till textsnuttfilen.

Filtyper

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å objekten. Du kan ange mer än en filtyp genom att klicka på Skift när typer läggs till.

Skapa och redigera textsnuttar

Redigeringsgränssnittet för textsnuttar.

Name

Namnet visas i kompletteringslistan.

Genväg

Att trycka på genvägen infogar textsnutten i dokumentet.

Textsnuttar

Texten som textsnutten infogar i dokumentet.

En textsnutt kan innehålla redigerbara fält. Man kan gå mellan dem genom att trycka på tabulatortangenten. Följande uttryck kan användas i malltexten för att skapa fält:

${fältnamn} skapar ett enkelt redigerbart fält. Alla följande förekomster av samma fältnamn skapar fält som speglar innehållet i det första under redigering.

${fältnamn=förval} kan användas för att ange ett förvalt värde för fältet. förval kan vara vilket JavaScript-uttryck som helst.

Använd ${fältnamn=text} för att ange en konstant sträng som förvalt värde.

${func(annat_fält_1, annat_fält_1, ...)} kan användas för att skapa ett fält som utvärderar en JavaScript-funktion vid varje redigering och innehåller dess innehåll. Se fliken Skript för mer information.

${cursor} kan användas för att markera slutposition för markören efter allt annat har fyllts i.

Skript

JavaScript-hjälpfunktioner att använda i textsnuttar.

Alla JavaScript-funktioner ska returnera innehållet som du vill placera i ett mallfält som en sträng.

Funktioner anropas i en omgivning som innehåller alla redigerbara mallfälts innehåll som lokala variabler. I en textsnutt som exempelvis innehåller ${field}, finns en variabel vid namn field som innehåller mallfältets aktuella värde. Variablerna kan antingen användas statiskt i funktionen eller skickas som väljare genom att använda syntaxen ${func(field)} eller ${field2=func(field)} i textsnuttens sträng.

Det går att använda Kates skriptprogrammeringsgränssnitt för att hämta markerad text, hela texten, filnamnet med mera genom att använda lämpliga metoder i objekten document och view. Se dokumentationen över skriptprogrammeringsgränssnittet för mer information..

För mer komplexa skript kan det vara viktigt att förstå att den obehandlade textsnutten först infogas i dokumentet och därefter utvärderas funktionerna. Om en funktion t.ex. hämtar texten på raden där textsnutten infogas, innehåller texten också ${functionCall()}.

Som ett exempel på att arbeta med markeringar när skriptprogrammeringsgränssnittet används, är ett enkelt sätt att omge markerad text inne i taggar att använda textsnutten: <strong>${view.selectedText()}</strong>

Följande exempel anropar ett skript som infogar en standardtext ifall det inte finns någon markering. Textsnutt:

${rangeCommand("<strong>%%1</strong>", "Bold")}

Skript:

function rangeCommand(command, def) {
    if (view.selectedText().length 
> 0) {
        return command.replace("%%1", view.selectedText());
    } else {
        return command.replace("%%1", def);
    }
}

Välj i en lista med textsnuttar.

Textsnuttar kan anropas på två sätt:

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.

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.

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:

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.

Du kan bläddra i databasen genom att använda bläddringsverktygsvyn Databasschema 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.

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.

Det gör det möjligt för utvecklare att visa symboler (funktioner, makron och strukturer) i källkod.

Genom att klicka på den tolkade informationen kan man enkelt bläddra i koden.

För närvarande stöds följande språk:

C/C++, Java™, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Lista över funktioner:

Du kan ställa in vyinsticksprogrammet Terminalverktyg på sidan Terminal i inställningsdialogrutan.

Följande alternativ är tillgängliga:

Insticksprogrammet kan användas för att utföra behandla markerad text med användning av terminalkommandon. Markeringen används som indata till kommandot, och utdata ersätter antingen markeringen eller kopieras till klippbordet, beroende på vad användaren föredrar.

Kates insticksprogram ”XML-validering” copyright 2002 Daniel Naber (daniel.naber AT t-online.de).

Dokumentation copyright 2002 Daniel Naber

Starta Kate och öppna inställningsdialogrutan med Inställningar → Anpassa Kate.... Markera därefter XML-komplettering, som visas på sidan Program → Insticksprogram och stäng dialogrutan. 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:

Du kan prova alla funktioner och begränsningar genom att ladda katexmltools/testcases.xml i qtpaths --paths GenericDataLocation med Kate och följa instruktionerna.

Kates insticksprogram ”XML-validering” copyright 2001, 2002 Daniel Naber (daniel.naber AT t-online.de).

KDE programvarusamling 4 version copyright 2010 Tomáš Trnka

Dokumentation copyright 2001,2002 Daniel Naber