Koloraj etosoj estas konservitaj en JSON; formataj dosieroj, kun la etendo .theme.

En la KSyntaxHighlighting fontkodo, la JSON dosieroj de enkonstruitaj etosoj troviĝas en la dosierujo data/themes/. Notu, ke en tekstredaktiloj, la enkonstruitaj etosoj estas kompilitaj en la bibliotekon KSyntaxHighlighting, tial la maniero aliri ilin estas per la fontkodo aŭ per eksportante ilin el la GUI por administri etosojn de KTextEditor.

Ankaŭ eblas facile aldoni pliajn aŭ proprajn etosojn, kiuj estas ŝargitaj de la dosiersistemo. Uzant-personigitaj etosdosieroj troviĝas en la dosierujo org.kde.syntax-highlighting/themes/ en via uzantdosierujo, kiun vi povas trovi per la komando qtpaths --paths GenericDataLocation kaj estas kutime $HOME/.local/share/ kaj /usr/share/.

En Flatpak kaj Snap-pakaĵoj, ĉi-supra dosierujo ne funkcios ĉar la datuma loko estas malsama por ĉiu aplikaĵo. En Flatpak-aplikaĵo, la loko de propraj etosdosieroj estas kutime $HOME/.var/app/flatpak-package-name /data/org.kde.syntax-highlighting/themes/ kaj en Snap-aplikaĵo tiu loko estas $HOME/snap/ snap-package-name/current/.local/share/org.kde.syntax-highlighting/themes/.

Sur Windows® ĉi tiuj dosieroj troviĝas %USERPROFILE%\AppData\Local\org.kde.syntax-highlighting hemes. %USERPROFILE% kutime vastiĝas al C:\Users\uzantnomo.

Resume, por la plej multaj agordoj la propraj etosoj dosierujo estas jena:

Se ekzistas pluraj etosodosieroj kun la sama nomo, la dosiero kun la plej alta revizio estos ŝargita.

La strukturo de JSON dosiero estas klarigita en ilia retejo. Esence, JSON formato dosiero konsistas el:

La nomenklaturo “ŝlosilo”, “valoro”, “objekto” kaj “tabelo” estos uzataj en ĉi tiu artikolo. Se ĉi tio estas via unua fojo laboranta kun JSON dosierojn, kompreni ilin estas tiel simple kiel rigardi la ekzemplojn sube.

La radika objekto de la koloretoso JSON dosiero enhavas la sekvajn skemajn ŝlosilojn:

La JSON lingvo ne subtenas komentojn. Tamen, vi povas uzi la laŭvolan klavon _comments en la radika objekto por skribi komentojn, ekzemple, se vi adaptas ekzistantan etoson vi povas meti la URL de la originala deponejo. La plej praktika maniero estas uzi tabelon de ĉenoj.

Malsupre estas ekzempla dosiero por la etoso “Breeze Light”. Vi povas rimarki ke, por eviti ke la ekzemplo estu tro granda, la objektoj editor-colors kaj text-stiloj ne enhavas ĉiujn postulatajn ŝlosilojn. Vi povas vidi la plenan arkivon de la “Breeze Light” etoso en la KSyntaxHighlighting-deponejo.

{
    "_comments": [
        "Ĉi tio estas komento.",
        "Se ĉi tiu etoso estas adapto de alia, metu la ligilon al la origina deponejo."
    ],
    "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",
        La aliaj redaktilaj kolorklavoj...

    },
    "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"
        },
        La aliaj tekstaj stilklavoj...

    },
    "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"
            }
        }
    }
}

La JSON objekto de la ŝlosilo metadata enhavas koncernajn informojn pri la etoso. Ĉi tiu objekto havas la sekvajn ŝlosilojn:

"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"
}

Korespondas al la koloroj de la tekstredakta areo.

En la JSON etosodosiero, la respektiva klavo editor-colors havas kiel valoron objekton kie ĉiu ŝlosilo referencas al atributokoloro de la tekstredaktilo. Ĉi tie, ĉiuj disponeblaj ŝlosiloj estas devigaj, iliaj valoroj estas ĉenoj kun deksesuma kolorkodoj, kiel “#00B5CF”.

En la GUI por administri etosojn de KTextEditor, ĉi tiuj atributoj povas esti modifitaj en la langeto Koloroj.

La disponeblaj ŝlosiloj estas la jenaj; la ŝlosiloj uzataj en la JSON dosiero estas listigitaj en grasa, la nomoj uzataj en la GUI estas montritaj inter krampoj.

La defaŭltaj tekstaj stiloj estas hereditaj de la elstaraj tekstostiloj, permesante al la redaktilo prezenti tekston en tre konsekvenca maniero, ekzemple komenta teksto uzas la saman stilon en preskaŭ ĉiuj tekstformatoj kiujn KSyntaxHighlighting povas reliefigi.

En la JSON dosiero, la respektiva klavo tekstaj stiloj havas kiel valoron objekton kie ĉiu klavo respondas al la nomo de defaŭlta tekstostilo , kiuj estas ekvivalentaj al tiuj uzataj en la sintakso elstarigante difinojn. Ĉi tie, ĉiuj disponeblaj tekststilaj klavoj estas devigaj, ĉi tiuj estas listigitaj sube.

"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"
    },
    La aliaj tekststilaj klavoj...
}

