Renk temaları, JSON biçimli dosyalarda .theme uzantısıyla depolanır.

KSyntaxHighlighting kaynak kodunda, yerleşik temaların JSON dosyaları data/themes/ dizininde bulunur. Metin düzenleyicilerinde yerleşik temaların KSyntaxHighlighting kitaplığıyla derlendiğine dikkat edin; dolayısıyla, onlara erişmek ya kaynak kodundan ya da KTextEditor temalarını yönetmek üzere grafik arayüzden dışa aktarılarak olanaklıdır.

Dosya sisteminden, ek veya özel temaları kolaylıkla eklemek olanaklıdır. Kullanıcılar tarafından özelleştirilen tema dosyaları, kullanıcı klasörünüzdeki org.kde.syntax-highlighting/themes/ dizininde bulunur; bu dizini qtpaths --paths GenericDataLocation komutuyla bulabilirsiniz ve genellikle $HOME/.local/share/ ve /usr/share/ dizinleridir.

Flatpak ve Snap paketlerinde, yukarıdaki dizin işe yaramaz; çünkü her uygulamanın veri konumu farklıdır. Bir Flatpak uygulamasında, özel dosyaların konumu genellikle $HOME/.var/app/flatpak-paketi-adı/data/org.kde.syntax-highlighting/themes/ ve bir Snap uygulamasında ise $HOME/snap/snap-paketi-adı/current/.local/share/org.kde.syntax-highlighting/themes/ olarak kullanılır.

Windows®’ta bu dosyalar genelde C:\Users\user-name %USERPROFILE%\AppData\Local\org.kde.syntax-highlighting\themes olarak genişleyen %USERPROFILE% konumundadır.

Özet olarak, çoğu yapılandırmada özel tema dizinleri aşağıdaki gibidir:

Aynı adlı birden çok tema dosyası varsa en yüksek revision’a (revizyona) sahip dosya yüklenir.

Bir JSON dosyasının yapısı web sitelerinde açıklanmıştır. Temel olarak, bir JSON biçimi şunlardan oluşur:

Bu yazıda, “anahtar”, “değer”, “nesne” ve “diziliş” ögeleri kullanılacaktır. JSON dosyalarıyla ilk tanışmanız ise onları anlamanın en kolay yolu aşağıdaki örneklere bakmaktır.

JSON renk teması dosyalarının kök nesnesi aşağıdaki şema anahtarlarını içerir:

JSON dili yorumları desteklemez. Ancak, yorumlar yazmak için kök nesnede isteğe bağlı _comments anahtarını kullanabilirsiniz. Bu örneğin, önceden var olan bir temayı uyarlıyorsanız özgün deponun URL’sini buraya koyabilirsiniz. En pratik yolu, diziler içeren dizilişler kullanmaktır.

Aşağıda “Esinti Açık” teması için bir örnek dosyayı görebilirsiniz. Örneğin pek büyük olmasını engellemek için editor-colors ve text-styles nesnelerinin tüm gerekli anahtarları içermediğine dikkat edin. “Esinti Açık” temasının tam arşivini KSyntaxHighlighting deposunda bulabilirsiniz.

{
    "_comments": [
        "Bu bir yorumdur.",
        "Bu tema bir başkasından uyarlanmışsa özgün deponun bağlantısını buraya koyun."
    ],
    "metadata": {
        "name" : "Esinti Açık",
        "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",
        Diğer düzenleyici renk anahtarları…

    },
    "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"
        },
        Diğer metin biçemi anahtarları…

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

metadata anahtarının JSON nesnesi, tema üzerine aşağıdaki ilgili bilgiyi içerir. Bu nesnedeki anahtarlar aşağıdaki gibidir:

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

Metin düzenleme alanı renklerine karşılık gelir.

JSON tema dosyasında, ilgili editor-colors anahtarının, her bir anahtarın metin düzenleyicisinin renk özniteliğine başvurduğu bir object değeri vardır. Burada, tüm anahtarlar zorunludur, değerleri ise “#00B5CF” gibi onaltılık renk değerlerine sahip dizilerdir.

KTextEditor tema yönetim arayüzünde, bu öznitelikler Renkler sekmesinde yapılandırılabilir.

Kullanılabilir anahtarlar aşağıdaki gibidir; JSON dosyasında kullanılan anahtarlar kalın ile, grafik arayüzde kullanılan adlar parantez içinde gösterilirler.

Öntanımlı metin biçemleri, vurgulanan metin biçemleri tarafından devralınır ve bu, düzenleyicinin metni çok tutarlı bir biçimde sunmasına olanak tanır; örneğin, yorum metni, KSyntaxHighlighting’in vurgulayabildiği hemen hemen tüm metin biçimlerinde aynı biçemi kullanır.

JSON dosyasında, ilgili text-styles anahtarının değeri bir object’e sahiptir; burada her anahtar, sözdizim vurgulama tanımlarında kullanılanlara eşdeğer olan bir öntanımlı metin biçeminin adına karşılık gelir. Burada, zorunlu olan kullanılabilir tüm metin biçemi anahtarları aşağıda listelenmiştir.

"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"
    },
    Diğer metin biçemi anahtarları…
}

