Bu bölüm, Kate'i, onunla çalışmak isteyebileceğiniz biçimde tez yapılandırabilmeniz için Görünüm menüsündeki bazı öğeleri açıklar.

Kate'i ilk başlattığınızda, beyaz arka planlı iki pencere göreceksiniz. İki pencerenin üstünde, her zamanki etiketli simgelerin yer aldığı bir araç çubuğu bulunur. Onun üstünde de bir menü çubuğu vardır.

Soldaki pencere bir kenar çubuğudur. Belgeler ve Dosya Sistemi Tarayıcısı pencerelerini birleştirir. Pencerenin solundaki sekmelere tıklayarak ikisi arasında geçiş yapın.

Kate'i bir dosya ile başlatırsanız sağdaki pencere düzenlediğiniz dosyayı ve kenar çubuğundaki Belgeler dosyanın adını gösterir. Dosyaları açmak için Dosya Sistemi Tarayıcısı'nı kullanın.

Görünüm → Araç Görünümleri menüsünü veya Kontrol+Seçenek+Üst Karakter+F kısayolunu kullanarak tüm kenar çubuğu pencerelerini açıp kapatabilirsiniz. Bu menü, Kate'in gücüne ve esnekliğine bir giriş niteliğindedir.

Araç Görünümü bölümünde tüm etkin eklentilerin bir listesi vardır. Bu araç görünümünü açıp kapatmak için her bir ögenin önündeki onay kutularına veya kenar çubuğundaki araç düğmelerine Sol Fare Düğmesi ile tıklayın.

Kate'in düğme vuruşu komutlarının (kısayollarının) çoğu Ayarlar menüsü ile yapılandırılabilirdir. Öntanımlı olarak Kate aşağıdaki düğme bağıntılarını izler.

Ek olarak, KatePart bileşeni ve tüm etkin Kate eklentileri tarafından sağlanan klavye kısayollarını da kullanabilirsiniz.

Pencere, Görünüm, Belge, Çerçeve, Düzenleyici... Kate terminolojisinde bunlar nedir ve bunların çoğunu nasıl anlarsınız? Bu bölüm, bunların tümünü ve çok daha fazlasını anlatacaktır.

Kate, Konqueror'ın veya popüler metin düzenleyicisi emacs'in çalışma biçimine benzer olarak, aynı anda birden çok belgeyi açabilir ve düzenleme alanını istediğiniz sayıda çerçeveye bölebilir. Böylece, aynı anda birden çok belgeyi veya aynı belgenin birden çok örneğini görüntüleyebilirsiniz. Bu örneğin, belgeniz en üstte tanımlar ve altta da tanımlara başvurular içeriyorsa ikisini aynı anda görebilmek için yararlıdır. Başka bir örnek olarak, bir program kaynağı üstbilgisini bir çerçevede görebilir, uygulanmasını da başka bir çerçevede düzenleyebilirsiniz.

Bir belge birden fazla düzenleyicide kullanıldığında, bir düzenleyicide yapılan değişiklikler anında diğerlerine de yansıtılacaktır. Bunda metin değiştirmenin yanı sıra metin seçme de içerilir. Arama işlemleri veya imleç hareketi yalnızca geçerli düzenleyiciye yansıtılır.

Bir örneğin düzenlenirken diğerinin düzenlenmeyeceği anlamında aynı belgenin daha fazla örneğinin açık olması şu anda olanaklı değildir.

Bir düzenleyiciyi iki çerçeveye böldüğünüzde, her ikisi de o düzenleyicinin geçerli belgesini görüntüleyen eşit boyutlu iki çerçeveye bölünür. Yeni çerçeve altta (yatay bölme durumunda) veya sağda (dikey bölme durumunda) olacaktır. Yeni kare, odaklanılan karedeki yanıp sönen imleç çubuğuyla görselleştirilen odağı alır.

Tez Aç’ı kullanmak çok basittir. Açtığınızda, açmak istediğiniz dosyanın adını veya adının bir kısmını yazmanız yeterlidir; Tez Aç, yazdıklarınıza göre listeyi süzer. Giriş düğmesine basmak seçili dosyayı açar, Vazgeç ise Tez Aç’ı gizler.

Öntanımlı olarak, süzme sırasında yalnızca dosya adı eşleştirilir. Yolu eşleştirmek isterseniz yazılan metinde bir "/" olmalıdır. Örneğin: "belge/indeks", "belge" klasöründe "indeks" içeren tüm belgelerle eşleşecektir.

Halihazırda açık olan belgeler kalın harflerle vurgulanır ve iletişim kutusu açıldığında en üstte listelenir. Ayrıca, Tez Aç görüntülendiğinde önceki açık belge halihazırda seçilidir, böylece yalnızca Giriş düğmesine basabilirsiniz ve bu sizi o belgeye götürecektir.

Tez Aç, birkaç yapılandırma seçeneği sağlar. Bu seçeneklere ulaşmak için giriş satırında sağ tıklayın.

Kate henüz düzenlediğiniz projelere ilişik belgelendirmeleri (örneğin kod veya API belgelendirmesi) okumak için henüz bir yordan sağlamıyor. Düzenlediğiniz dosyaya bağlı olarak, UNIX® kılavuz sayfalarını görüntülemek için Yerleşik Uçbirim Öykünücüsü'nü veya Konqueror'ı kullanabilirsiniz.

