Färgteman lagras i filer med JSON-format, med filändelsen .theme.

I källkoden för KSyntaxHighlighting, finns JSON-filerna för inbyggda teman i katalogen data/themes/. Observera att i texteditorer kompileras inbyggda teman i biblioteket KSyntaxHighlighting, därför är sättet att komma åt dem via källkoden eller genom att exportera dem från det grafiska användargränssnittet för att hantera teman i KTextEditor.

Det är också möjligt att enkelt lägga till ytterligare eller egna teman, som läses in från filsystemet. Användaranpassade temafiler finns i katalogen org.kde.syntax-highlighting/themes/ i användarkatalogen, som hittas med kommandot qtpaths --paths GenericDataLocation och som oftast är $HOME/.local/share/ och /usr/share/.

För Flatpak- och Snap-paket, fungerar inte ovanstående katalog eftersom dataplatsen är olika för varje program. I ett Flatpak-program, är platsen för anpassade temafiler oftast $HOME/.var/app/flatpak-paketnamn/data/org.kde.syntax-highlighting/themes/ och i ett Snap-program är platsen $HOME/snap/snap-paketnamn/current/.local/share/org.kde.syntax-highlighting/themes/.

På Windows® är filerna placerade i %USERPROFILE%\AppData\Local\org.kde.syntax-highlighting\themes. %USERPROFILE% expanderas oftast till C:\Users\användarnamn.

Sammanfattningsvis, för de de flesta konfigurationer är den egna temakatalogen följande:

Om flera temafiler finns med samma namn, läses filen med största revision in.

Strukturen för en JSON-fil förklaras på deras webbplats. I huvudsak består en JSON-formaterad fil av:

Terminologin ”nyckel”, ”värde”, ”objekt” och ”fält” används i det här avsnittet. Om det är första gången du arbetar med JSON-filer, är det enkelt nog att förstå dem genom att titta på exemplen nedan.

Färgtemats rotobjekt i JSON-filer innehåller följande schemanycklar:

JSON-språket stöder inte kommentarer. Dock kan du använda den valfria nyckeln _comments i rotobjektet för att skriva kommentarer. Om du exempelvis anpassar ett befintligt tema kan du lägga till webbadressen för originalarkivet. Det mest praktiska sättet är att använda ett fält av strängar.

Nedan finns en exempelfil för temat ”Breeze Light”. Du kanske märker att för att undvika att exemplet blir för stort, innehåller inte objekten editor-colors och text-styles alla nödvändiga nycklar. Du hittar hela arkivet av temat ”Breeze Light” i arkivet för KSyntaxHighlighting.

{
    "_comments": [
        "Det här är en kommentar.",
        "Om temat är en anpassning av ett annat, ange länken till originalarkivet."
    ],
    "metadata": {
        "name" : "Breeze Light",
        "revision" : 5,
        "copyright": [
            "SPDX-FileCopyrightText: 2016 Volker Krause <vkrause@kde.org>",
            "SPDX-FileCopyrightText: 2016 Dominik Haumann <dhaumann@kde.org>"
        ],
        "license": "SPDX-License-Identifier: MIT"
    },
    "editor-colors": {
        "BackgroundColor" : "#ffffff",
        "CodeFolding" : "#94caef",
        "BracketMatching" : "#ffff00",
        "CurrentLine" : "#f8f7f6",
        "IconBorder" : "#f0f0f0",
        "IndentationLine" : "#d2d2d2",
        "LineNumbers" : "#a0a0a0",
        "CurrentLineNumber" : "#1e1e1e",
        Andra färgnycklar för editorn ...

    },
    "text-styles": {
        "Normal" : {
            "text-color" : "#1f1c1b",
            "selected-text-color" : "#ffffff",
            "bold" : false,
            "italic" : false,
            "underline" : false,
            "strike-through" : false
        },
        "Keyword" : {
            "text-color" : "#1f1c1b",
            "selected-text-color" : "#ffffff",
            "bold" : true
        },
        "Function" : {
            "text-color" : "#644a9b",
            "selected-text-color" : "#452886"
        },
        "Variable" : {
            "text-color" : "#0057ae",
            "selected-text-color" : "#00316e"
        },
        Nycklar för andra textstilar...

    },
    "custom-styles": {
        "ISO C++": {
            "Data Type": {
                "bold": true,
                "selected-text-color": "#009183",
                "text-color": "#00b5cf"
            },
            "Keyword": {
                "text-color": "#6431b3"
            }
        },
        "YAML": {
            "Attribute": {
                "selected-text-color": "#00b5cf",
                "text-color": "#00b5cf"
            }
        }
    }
}