En la GUI por administri koloretosojn de KTextEditor, ĉi tiuj atributoj povas esti modifitaj en la langeto Defaŭltaj Tekstaj Stiloj. La nomo en la listo de stiloj uzas la stilon agordita por la ero, provizante al vi tujan antaŭrigardon dum agordado de stilo. Ĉiu stilo ebligas al vi elekti komunajn atributojn same kiel malfonojn kaj fonkolorojn. Por nuligi fonkoloron, dekstre alklaku por uzi la kuntekstan menuon.

La disponeblaj tekstostilaj ŝlosiloj estas la jenaj; la ŝlosiloj uzataj en la JSON dosiero estas listigitaj en grasa, la nomoj uzataj en la GUI estas montritaj inter krampoj se ili estas malsamaj.

Ĉi tie vi povas establi tekstajn stilojn por specifa sintaksa emfaza difino, superregante la defaŭltan tekstostilon priskribitan en la antaŭa sekcio .

En la JSON etosodosiero, ĉi tio respondas al la ŝlosilo personaj stiloj, kies valoro estas objekto kie ĉiu subskema ŝlosilo respondas al la nomo de sintaksa reliefigo-difino. Ĝia valoro estas objekto kie ĉiu ŝlosilo referencas al la nomo de stilaj atributoj difinita en la itemData elementoj de la sintakso reliefiganta XML dosiero, kaj la respektiva valoro estas subobjekto kun la klavoj text-color, selected-text-color, grasa, kursivo, substreki, streko, fonkoloro kaj elektita fonkoloro, difinita en la antaŭa sekcio. Ĉiu el ĉi tiuj valoroj estas nedeviga, ĉar se ili ne ĉeestas, la stilo fiksita en teksto-stiloj estas konsiderata.

Ekzemple, en ĉi tiu kodo, la sintaksa emfaza difino de “ISO C++” havas specialan tekstan stilon por la atributoj “Tipo-Modifiloj” kaj “Normaj Klasoj”. En la responda XML dosiero “isocpp.xml”, la difinita atributo “Normaj Klasoj” uzas la defaŭltan stilon BuiltIn (aŭ dsBuiltIn). En ĉi tiu eco, nur la valoro de teksto-koloro estas anstataŭita de la nova koloro “#6431b3”.

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

En la GUI por administri etosojn de KTextEditor, ĉi tiuj atributoj povas esti modifitaj en la langeto Elstarigado de Tekstaj Stiloj. Defaŭlte, la redaktilo antaŭelektas la reliefigon de la nuna dokumento. Vi rimarkos, ke multaj lumaĵoj enhavas aliajn lumaĵojn reprezentitajn de grupoj en la stillisto. Ekzemple la plej multaj elstaraĵoj importas la emfazon “Atento”, kaj multaj fontkodformatoj importas la elstaraĵon “Doxygen”.

Por krei novan etoson, unue necesas kopii ekzistantan. Elektu ekzistantan etoson, kiun vi volas uzi kiel bazon, kiel “Breeze Light” aŭ “Breeze Dark”, kaj alklaku Kopii. Poste skribu nomon por la nova etoso.

Se vi volas modifi enkonstruitan aŭ nurlegeblan etoson, vi unue devas kopii ĝin sub malsama nomo.

Vi povas eksporti elektitan etoson (inkluzive de enkonstruitaj) al JSON dosiero kun etendo .theme, per la butono Eksporti. Ĉi tio malfermos dialogon por konservi la dosieron. Por aldoni koloretoson de ekstera JSON dosiero, simple premu la butonon Importi kaj elektu la dosieron .theme el la dialogo.

Grava aspekto kiam oni laboras kun koloretosoj estas elekti tekstan kontraston, kiu faciligas la legadon, precipe en kombinaĵo kun la fono.

La aplikaĵo Kontrast estas kolorkontrasta kontrolilo. Ĝi diras al vi, ke la tekstkoloro kaj fonkoloro-kombinaĵoj estas legeblaj kaj alireblaj, do ĉi tio estas bonega ilo por helpi vin krei kolorajn etosojn.

Vi povas elŝuti Kontrast de la KDE Aplika retejo aŭ de la pako Flatpak sur Flathub (nur en GNU/Linukso) .

La aplikaĵo GNOME Kontrasto estas simila. Vi povas elŝuti la Flatpak-pakaĵon sur Flathub (nur en GNU/Linukso).

KSyntaxHighlighting inkluzivas pli ol 300 sintaksajn difinojn, tial estas ideale, ke vi certigu, ke via nova etoso aspektas bone en ĉiuj sintaksreliefigaj difinoj. La enkonstruitaj koloretosoj havas la jenajn similecojn, kiujn rekomendindas (sed ne devige) sekvi por atingi ĝustan montradon de ĉiuj sintaksemfazaj difinoj:

Plej multaj el la sintaksajemfaziloj estas intencitaj aspekti bone en la defaŭltaj etosoj “Breeze Light” kaj “Breeze Dark”, do alia maniero konservi koherecon estas uzi similajn kolorojn en la tekstaj stiloj, kiel verda por “Antaŭprocesoro” kaj “Aliaj”, blua por “Datumtipo” kaj “Atributo”, aŭ purpura por “Funkcio”.

Notu, ke ĉi tiuj rekomendoj ne estas devigaj dum kreado kaj publikigado de etoso.