Kate'in ana sayfası, bu el kitabının kapsamı dışında olan bazı Yazılar ve Nasıl Yapılırlar sağlar.

Bir aracı düzenlemek, aracın ayrıntılı şekilde yapılandırılmasına olanak tanıyan bir yapılandırma iletişim kutusunu açar:

Öntanımlılar düğmesi yalnızca Kate ile birlikte gönderilen araçlar için görünür. Tıklandığında, aracın tüm ayarları öntanımlı (diğer bir deyişle fabrika) değerlerine döndürülür.

Yürütülebilir, Argümanlar, Girdi ve Çalışma Dizini gibi kimi düzenleme alanları, araç çağrıldığında genişletilen değişkenleri desteklerler. Bu, bu metin giriş alanlarından biri odağı aldığında görünen {} simgesiyle gösterilir:

Bu metin giriş alanlarından birinin üzerine gelindiğinde geçerli genişletilmiş metni içeren bir araç ipucu da gösterilir. Ayrıca, {} eylemine tıklamak, kullanılabilir tüm değişkenleri listeleyen bir iletişim kutusu açacaktır:

Bu özellik, bir dış araç tanımlarken pek çok esneklik sağlar; çünkü %{...} biçimindeki tüm değişkenler, araç çağrıldığında genişletilirler. İki tür desteklenen değişken vardır:

İlk %{variable-name} biçimi, değişkeni içeriğiyle değiştirir. Örneğin, %{Document:FileName} değişkeni geçerli belgenin yol içermeyen dosya adıyla değiştirilir. İkinci %{variable-name:<value>} biçimi, içeriği olarak <value> alır. Örneğin, bu, %{ENV:HOME} ile bir çevre değişkenini genişletmek veya geçerli tarihi yeğlenen %{Date:yyyy-MM-dd} biçiminde almak için kullanılabilir.

Öntanımlı olarak çeşitli araçlar sağlanır. Ancak, daha yararlı araçlarınız varsa lütfen bunları (kwrite-devel AT kde.org) adresine gönderin, böylece onları bu listeye ekleyebiliriz. Tüm öntanımlı araçlar öntanımlı olarak liste görünümünde görünür. Bununla birlikte, kategori ve hatta araçların silinmesi de dahil olmak üzere tüm araçlar beğeninize göre değiştirilebilir. Silinen araçlar, yukarıda anlatıldığı gibi yapılandırma sayfasındaki Ekle düğmesine basılarak yeniden eklenebilir.

Bu eklenti geliştiricilere yöneliktir ve büyük olasılıkla düz kullanıcılar için pek kullanışlı değildir. Kate araç görünümündeki liste görünümünde gdb tarafından sağlanan bir geri izi gösterir. Bir ögeye tıklamak seçili dosyayı açar ve doğru satır numarasına atlar. Hem kendi makinenizde oluşturulan geri izler hem de başkalarından gelen geri izler için de çalışır; yani /home/dummy/qt-copy/…/qwidget.cpp başka makinelerde de bulunur. Bunun çalışması için kaynak kodun bulunduğu dizinleri indekslemeniz gerekir.

Bazen aynı ada sahip birden çok dosya olabilir; örneğin,

Doğru seçimi seçmek için eklenti URL'nin son iki bölümünü seçer; bu durumda bu şu şekilde olur:

Ve sonra genellikle eklenti doğru olanı bulur.

Ana dal ve diğer dalları indekslemek elbette bir çatışmaya yol açacaktır.

Yapılandırma sayfasında kaynak kodunu içeren dizinleri ekleyin.

Geri iz tarayıcısı araç görünümünde yolları yapılandır

Tamam'a tıklamak indekslemeyi başlatır. İndeksleme bittiğinde Geri İz Tarayıcısı araç görünümünü açın.

Artık panodan (örneğin, DrKonqi'de Panoya Kopyala'ya tıkladığınız zaman) veya bir dosyadan bir geri iz yükleyebilirsiniz.

Yapı eklentisi; bir projeyi yapım, temizlik ve derleme gibi eylemleri çalıştırmanıza olanak tanır.

Yapı eklentisi, alt tarafa bir Yapı Çıktısı araç görünümü ve menü çubuğuna bir Yapı menüsü ekler. Araç görünümü yapı hedefi ayarlarını yapılandırmak için kullanılabilirken menü; oluşturma, temizleme ve derleme eylemlerini gerçekleştirmek için kullanılabilir.

Yapı Çıktısı araç görünümü iki sekmeye sahiptir:

Hedef Ayarları sekmesi

Hedef ayarları sekmesi, çeşitli yapı hedefleri yapılandırmak ve hedef kümeleri tanımlamak için kullanılabilir.

Adları veya komutları değiştirmek için tablodaki girdilere çift tıklayın ve etkin hedef kümesini seçmek için açılır kutuyu kullanın. Bir öntanımlı değer tanımlamak için her hedefin önündeki onay kutusunu kullanın.

Yeni bir hedef kümesi birçok yapılandırma seçeneği içerir:

Çalışma Dizini

Burada projeye giden yolu ayarlayabilirsiniz. Geçerli belgenin bulunduğu dizini kullanmak için bunu boş bırakın.