JSON-objektet för nyckeln metadata innehåller relevant information om temat. Objektet har följande nycklar:

"metadata": {
    "name" : "Breeze Light",
    "revision" : 5,
    "copyright": [
        "SPDX-FileCopyrightText: 2016 Volker Krause <vkrause@kde.org>",
        "SPDX-FileCopyrightText: 2016 Dominik Haumann <dhaumann@kde.org>"
    ],
    "license": "SPDX-License-Identifier: MIT"
}

Motsvarar färgerna i textredigeringsområdet.

I JSON-temafiler, respektive nyckel editor-colors har ett värde, ett object, där varje nyckelreferens refererar till en egenskapsfärg i texteditorn. Här är alla tillgängliga nycklar nödvändiga, och deras värden är strängar med hexadecimala färgkoder, som ”#00B5CF”.

I det grafiska användargränssnitt för att hantera teman i KTextEditor, kan egenskaperna ändras under fliken Färger.

Följande nycklar är tillgängliga: nycklarna använda i JSON-filen listas med fetstil, och namnen använda i det grafiska användargränssnittet visas inom parentes.

De förvalda textstilarna ärvs av färgläggningstextstilarna, vilket gör det möjligt för editorn att visa text på ett mycket konsekvent sätt, till exempel använder kommentartext samma stil i nästan alla textformat som KSyntaxHighlighting kan färglägga.

I JSON-filen har respektive text-styles nyckel värdet object där varje nyckel motsvarar namnet på en förvald textstil, som är ekvivalent med de som används i syntaxfärgläggningsdefinitioner. Här är alla tillgängliga nycklarna för textstilar nödvändiga, och de listas nedan.

"text-styles": {
    "Normal" : {
        "text-color" : "#1f1c1b",
        "selected-text-color" : "#ffffff",
        "bold" : false,
        "italic" : false,
        "underline" : false,
        "strike-through" : false
    },
    "Keyword" : {
        "text-color" : "#1f1c1b",
        "selected-text-color" : "#ffffff",
        "bold" : true
    },
    "Function" : {
        "text-color" : "#644a9b",
        "selected-text-color" : "#452886"
    },
    Nycklar för andra textstilar...
}

De här egenskaperna kan ändras i det grafiska användargränssnittet för att hantera färgteman i KTextEditor, under flikenFörvalda textstilar. Namnet i listan över stilar använder stilen inställd för det objektet, vilket ger dig en omedelbar förhandsgranskning när en stil anpassas. Varje stil låter dig välja vanliga egenskaper samt förgrunds- och bakgrundsfärger. För att välja bort en bakgrundsfärg, högerklicka för att använda den sammanhangsberoende menyn.

Följande nycklar för textstil är tillgängliga: nycklarna använda i JSON-filen listas med fetstil, och namnen använda i det grafiska användargränssnittet visas inom parentes om de är annorlunda.

Här kan du etablera textstilar för en specifik syntaxfärgläggningsdefinition, och överskrida förvald textstil beskriven i föregående avsnitt.