KTextEditor renk temalarını yönetmek için kullanılan arayüzde, bu öznitelikler Öntanımlı Metin Biçemleri sekmesinde değiştirilebilir. Biçem listesindeki ad, öge için yapılandırılan biçemi kullanır ve bir biçemi yapılandırırken size anında bir önizleme sağlar. Her biçem, ortak özelliklerin yanı sıra ön plan ve arka plan renklerini de seçmenize olanak tanır. Bir arka plan rengini kaldırmak için bağlam menüsünü kullanmak üzere sağ tıklayın.

Kullanılabilir metin biçemi anahtarları aşağıda listelenmiştir; JSON dosyasında kullanılan anahtarlar kalın ile, grafik arayüzde kullanılan adlar ise farklılarsa parantez içinde gösterilirler.

Burada, önceki bölümde açıklanan öntanımlı metin biçemini geçersiz kılarak, belirli bir sözdizim vurgulama tanımı için metin biçemleri oluşturabilirsiniz.

JSON tema dosyasında bu, değeri her alt şema anahtarının bir sözdizimi vurgulama tanımının adına karşılık geldiği bir nesne olan custom-styles anahtarına karşılık gelir. Onun değeri, her bir anahtarın sözdizim tanımlama XML dosyasının itemData ögesinde tanımlı biçem öznitelikleri adına başvuran bir nesnedir. İlgili değer, text-color, selected-text-color, bold, italic, underline, strike-through, background-color ve selected-background-color anahtarlarıyla bir alt nesnedir. Bu alt nesne, bir önceki bölümde tanımlanmıştır. Bu değerlerin her biri isteğe bağlıdır; eğer yoklarsa text-styles içinde tanımlı biçem kümesi değerlendirilir.

Örneğin bu kod parçasında, “ISO C++” sözdizim vurgulama tanımında “Type Modifiers” ve “Standard Classes” öznitelikleri için özel bir metin biçemi vardır. Karşılık gelen “isocpp.xml” XML dosyasında tanımlı “Standard Classes” özniteliği BuiltIn (veya dsBuiltIn) öntanımlı biçemini kullanır. Bu öznitelikte, yalnızca text-color değerinin yeni “#6431b3” değeriyle üzerine yazılır.

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

KTextEditor tema yönetim arayüzünde, bu öznitelikler Vurgulama Metin Biçemleri sekmesinde yapılandırılabilir. Öntanımlı olarak düzenleyici, geçerli belgenin vurgulamasını önceden seçer. Pek çok vurgunun, biçem listesindeki gruplar tarafından temsil edilen diğer vurguları içerdiğini fark edeceksiniz. Örneğin, öne çıkanların çoğu “Alert” vurgusunu içe aktarır ve birçok kaynak kodu biçimi de “Doxygen” vurgusunu içe aktarır.

Yeni bir tema oluşturmak için öncelikle var olan bir tanesini kopyalamanız gerekir. “Esinti Açık” veya “Esinti Koyu” gibi temel olarak kullanmak istediğiniz var olan bir temayı seçin ve Kopyala’ya tıklayın. Daha sonra yeni tema için bir ad yazın.

Yerleşik veya saltokunur bir temayı değiştirmek istiyorsanız önce onu farklı bir adla kopyalamanız gerekir.

Seçili bir temayı (yerleşik olanları da) bir JSON dosyasına .theme uzantısıyla Dışa Aktar düğmesini kullanarak dışa aktarabilirsiniz. Bu, dosyayı kaydetmek için bir iletişim kutusu açacaktır. Başka dış bir JSON dosyasından bir renk teması eklemek için İçe Aktar düğmesine basın ve iletişim kutusundan .theme dosyasını seçin.

Renk temalarıyla çalışırken önemli bir konu, özellikle arka planla birlikte okumayı kolaylaştıracak bir metin karşıtlığı seçmektir.

Kontrast uygulaması bir renk karşıtlığı denetleyicisidir. Size metin rengi ve arka plan rengi kombinasyonlarının okunabilir ve erişilebilir olduğunu söyler; dolayısıyla bu, renk temaları oluşturmanıza yardımcı olacak mükemmel bir araçtır.

Kontrast uygulamasını from KDE uygulamaları web sitesinden veya Flathub’daki Flatpak paketiyle indirebilirsiniz (yalnızca GNU/Linux).

GNOME Contrast uygulaması da benzer bir uygulamadır. Flathub’daki Flatpak paketiyle indirebilirsiniz (yalnızca GNU/Linux).

Syntax Highlighting deposundaki bir Python betiği, bir temadaki tüm renkleri ve tüm arka planlardaki karşıtlığı ayarlamanıza olanak tanır.

KSyntaxHighlighting, 300’den fazla sözdizimi vurgulama tanımı içerir, bu nedenle yeni temanızın tüm sözdizim vurgulama tanımlarında iyi göründüğünden emin olmanız idealdir. Yerleşik renk temaları, tüm sözdizim vurgulama tanımlarının doğru bir şekilde görüntülenmesini sağlamak için takip edilmesi önerilen (ancak zorunlu olmayan) aşağıdaki benzerliklere sahiptir:

Çoğu sözdizim vurgulayıcı, öntanımlı “Esinti Açık” ve “Esinti Koyu” temalarında güzel görünmesi için tasarlanmıştır; dolayısıyla, tutarlılığı korumanın bir başka yolu da metin biçemlerinde benzer renkler kullanmaktır; örneğin, “Preprocessor” ve “Others” için yeşil; “DataType” ve “Attribute” için mavi veya “Function” için mor.

Bir tema oluştururken ve yayımlarken bu önerilerin zorunlu olmadığını unutmayın.