Yapı

Bu seçenek, yapı komutunu tanımlamanıza olanak tanır. Öntanımlı olarak make biçiminde ayarlıdır.

Temizle

Bu seçenek, temizleme komutunu tanımlamanıza olanak tanır. Öntanımlı olarak make clean biçiminde ayarlıdır.

Yapılandırma

Bu seçenek, yapılandırma komutunu tanımlamanıza olanak tanır. Öntanımlı olarak cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../ biçiminde ayarlıdır.

Bu eklentinin üst kısmında aşağıdaki düğmelerin bulunduğu bir araç çubuğu bulunur:

Seçili hedefi yap

Yeni hedef ekle

Yeni hedef kümesi oluştur

Komutu veya hedef kümesini kopyala

Geçerli hedefi veya geçerli hedef kümelerini sil

Kate Yapı Eklentisi, Kåre Särs tarafından yazıldı.

Bu bölümün çoğunu yazdığı için Google Code-In 2011 katılımcısı Salma Sultana’ya özellikle teşekkür ederiz.

Bu eklenti, bir grup belgeyi uzantılarına ve yollarına göre kapatmanıza olanak tanır.

Kate'de aşağıdaki belgeleri açtığınızı varsayalım:

Ardından, ekran görüntüsünde gösterildiği gibi belgeleri kapatmak için aşağıdaki seçeneklere sahipsiniz:

Onay iletişim kutusunu etkinleştirmek veya devre dışı bırakmak için listenin son ögesindeki onay kutusunu kullanın. Seçili seçenek her iki kapatma işlemine de uygulanacaktır.