i JSON-temafilen motsvarar det nyckeln custom-styles vars värde är ett objekt där varje delschemanyckel motsvarar namnet på en syntaxfärgläggningsdefinition. Dess värde är ett objekt där en nyckel refererar till stilens egenskapsnamn definierat i elementen itemData i XML-filens syntaxfärgläggning, och respektive värde är ett delobjekt med nycklarna text-color, selected-text-color, bold, italic, underline, strike-through, background-color och selected-background-color, definierade i föregående avsnitt. Vart och ett av värdena är valfritt, eftersom om de inte anges, beaktas stilen angiven i text-styles.

Exempelvis, i det här kodavsnittet, har ”ISO C++” syntaxfärgläggningsdefinition en särskild textstil för egenskaperna ”Type Modifiers” och ”Standard Classes”. I motsvarande XML-fil ”isocpp.xml” använder den definierade egenskapen ”Standard Classes” förvald stil BuiltIn (eller dsBuiltIn). I denna egenskap överskrids bara värdet text-color av den nya färgen ”#6431b3”.

"custom-styles": {
    "ISO C++": {
        "Standard Classes": {
            "text-color": "#6431b3"
        },
        "Type Modifiers": {
            "bold": true,
            "selected-text-color": "#009183",
            "text-color": "#00b5cf"
        }
    }
}

I det grafiska användargränssnitt för att hantera teman i KTextEditor, kan egenskaperna ändras under fliken Färgläggningstextstilar. Normalt väljer editorn färgläggningen av det aktuella dokumentet i förväg. Du kommer att märka att många färgläggningar innehåller andra färgläggningar som representeras av grupper i stillistan. Exempelvis importerar de flesta färgläggningar ”Alert”, och många källkodsformat importerar ”Doxygen”.

För att skapa ett nytt tema är det först nödvändigt att kopiera ett befintligt. Välj ett befintligt tema som du vill använda som grund, såsom ”Breeze Light” eller ”Breeze mörk”, och klicka på Kopiera. Skriv sedan in ett namn på det nya temat.

Om du vill ändra en inbyggt eller skrivskyddat tema, måste det först kopieras till ett annat namn.

Du kan exportera ett valt tema (inklusive inbyggda) till en JSON-fil med filändelsen .theme, med knappen Exportera. Det visar en dialogruta för att spara filen. För att lägga till ett färgtema från en extern JSON-fil, klicka helt enkelt på knappen Importera och välj .theme-filen i dialogrutan.

En viktig aspekt vid arbete med färgteman är att välja en textkontrast som gör det lättare att läsa, särskilt i kombination med bakgrunden.

Programmet Kontrast är ett verktyg för kontroll av färgkontrast. Det talar om för dig att kombinationen av textfärg och bakgrundsfärg är läsbara och handikappanpassade, så det är ett utmärkt verktyg för att hjälpa dig skapa färgteman.

Du kan ladda ner Kontrast från webbplatsen för KDE program eller från Flatpak-paketet på Flathub (bara i GNU/Linux).

GNOME-programmet Contrast är liknande. Du kan ladda ner Flatpak-paketet på Flathub (bara på GNU/Linux).

KSyntaxHighlighting inkluderar mer än 300 syntaxfärgläggningsdefinitioner, och därför är det idealiskt att du säkerställer att ditt nya tema ser bra ut i alla syntaxfärgläggningsdefinitioner. De inbyggda färgteman har följande likheter som det rekommenderas (men inte krävs) att du följer för att åstadkomma korrekt visning av alla syntaxfärgläggningsdefinitioner:

De flesta av syntaxfärgläggningarna är avsedda att se bra ut med standardteman ”Breeze Light” och ”Breeze mörk”, därför är ett annat sätt att behålla likformighet att använda liknande färger textstilar, som grön för ”Preprocessor” och ”Others”, blå för ”DataType” och ”Attribute”, eller violett för ”Function”.

Observera att rekommendationerna inte är obligatoriska när ett tema skapas och publiceras.