Bu eklenti, metindeki renklere satır içi renk önizlemesi/seçicisi ekler (örneğin, #FFFFFF, white).

Bu eklentiyi yüklemek için Ayarlar → Kate Uygulamasını Yapılandır... altından Kate'in yapılandırma iletişim kutusunu açın. Sonrasında, Renk Seçicisi'ni seçin ve iletişim kutusunu kapatın.

Kate'in yapılandırmasındaki Renk Seçicisi ayarları sayfasında eklenti davranışının aşağıdaki seçeneklerini yapılandırabilirsiniz.

Okunabilirliği artırmak için farklı renklerdeki ayraç çiftleriyle eşleşen renkli ayraç eklentisi. Ancak tüm ayraçlar renklendirilmez. Eşleşen açıcısı veya kapatıcısı görünmeyen bir ayraç dikkate alınmayacaktır. Benzer şekilde, bir çizgideki tek ayraç çifti olan ayraç çifti renklendirilmez.

Bu eklenti, herhangi bir yapılandırma seçeneği sunmaz.

CTags, Kate'deki bu eklentiyi kullanarak kaynak dosyalardaki ögelerin kolaylıkla bulunabilmesini sağlayan bir dil nesneleri indeksi (veya etiketi) üretir.

Etiket, bir dizin girdisinin kullanılabilir olduğu bir dil nesnesini (veya alternatif olarak o nesne için oluşturulan dizin girdisini) belirtir.

Etiket üretimi, bu programlama dilleri için desteklenir.

CTags eklentisi, indeksleme için iki farklı veritabanı dosyası kullanır.

Kate'in yapılandırmasındaki CTags ayarları sayfasında, kaynak kodunu içeren dizinleri ekleyebilir veya kaldırabilir ve ortak CTags veritabanını yeniden oluşturabilirsiniz.

Genel İndeks

CTags Genel Veritabanını Yapılandır

Ayarlar sayfasının alt kısmında CTags komutunu uyarlayabilirsiniz.

Kullanılabilir tüm seçenekler için lütfen CTags man sayfasını okuyun. Bu man sayfasına KHelpCenter içinden erişilebilir veya man:/ctags URL'sini doğrudan Konqueror'a girebilirsiniz.

Güncelle'ye tıklamak indekslemeyi başlatacaktır. Dizin oluşturma tamamlandığında iletişim kutusunu kapatın.

Fare imlecini ilgilendiğiniz işlev, sembol vb. dil nesnesinin üzerine yerleştirirsiniz ve ardından nesnenin tanımlandığı veya beyan edildiği satıra ve dosyaya geçmek için CTags menüsündeki eylemlerden birini seçersiniz.

Öntanımlı olarak, CTags menüsündeki eylemlerde atanan klavye kısayolları yoktur. Kendi kısayollarınızı yapılandırmak için klavye kısayolları düzenleyicisini kullanın.

Alternatif olarak CTags görünümünün Arama sekmesindeki arama alanını kullanın.

Arama alanına karakterlerin girilmesi, aramayı başlatacak ve işlevler, sınıflar, semboller vb. gibi dil nesnelerinin eşleşen adlarını tür ve dosya adıyla birlikte görüntüleyecektir.

Kaynak dosyadaki ilgili satıra atlamak için listeden bir öge seçin.

Eklenti, halihazırda düzenlenen metin belgesinin kenar çubuğunda son biçiminin canlı önizlemesini sağlar. Örneğin, bir Markdown metni veya SVG görseli düzenlerken, çıktı, kaynak metnin yanında anında görünür.

Görüntüleme için eklenti, şu anda belgenin MIME türü için tercih edilen olarak seçili KParts eklentisini kullanır. Bu tür için KParts eklentisi yoksa önizleme olanaklı değildir.

Tercih edilen eklentiyi değiştirmek için Sistem Ayarları içindeki Dosya İlişkilendirmeleri modülünü açın ve Gömme sekmesindeki Hizmetler Tercih Sırası bölümünü düzenleyin.

Önizleme penceresinin üstündeki düğmeler şu eylemleri sağlar:

Yukarıdan aşağıya doğru, Dosya Sistemi Tarayıcısı aşağıdaki ögelerden oluşur:

Bu eklenti, Kate yapılandırmasının Dosya Sistemi Tarayıcısı sayfasında yapılandırılabilir.

Belgeler listesi, o anda Kate'de açık olan tüm belgelerin bir listesini görüntüler. Değiştirilen dosyaların sol tarafında bu durumu belirtmek için küçük bir disket simgesi bulunur.

Belgeler listesinin üst kısmında aşağıdaki düğmeleri içeren bir araç çubuğu bulunur:

Yeni belge oluştur

Var olan bir belgeyi aç

Önceki Belge

Sonraki Belge

Geçerli belgeyi kaydet

Geçerli belgeyi yeni bir adla kaydet

Öntanımlı olarak Belgeler Listesi, o anda açık olan tüm belgeleri çevreleyen klasör yapısını görüntüleyen Ağaç Kipi'nde görünür. Ayrıca tüm açık belgelerin basit bir listesini görüntüleyen Liste Kipi de kullanılabilir. Listeye sağ tıklayıp Görüntüleme Kipi menüsünden seçim yaparak modları değiştirebilirsiniz.

Liste Kipi'nde farklı klasörlerde bulunan aynı adlı iki dosya açıksa ikinci dosyanın adının sonuna “(2)” ve artan sayılar iliştirilecektir. Dosyanın araç ipucu, yol da dahil olmak üzere tam adını görüntüleyecek ve istediğiniz dosyayı seçmenize olanak tanıyacaktır.

Bir belgeyi o anda etkin olan çerçevede görüntülemek için listedeki belge adına tıklayın.

Bağlam menüsünde Dosya menüsündeki bazı ortak işlemler bulunur.

Ayrıca dosyayı yeniden adlandırmak veya silmek için dosya yöneticisi eylemleri vardır. Konumu Kopyala ile belgenin tam yolunu panoya kopyalayabilirsiniz.

Listeye sağ tıklayıp Şuna Göre Sırala menüsünden seçim yaparak listeyi birkaç farklı şekilde sıralayabilirsiniz. Seçenekler şunlardır:

Belge listesi öntanımlı olarak, en yeni belgelerin girdilerini bir arka plan rengiyle gölgeleyerek geçmişinizi görselleştirecektir. Belge düzenlenmişse fazladan bir renk eklenir. En yeni belge en güçlü renge sahiptir, böylece üzerinde çalıştığınız belgeleri kolayca bulabilirsiniz. Bu özellik, yapılandırma iletişim kutusunun Belgeler sayfasında devre dışı bırakılabilir.

Kate penceresindeki belge listesinin öntanımlı konumu düzenleme alanının soludur.

Kate'in GDB eklentisi, popüler GNU Proje Hata Ayıklayıcısı için temel bir ön yüz sağlar.

GDB eklentisini, Kate yapılandırmasının Eklentiler bölümünden etkinleştirebilirsiniz.

Eklentinin düzgünce çalışması için bir kaynak dosyasına (GDB tarafından desteklenen herhangi biri) ve bir yürütülebilire gereksiniminiz olacak.

Bu hazırlıklar tamamlandıktan sonra, kaynak dosyasını Kate ile açın, Hata Ayıklama Görünümü'nün Ayarlar sekmesini kullanarak yürütülebilirin yolunu girin ve menüden Hata Ayıklama → Hata Ayıklamayı Başlat'ı seçerek başlayın.

Bu seçeneklerin tümüne Kate'in menülerinden ve çoğuna Hata Ayıklama araç çubuğundan da ulaşılabilir.

Hata Ayıklama Görünümü araç çubuğu, çeşitli sekmelerden oluşur:

Çağrı Yığını araç görünümü, GDB'den dönen biçimlendirilmiş bir geri iz listesi içerir.

GDB eklentisinin Çağrı Yığını araç görünümü.

Yereller araç görünümü, programdan o anda yüklü olan tüm değişkenlerin ve bunlara karşılık gelen değerlerin bir listesini içerir.

GDB eklentisinin Yereller araç görünümü.

Bu bölümün çoğunu yazan Google Code-In 2011 katılımcısı Martin Gergov’a özellikle teşekkürler.

Project eklentisinin temel fikri, aşağıdaki özelliklere sahip, projeye ait dosyaların yapılandırılmış bir listesine sahip olmaktır:

Proje eklentisi Kate yapılandırma sayfasına yüklendikten sonra, bir projede bir dosya açın; tüm projelerin yanı sıra proje dosyalarını da listeleyen bir kenar çubuğu aşağıdaki gibi görünür:

Gördüğünüz gibi şu anda etkin olan proje “Kate”'tir ve içeriği ağaç görünümünde listelenmektedir. Ağaç görünümünde dosyalara tıklamak, dosyayı düzenleyicide açar. Ayrıca, Qt Designer ile .ui dosyası gibi dosyaları diğer uygulamalarla açabileceğiniz bir bağlam menüsü de sağlanır.

Aradığınız dosya adının bazı kısımlarını listenin alt kısmındaki arama çubuğuna yazarak ögeleri süzebilirsiniz.

Buradaki fikir hiçbir zaman bir projeyi elle açmak zorunda kalmamanızdır, hatta bu hiç desteklenmemektedir. Bu nedenle, bir dosyayı açtığınızda olan şey şudur; proje eklentisi tez klasörü ve onun üst klasörlerini bir .kateproject dosyası için tarar. Bulunursa proje kendiliğinden yüklenir.

Ayrıca Kate'de başka bir projeye ait başka bir belge açarsanız proje eklentisi kendiliğinden geçerli projeye geçiş yapar. Yani sezgisel olarak her zaman doğru proje etkindir. Tabii ki, halihazırda etkin olan projeyi açılır kutuyu kullanarak da değiştirebilirsiniz.

Kate'in alt kenar çubuğunda görünen bir Ara ve Değiştir eklentisi vardır. Bir proje yüklüyse Ara ve Değiştir kenar çubuğunu açın ve geçerli projede arama ve değiştirme kipine geçin:

Bir projeye ait tüm dosyalar hakkında bilgi sahibi olan proje eklentisi, CTags’lere dayalı temel kendiliğinden tamamlama olanakları sağlar. Bir proje başlangıçta açılırsa CTags tüm proje dosyalarını bir arka plan iş parçacığında ayrıştırır ve CTags bilgisini /tmp dosyasına kaydeder. Bu dosya daha sonra Kate’deki kendiliğinden tamamlama açılır penceresini doldurmak için kullanılır.

Bunun aksine, bu kendiliğinden tamamlama olmadan Kate yalnızca geçerli dosyadaki sözcüklere dayalı olarak kendiliğinden tamamlama ögelerini gösterebilir. Demeli ki, proje eklentisinin sağladığı kendiliğinden tamamlama çok daha güçlüdür.

CTags eksikse, pasif bir açılır pencere sizi bu konuda uyarır. Kate çıktığında /tmp konumundaki CTags dosyası temizlenir, böylece eklenti, sisteminizi gereksiz dosyalarla kirletmez.

Bir diğer özellik ise Yapı Eklentisi desteğidir; böylece kendiliğinden düzgünce yapılandırılır.

Projeler → Git (Seçenek+1) menüsünü kullanarak, düzenleyici penceresinin altında dört adet sekmeyle görünecek olan Geçerli Proje görünümünü açabilirsiniz:

Projeler menüsü, şu anda açık olan projeler arasında geçiş yapmanızı sağlar. Proje eklentisi tarafından görüntülenir.

Uygun olması halinde, aşağıdaki açıklamada karşılık gelen bir LSP komutundan da söz edilmektedir; bunun belgelendirmesi daha sonra ek arka plan ve yorum sağlayabilir; ancak gerçek dile bağlı olarak değişiklik gösterebilir. 'Geçerli sembol' ifadesi, dil ve sunucu uygulaması tarafından belirlenen geçerli imleç konumuna karşılık gelen simgeyi ifade eder.

LSP İstemcisi, projenizdeki veya geçerli dosyanızdaki herhangi bir sembole atlamanıza yardımcı olabilir. Dosyadaki herhangi bir sembole atlamak için Kate’in sağ kenarındaki "LSP İstemcisi Sembolü Ana Hattı" araç görünümünü kullanın. Bu araç görünümü, sunucu tarafından geçerli belgede bulunan tüm sembolleri listeler.

Clangd kaynak üstbilgisini değiştirme komutu desteklenir. Bir C veya C++ projesinde kaynak üstbilgisini değiştirmek için bağlam menüsündeki "Kaynak Üstbilgisini Değiştir" seçeneğini veya F12 kısayolunu kullanın.

Farenizi bir sembolün üzerine getirip Kontrol + sol fare düğmesini kullanarak herhangi bir sembole kolaylıkla atlayabilirsiniz.

Eklentinin yapılandırma sayfası çoğunlukla yukarıdaki menü ögelerinin bazılarının kalıcı olarak yapılandırılmasına izin verir. Ancak Sunucu Yapılandırması dosyasını belirtmek için ek bir girdi daha vardır. Bu, başlatılacak LSP sunucusunu belirtmek (ve ardından stdin/stdout üzerinden iletişim kurmak) için kullanılabilecek bir JSON dosyasıdır. Kolaylık sağlamak amacıyla, eklentinin yapılandırma sayfasında incelenebilecek bazı öntanımlı yapılandırmalar eklenmiştir. Aşağıdaki açıklamaya yardımcı olmak için burada bu yapılandırmadan bir alıntı verilmiştir:

{
    "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.*$"
        }
    }
}

Her "komutun" bir diziliş veya dizi olabileceğini unutmayın (bu durumda bir dizilişe bölünmüştür). Ayrıca, üst düzey bir "global" girdi ("server"nun yanında) da dikkate alınır (aşağıya bakınız). Belirtilen ikili dosya olağan şekilde aranır; örneğin, PATH kullanarak. Özel bir konuma kurulursa ikincisinin genişletilmesi gerekebilir. Veya alternatif olarak, olağan PATH içindeki bir konumda bir sembolik bağlantı veya bir sarmalayıcı betik kullanılabilir. Yukarıda gösterildiği gibi standart konumlardan sonra aranacak bir "yol" da belirtilebilir.

"command", "root" ve "path" içindeki tüm girdiler değişken genişletmeye tabidir.

"highlightingModeRegex", Kate tarafından kullanılan vurgulama kipini sunucunun dil kimliğine eşlemek için kullanılır. Düzenli ifade verilmezse dil kimliğinin kendisi kullanılır. Bir "documentLanguageId" girişi false olarak ayarlanırsa belgeyi açarken sunucuya herhangi bir dil kimliği sağlanmaz. Bu, belge türünü belirlemede Kate kipine dayalı olarak yapmaktan daha hassas olan bazı sunucular için daha iyi sonuçlara sahip olabilir.

Yukarıdaki örnekte ana düşünce açıktır. Ek olarak, her sunucu girdi nesnesi, 'initialize' yönteminin bir parçası olarak sunucuya iletilen bir "initializationOptions" girdisine de sahip olabilir. Varsa 'workspace/didChangeConfiguration' bildirimi aracılığıyla sunucuya bir "settings" girdisi iletilir. "completionTriggerCharacters" veya "signatureTriggerCharacters" dizileri üyeleri "exclude" ve/veya "include" olan bir JSON nesnesi olarak belirtilebilir. Bunlar, sunucu tarafından sağlanan ilgili tetikleyici kümesine bazı karakterleri sırasıyla dışlamak veya eklemek için kullanılacaktır.

Üzerine yazma veya birleştirmenin çeşitli aşamaları uygulanır;

(root, servertype) kombinasyonu başına bir sunucu örneği kullanılır. "root" mutlak yol olarak belirtilirse olduğu gibi kullanılır, aksi takdirde “projectBase”'e görelidir (Proje Eklentisi tarafından belirlendiği üzere) varsa veya belgenin dizinine göre değilse. Belirtilmemişse ve "rootIndicationFileNames" dosya adı olarak bir dizilişse bu tür bir dosyayı içeren geçerli belgenin ana dizini seçilir. Alternatif olarak, "root" belirtilmemişse ve "rootIndicationFilePatterns" bir dosya dizgileri dizilişiyse geçerli belgenin dosya dizgisiyle eşleşen bir üst dizini seçilir. Son çare olarak ana dizin "root" olarak seçilir. Herhangi bir belge için ortaya çıkan "root", ayrı bir örneğin gerekli olup olmadığını belirler. Eğer öyleyse "root" rootUri/rootPath olarak iletilir.

Genel olarak, bir sunucu için o kadar da önemli olmadığından kökü belirtmeden bırakmanız önerilir (ancak sizin için aynı durum geçerli olmayabilir). Daha az sayıda sunucu örneği açıkça daha verimlidir ve aynı zamanda birçok ayrı örneğin görünümünden 'daha geniş' bir görünüme sahiptirler.

Yukarıda belirtildiği gibi, çeşitli girdiler değişken genişlemeye tabidir. Bunun "sarmalayıcı betik" yaklaşımlarıyla birleştirilmiş uygun bir uygulaması, birçok duruma göre özelleştirmeye olanak tanır. Örneğin, her biri kendi virtualenv kurulumuna sahip birden fazla projeden (örn. git depoları) oluşan bir python geliştirme senaryosunu düşünün. Öntanımlı yapılandırma kullanıldığında python dil sunucusu sanal ortamdan haberdar olmayacaktır. Ancak aşağıdaki yaklaşımla bu sorun çözülebilir. İlk olarak, LSPClient eklentisinin "Kullanıcı Sunucu Ayarları"na aşağıdaki parça girilebilir:

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

Yukarıdaki kök girdisi proje dizinine bağlıdır ve her proje için ayrı bir dil sunucusunun başlatılmasını sağlar; bu durumda her birinin farklı bir sanal ortamı olması nedeniyle bu gereklidir.

pylsp_in_env, aşağıdaki içerikle (düzeltilmek üzere) PATH'e yerleştirilmesi gereken küçük bir "sarmalayıcı betik"tir:

#!/bin/bash
cd $1
# sunucuyu (python-lsp-server) virtualenv içinde çalıştır
# (demek oluyor ki virtualenv değişkenleri ayarıyla)
# bundan dolayı virtualenv’i kaynakla
source XYZ
# sunucu durumu veya argümanlar değişebilir
exec myserver

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

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

Kate'in Ara ve Değiştir eklentisi, birçok farklı dosyadaki metni veya düzenli ifadeleri aynı anda aramanıza olanak tanır. Tüm açık dosyaları, bir dizindeki ve isteğe bağlı olarak alt dizinlerindeki tüm dosyaları veya etkin dosyadaki tüm dosyaları arayabilirsiniz. Hatta dosya adına göre süzebilirsiniz; örneğin, yalnızca belirli bir dosya uzantısıyla biten dosyaları arayabilirsiniz.

Kate Parçacıkları, “parçacık” (yeniden kullanılabilir kaynak, makine kodu veya metin) ekleme desteği sunarak size biraz zaman kazandırmayı amaçlayan bir eklentidir. Eklenti, kod tamamlama ve JavaScript destekler.

Kate parçacıkları için pano.

Panelde, parçacık depolarının bir listesini ve kendinizinkini oluşturma, bunları internetten alma veya yerel bir dosyadan yükleme seçeneklerini görmelisiniz. Her deponun, onu etkinleştirmek veya devre dışı bırakmak için kullanılabilecek bir onay kutusu vardır. Var olan depoları düzenlemek ve silmek için düğmeler de bulunur.

Depoları Oluşturmak ve Düzenlemek

Yeni bir parçacık deposu oluşturmak için Depo Ekle'ye tıklayın. Artık parçacık dosyasının, lisansının ve yazarının adını soran bir iletişim kutusu görmelisiniz. İstediğiniz seçenekleri belirledikten sonra Tamam'a tıklayın.

Depo düzenleyicisi arayüzü.

Parçacık deposu düzenleyicisi, aşağıdaki seçenekleri içerir:

Ad

Araç görünümündeki parçacıklar listesinde görünür ve ayrıca kod tamamlama özelliği kullanılırken de aranır.

Ad Alanı

Kod tamamlama kullanılırken kullanılan önek.

Lisans

Parçacık deponuz için lisansı seçin.

Yazarlar

Parçacık dosyasının yazar(lar)ının ad(lar)ını girin.

Dosya türleri

Parçacık deposunun uygulanmasını istediğiniz dosya türlerini seçin. Öntanımlı olarak “” olarak ayarlanmıştır, böylece depo tüm dosyalara uygulanır. Örneğin bunu C++ gibi bir şeyle değiştirebilir veya ögelere tıklayarak listeden seçim yapabilirsiniz. Türleri eklerken Üst Karakter düğmesine basarak birden fazla dosya türü belirleyebilirsiniz.

Parçacıkları Oluşturmak ve Düzenlemek

Parçacık düzenleyicisi arayüzü.

Ad

Ad, tamamlanma listesinde gösterilecektir.

Kısayol

Bu kısayola basmak, parçacığı belgeye ekleyecektir.

Parçacıklar

Parçacığınızın belgeye ekleyeceği metin.

Bir parçacık düzenlenebilir alanlar içerebilir. Sekme düğmesine basılarak bunlar arasında geçiş yapılabilir. Alan oluşturmak için şablon metninde aşağıdaki ifadeler kullanılabilir:

${field_name}, basit, düzenlenebilir bir alan oluşturur. Aynı field_name'in tüm sonraki oluşları, düzenleme sırasında ilkini yansılayan alanlar oluşturur.

${field_name=default}, alan için öntanımlı bir değer belirlemek üzere kullanılabilir. default, herhangi bir JavaScript ifadesi için kullanılabilir.

Öntanımlı olarak sabit bir dizi belirtmek üzere ${field_name=metin} kullanın.

${func(other_field1, other_field2, ...)}, her bir düzenlemede bir JavaScript işlevini değerlendiren ve içeriğini kapsayan bir alan oluşturmak için kullanılabilir. Daha fazla bilgi için Betikler sayfasına bakın.

${cursor}, diğer her şey doldurulduktan sonra imlecin konumunu belirtmek için kullanılabilir.

Betikler

Parçacıklarınızda kullanılmak üzere JavaScript yardımcı işlevleri.

Tüm JavaScript işlevleri, şablon alanına yerleştirmek istediğiniz içeriği bir dizi olarak döndürmelidir.

İşlevler, tüm düzenlenebilir şablon alanlarının içeriğini yerel değişkenler olarak içeren bir kapsamda çağrılır. Örneğin, ${field} içeren bir parçacıkta, şablon alanının güncel içeriğini sağlayan field adlı bir değişken bulunur. Bu değişkenler hem işlevde statik değişkenler olarak kullanılabilir hem de parçacık dizisindeki ${func(field)} veya ${field2=func(field)} sözdizimi kullanılarak argümanlar olarak geçirilebilirler.

Kate Betik Yazımı API’si kullanılarak seçili metni, tam metni, dosya adını ve daha fazlasını document ve view nesnelerinin uygun yöntemlerini kullanarak elde edebilirsiniz. Daha fazla bilgi için betik yazımı API’si belgelendirmesine bakın.

Daha karmaşık betikler için önce ham parçacığın belgeye eklendiğini ve sonrasında işlevlerin değerlendirildiğini anlamak önemlidir; örneğin, bir işlev, parçacığın eklendiği satırdaki metni alıyorsa o metin ayrıca ${functionCall()} içerecektir.

Betik yazımı API’sini kullanarak seçimlerle çalışmanın bir örneği olarak, seçili metni etiketlerin içine sarmanın basit bir yolu şu kod parçasıdır: <strong>${view.selectedText()}</strong>

Aşağıdaki örnek, seçim olmaması durumunda öntanımlı metni ekleyen bir betiği çağırır. Parçacık:

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

Betik:

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

Bir parçacıklar listesinden seçmek.

Parçacıkları iki yolla çağırabilirsiniz:

Parçacık değişkenler içeriyorsa (${cursor} dışında) imleç otomatik olarak bir değişkenin ilk geçtiği yere gidecek ve bir şey yazmanızı bekleyecektir. İşiniz bittiğinde bir sonraki değişkene geçmek için Sekme düğmesine basabilirsiniz.

Kate Parçacıkları, Joseph Wenninger tarafından yazıldı.

Bu bölümün çoğunu yazan Google Code-In 2011 katılımcısı Martin Gergov’a özellikle teşekkürler.

Klavye makroları kaydet ve oynat (örn. klavye eylem sıralamaları)

Onlara bir ad vererek klavye makroları kaydedilebilir.

Adlı makrolar Kate oturumları arasında kalıcıdır ve Kate’in kullanıcı verileri dizinindeki keyboardmacros.json dosyasına kaydedilirler (genellikle ~/.local/share/kate/).

Şu an itibariyle, bazı grafik arayüz araç takımları türleri kullanıldığında klavye makroları düzgün şekilde oynatılamıyor: örneğin QMenu, QuickOpenLineEdit veya TabSwitcherTreeView. Neden olduğundan emin değilim; ancak ilk tahminim bu araç takımlarının klavye olayları açısından standart olmayan bir şekilde çalıştığı yönünde.

Yapılandırılmış Sorgu Dili (SQL), veritabanlarından bilgi güncellemek, silmek ve talep etmek için özel bir dildir.

Kate SQL Eklentisi şunlara olanak tanır:

SQL menüsü veya araç çubuğundan Bağlantı Ekle'yi ve sonrasında kullanmak istediğiniz Qt™ veritabanı sürücüsünü seçin (QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7, and QPSQL içerilir). İstediğiniz sürücüyü göremiyorsanız onu kurmanız gerekir. Sonrasında Sonraki düğmesine basın.

Seçtiğiniz veritabanı bir dosya kullanıyorsa veritabanının konumunu belirtmeniz ve Sonraki düğmesine basmanız yeterlidir. Bir sunucuya bağlanmayı gerektiriyorsa sunucunun makine adını, kullanıcı adınızı ve parolanızı ve belirli bir sürücünün gerektirebileceği diğer bilgileri girmeniz gerekir. Daha sonra Sonraki'ye basın.

Son olarak bağlantınıza bir ad verin ve Bitir'e basın.

Soldaki Veritabanı şeması tarayıcı aracı görünümünü kullanarak veritabanınıza göz atabilirsiniz. Görüntülenen bilgiler, kullandığınız veritabanı sürücüsüne bağlı olarak değişir.

Bu listeyi yenilemek için, araç çubuğundaki herhangi bir yere sağ tıklayın ve Yenile'yi seçin. Listedeki bir öge için bir sorgu oluşturmak için bir ögeye sağ tıklayın, Oluştur'u seçin ve beliren alt menüden sorgu tipini (SELECT, UPDATE, INSERT veya DELETE) seçeneklerinden birini seçin.

SQL eklentisi, Marco Mentasti tarafından yazıldı.

Bu bölümün çoğunu yazan Google Code-In 2011 katılımcısı Ömer Faruk ORUÇ’a özellikle teşekkürler.

Geliştiricilerin kaynak koddaki sembolleri (işlevler, makrolar ve yapılar) görüntülemesine olanak tanır.

Ayrıştırılan bilgilere tıklayarak koda kolayca göz atabilirsiniz.

Şu anda aşağıdaki diller desteklenmektedir:

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

Özellik listesi:

Uçbirim araç görünümü eklentisini yapılandırma iletişim kutusunun Uçbirim sayfasında yapılandırabilirsiniz.

Aşağıdaki seçenekler kullanılabilir:

Seçili metni uçbirim komutlarını kullanarak işlemek için bu eklentiyi kullanabilirsiniz. Seçim, komutun girdisi olarak kullanılacak ve kullanıcının tercihine bağlı olarak çıktı ya seçimin yerini alacak ya da panoya kopyalanacaktır.

Kate eklentisi “XML Doğrulama”, Telif hakkı 2002 Daniel Naber (daniel.naber AT t-online.de).

Belgelendirme telif hakkı 2002 Daniel Naber

Kate’i başlatın ve Ayarlar → Kate Uygulamasını Yapılandır... altındaki yapılandırma iletişim kutusunu açın. Sonrasında, Uygulama → Eklentiler sayfasından XML Tamamlama’yı seçin ve iletişim kutusunu kapatın. İzleyen adım olarak, XML → Meta DTD Ata... yolunu izleyin. Belgenizde bir “DOCTYPE” yoksa veya doctype bilinmiyorsa dosya sisteminizden bir meta DTD seçmeniz gerekecektir. Aksi takdirde, geçerli belgenin DOCTYPE’ı ile eşleşen meta DTD kendiliğinden yüklenir.

Şimdi metninizi yazarken eklentiyi kullanabilirsiniz:

qtpaths --paths GenericDataLocation içindeki katexmltools/testcases.xml dosyasını Kate'e yükleyip yönergeleri izleyerek tüm işlevleri ve sınırlamaları sınayabilirsiniz.

Kate eklentisi “XML Tamamlama”, Telif hakkı 2001,2002 Daniel Naber (daniel.naber AT t-online.de).

KDE SC 4 sürümü telif hakkı 2010 Tomáš Trnka

Belgelendirme telif hakkı 2001,2002 Daniel Naber