Ĉi tiu sekcio priskribos kelkajn el la eroj en la menuo Vidi por ke vi povu rapide agordi Kate labori kiel vi volas ĝin.

Kiam vi komencas Kate unuafoje vi vidos du fenestrojn kun blankaj fonoj. Super la du fenestroj estas ilobreto kun la kutimaj etikeditaj piktogramoj. Kaj super tio, menubreto.

La maldekstramana fenestro estas flanka stango. Ĝi kombinas la fenestrojn Dokumentoj kaj Dosiersistema Foliumilo. Ŝanĝu inter la du klakante sur la langetoj maldekstre de la fenestro.

Se vi komencis Kate kun dosiero, la dekstra fenestro montros la dosieron kiun vi redaktas kaj la Dokumentoj sur la flanka stango montros la nomon de la dosiero. Uzu la fenestron Dosiersistema Foliumilo por malfermi dosierojn.

Vi povas ŝalti kaj malŝalti ĉiujn flankajn fenestrojn en la menuo Vidi → Ilaj Vidoj aŭ uzi Ctrl+Alt+Majuskligo+F. Ĉi tiu menuo ofertas al vi vian unuan ekvidon pri la potenco kaj fleksebleco de Kate.

En Ilaj Vidoj vi havas liston de ĉiuj ebligitaj kromprogramoj. Alklaku la markobutonon antaŭ ĉiu elemento aŭ alklaku per la musbutono maldekstra sur la ilbutonoj en la flanka kolumno por ŝalti kaj malŝalti ĉi tiun ilan vidon.

Multaj el la klavpremaj komandoj (mallongigoj) de Kate estas agordeblaj per la menuo Agordoj. Defaŭlte Kate honoras la sekvajn klavligilojn.

Aldone vi povas uzi la ŝparvojojn provizitajn de la komponanto KatePart kaj de ĉiuj aktivigitaj Kate kromaĵojn.

Fenestro, Vido, Dokumento, Kadro, Redaktilo... Kio estas ili ĉiuj en la terminologio de Kate, kaj kiel vi povas profiti el ĝi la plej grandan parton? Ĉi tiu ĉapitro klarigos ĉion, kaj eĉ pli.

Kate kapablas havi pli ol unu dokumenton malfermitaj samtempe, kaj ankaŭ dividi la redaktan areon en ajnan nombron da kadroj, simile al kiel ekzemple Konqueror aŭ la populara emacs tekstredaktilo funkcias. Tiel vi povas vidi plurajn dokumentojn samtempe, aŭ pli da ekzemploj de la sama dokumento, utila ekzemple se via dokumento enhavas difinojn en la supro, kiujn vi volas ofte vidi por referenco. Aŭ vi povus vidi programfontokapon en unu kadro, dum vi redaktas la efektivigdosieron en alia.

Kiam dokumento estas havebla en pli ol unu redaktilo, ŝanĝoj faritaj en unu redaktilo tuj estos reflektitaj ankaŭ en la aliaj. Ĉi tio inkluzivas ŝanĝi la tekston kaj elekti tekston. Serĉaj operacioj aŭ kursoromovo nur reflektiĝas en la nuna redaktilo.

Nuntempe ne eblas havi pliajn okazojn de la sama dokumento malfermitaj en la senco, ke unu okazo estos redaktita dum la alia ne.

Dum dividado de redaktilo en du kadrojn, ĝi estas dividita en du samgrandajn kadrojn, ambaŭ montrante la nunan dokumenton de tiu redaktilo. La nova kadro estos malsupre (kaze de horizontala disigo) aŭ dekstre (por vertikala disigo). La nova kadro ricevas la fokuson, kiu estas bildigita per la palpebruma kursora stango en la fokusita kadro.

Uzi rapidan malfermon estas tre simpla. Post kiam vi malfermas ĝin, simple tajpu la nomon aŭ partojn de la nomo de la dosiero, kiun vi volas malfermi, kaj rapida malfermo filtros la liston laŭ tio, kion vi tajpis. Premante Enigu malfermas la elektitan dosieron, dum Esc kaŝas la rapidan malfermon.

Defaŭlte, nur la dosiernomo kongruas dum filtrado. Se vi volas kongrui vojon, vi devas havi "/" en la tajpita teksto. Ekzemple: "doc/index" kongruos kun ĉiuj dosieroj kiuj enhavas "index" ene de la dosierujo "doc".

La dokumentoj kiuj estas jam malfermitaj estas emfazitaj en grasa skribo kaj estas listigitaj supre kiam la dialogo malfermiĝas. Ankaŭ, kiam aperas rapida malfermo, la antaŭa malfermita dokumento jam estas elektita, do vi povas simple premi Enigu kaj ĝi kondukos vin al tiu dokumento.

Rapida malfermo provizas kelkajn agordajn opciojn. Por aliri ĉi tiujn opciojn, dekstre alklaku en la enigolinia redakto.

Kate ne (ankoraŭ!) provizas ajnan rimedon por legi dokumentan rilatan dokumentadon. Depende de la dosiero, kiun vi redaktas, vi eble trovos la Konstruita en Terminal Emulator utila por vidi rilatajn UNIX® manlibroj aŭ informdokumentado, aŭ vi povas uzi Konqueror.

La hejmpaĝo de Kate provizas kelkajn Artikolojn kaj Kieltojn kun pliaj informoj ekster la amplekso de ĉi tiu manlibro.

Redakti ilon malfermas agordan dialogon kiu permesas fajnan agordon de la ilo:

La butono Defaŭltoj estas videbla nur por iloj, kiuj estas senditaj kun Kate. Kiam oni klakis, ĉiuj agordoj de ilo revenis al defaŭltaj (alinome fabriko) valoroj.

Kelkaj redaktaj kampoj kiel la Efektivebla, la Argumentoj, la Enigo kaj la Labora Dosierujo subtenas variablojn kiuj estas vastigitaj pri ilvoko. Ĉi tio estas indikita per la piktogramo {} kiu aperas post kiam unu el ĉi tiuj tekstaj enigokampoj havas fokuson (vidu ruĝan cirklon):

Ŝvebi super unu el ĉi tiuj tekstaj enigokampoj ankaŭ montras konsileton kun la nuna vastigita teksto. Plue, alklakante la ago {} malfermos dialogon kiu listigas ĉiujn disponeblajn variablojn:

Ĉi tiu funkcio provizas multe da fleksebleco dum difinado de ekstera ilo ĉar ĉiuj variabloj de la formo %{...} estas vastigitaj kiam la ilo estas alvokita. Estas du specoj de variabloj subtenataj:

La unua formo %{variable-name} simple anstataŭigas la variablon per ĝia enhavo. Ekzemple, la variablo %{Document:FileName} estas anstataŭigita per la dosiernomo de la nuna dokumento sen ĝia vojo. La dua formo %{variable-name:<value>} ricevas la <value> kiel enhavon. Ekzemple, ĉi tio povas esti uzata por vastigi mediovariablon kun %{ENV:HOME}, aŭ oni povas akiri la aktualan daton en la preferata formato kiel %{Date:yyyy-MM-dd}.

Pluraj iloj estas senditaj defaŭlte. Tamen, se vi havas pli utilajn ilojn bonvolu kontribui tiujn al (kwrite-devel AT kde.org) por ke ni povu aldoni ilin al ĉi tiu listo. Ĉiuj defaŭltaj iloj estas videblaj en la listvido defaŭlte. Tamen ĉiuj iloj povas esti ŝanĝitaj laŭplaĉe, inkluzive de la kategorio aŭ eĉ forigi ilojn. Forigitaj iloj povas esti aldonitaj denove alklakante la butonon Aldoni en la agorda paĝo kiel priskribite supre.

Ĉi tiu kromaĵo estas celata por programistoj kaj verŝajne malmulte utilas por uzantoj. Ĝi montras retrospuron liverita de gdb en listvido en Kate ilvido. Klaki sur eron malfermas la elektitan dosieron kaj saltas al la ĝusta linionumero. Ĝi funkcias por retrospuroj generitaj sur via propra maŝino, sed ĝi ankaŭ funkcios por retrospuroj de aliaj homoj, t.s. kun /home/dummy/qt-copy/…/qwidget.cpp ankoraŭ troviĝas en aliaj maŝinoj. Por ke tio funkciu, vi devas indeksi la dosierujojn, kie troviĝas la fontkodo.

Kelkfoje estas pluraj dosieroj kun la sama nomo, ekz.

Por elekti la ĝustan elekton, la kromaĵo elektas la lastajn du partojn de la URL, ĉi-kaze tio estus

Kaj tiam kutime la kromaĵo trovas la ĝustan.

Indeksado de majstro kaj branĉoj kompreneble kondukos al kolizio.

Sur la agorda paĝo aldonu la dosierujojn enhavantajn la fontkodon.

Agordi Vojojn en Backtrace-retumila ilvido

Klakante OK komencos indeksadon. Kiam la indeksado estas finita, malfermu la ilaron Foliumilo de retrospuro.

Nun vi povas ŝargi retrospuron el la tondujo (ekz., kiam vi klakis Kopii al Clipboard en DrKonqi) aŭ el dosiero.

La Konstrua kromaĵo permesas al vi ruli agojn kiel konstrui, purigi kaj kompili en projekto.

La Konstrua kromaĵo aldonas Konstrui Eligo ilan vidon malsupre kaj Konstrui menuon sur la menubreto. La ila vido povas esti uzata por agordi konstru-celajn agordojn, dum la menuo povas esti uzata por plenumi konstruajn, purigi kaj kompili agojn.

La Konstrua Eligo ila vido havas du langetojn:

Langeto de Celaj Agordoj

La langeto de celaj agordoj povas esti uzata por agordi diversajn konstruajn celojn kaj difini celajn arojn.

Por ŝanĝi la nomojn aŭ komandojn duoble alklaku la enskribojn en la tabelo kaj uzu la menuan skatolon por elekti la aktivan cel-aron. Uzu la markobutonon antaŭ ĉiu celo por difini defaŭltan.

Nova celaro enhavas plurajn agordajn opciojn:

Labora Adresaro

Vi povas agordi la vojon al la projekto ĉi tie. Lasu ĉi tion malplena por uzi la dosierujon, en kiu troviĝas la aktuala dokumento.

Konstrui

Ĉi tiu opcio permesas difini la konstruan komandon. Ĝi estas agordita al make defaŭlte.

Pura

La opcio permesas difini la puran komandon. Ĝi estas agordita al make clean defaŭlte.

Agordo

Ĉi tiu opcio ebligas al vi difini la agordan komandon. Ĝi estas agordita al cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../ defaŭlte.

Supre ĉi tiu kromaĵo havas ilobreton kun la sekvaj butonoj:

Konstruu la elektitan celon

Aldoni novan konstrucelon

Krei novan konstrucelon aro

Kopiu komandon aŭ celon aro

Forigu la aktualan komandon aŭ celo fiksita

La Kate Build Plugin estis verkita de Kåre Särs.

Specialan dankon al la partoprenanto de Google Code-In 2011 Salma Sultana pro verkado de granda parto de ĉi tiu sekcio.

Ĉi tiu kromaĵo permesas fermi grupon de dokumentoj laŭ ilia etendo kaj vojo.

Supozeble, ke vi havas ĉi tiujn dokumentojn malfermitaj en Kate:

Tiam vi havas la jenajn eblojn por fermi dokumentojn kiel montrite en la ekrankopio:

Uzu la markobutonon en la lasta elemento de la listo por ebligi aŭ malŝalti konfirman dialogon. La elektita opcio aplikiĝos al ambaŭ proksimaj agoj.

Ĉi tiu kromaĵo aldonas enlinian koloran antaŭrigardon/elekton al koloroj en la teksto (ekz., #FFFFFF, blanka).

Por ŝargi ĉi tiun kromprogramon malfermu la agordan dialogon de Kate sub Agordoj → Agordi Kate.... Poste elektu Kolorelektilo kaj fermu la dialogon.

Sur la paĝo de agordoj de Koloro Picker en la agordo de Kate, vi povas agordi la jenajn opciojn de la aldonaĵkonduto.

Koloraj krampoj kromkoloraj kongruaj krampparoj en malsamaj koloroj por plibonigi legeblecon. Tamen, ne ĉiuj krampoj koloriĝas. Krampo kies kongrua malfermilo aŭ fermilo ne estas videbla estos ignorita. Simile, krampa paro kiu estas la sola krampa paro sur linio ne iĝos kolorigita.

La kromaĵo ne provizas iujn ajn agordojn.

CTags generas indeksan (aŭ etikedon) dosieron de lingvobjektoj trovitaj en fontdosieroj, kiu ebligas al ĉi tiuj eroj esti rapide kaj rapide. facile troviĝas uzante ĉi tiun kromprogramon en Kate.

Etikedo signifas lingvobjekton por kiu indeksa enskribo estas disponebla (aŭ, alternative, la indeksa enskribo kreita por tiu objekto).

Etikedgenerado estas subtenata por ĉi tiuj programlingvoj.

La kromaĵo CTags uzas du malsamajn datumbazdosierojn por la indekso.

Sur la paĝo de agordoj de CTags en la agordo de Kate vi povas aldoni aŭ forigi dosierujojn enhavantajn la fontkodon kaj regeneri la komunan datumbazon de CTags.

Komuna Indekso

Agordi CTags Global Database

Ĉe la malsupro de la agorda paĝo vi povas adapti la Komando CTags.

Por pliaj informoj pri ĉiuj disponeblaj opcioj bonvolu legi la manpaĝon de CTags. Ĉi tiu mana paĝo disponeblas en KHelpCenter kaj vi povas anka enigi la URL man:/ctags rekte en Konqueror

Klako Ĝisdatigi komencos indeksadon. Kiam indeksado estas finita, fermu la dialogon.

Vi metas la muskursoron sur la lingvobjekton kiel funkcion, simbolon ktp. ke vi interesiĝas kaj tiam elektu unu el la agoj en la menuo CTags por salti al la linio kaj dosiero kie la objekto estas difinita aŭ deklarita.

Defaŭlte la agoj en la menuo CTags havas neniujn ŝparvojojn asignitaj. Uzu la klavaran ŝparvojojn por agordi viajn proprajn ŝparvojojn.

Alternative uzu la serĉkampon en la langeto Serĉo de la CTags-vido.

Enigi signojn en la serĉkampon komencos la serĉon kaj montros kongruajn nomojn de lingvobjektoj kiel funkcioj, klasoj, simboloj ktp. kune kun tipo kaj dosiernomo.

Elektu eron en la listo por salti al la responda linio en la fontdosiero.

La kromaĵo ebligas vivan antaŭrigardon de la nuntempe redaktita tekstdokumento en la fina formato en la flanka kolumno. Do dum redaktado de ekz. a Markdown teksto aŭ SVG bildo, la rezulto estas tuj videbla apud la fontteksto.

Por la ekrano la kromprogramo uzas tiun KParts kromaĵo kiu estas nuntempe elektita kiel la preferata por la MIME tipo de la dokumento. Se ne ekzistas KParts kromaĵo por tiu tipo, neniu antaŭrigardo eblas.

Por ŝanĝi la preferatan kromprogramon malfermu la modulon Dosiero-Asocioj en la Sistemargordoj kaj redaktu la Prefer-Ordon de Servoj sur la langeto Enkonstruado.

La butonoj ĉe la supro de la antaŭrigarda fenestro provizas ĉi tiujn agojn:

De supre malsupren, la Dosiersistem-Retumilo konsistas el la sekvaj elementoj:

Ĉi tiu kromaĵo povas esti agordita sur la paĝo Dosiersistemo-Retumilo de la agordo de Kate.

La listo de dokumentoj montras liston de ĉiuj dokumentoj nuntempe malfermitaj en Kate. Modifitaj dosieroj havos malgrandan disketon maldekstre por indiki tiun staton.

Supre la Listo de Dokumentoj havas ilobreton kun la sekvaj butonoj:

Krei novan dokumenton

Malfermi ekzistantan dokumenton

Antaŭa Dokumento

Sekva Dokumento

Konservi la aktualan dokumenton

Konservi la aktualan dokumenton sub nova nomo

Defaŭlte, la Listo de Dokumentoj aperas en Arba Reĝimo, kiu montras la dosierujon ĉirkaŭantan ĉiujn nuntempe malfermitajn dokumentojn. Ankaŭ disponebla estas Lista Reĝimo, kiu montras simplan liston de ĉiuj malfermitaj dokumentoj. Vi povas ŝanĝi reĝimojn dekstre alklakante la liston kaj elektante el la menuo Vido-Reĝimo.

Se du aŭ pli da dosieroj kun la sama nomo (troviĝantaj en malsamaj dosierujoj) estas malfermitaj en Lista Reĝimo, la nomoj de la dua estos antaŭmetitaj “(2)” ktp. La ilo-konsileto por la dosiero montros sian plenan nomon inkluzive de la vojo, permesante al vi elekti la deziratan.

Por montri dokumenton en la aktuale aktiva kadro, alklaku la dokumentnomon en la listo.

La kunteksta menuo havas kelkajn komunajn agojn el la menuo Dosiero.

Aldone estas dosiermanaĝeraj agoj por renomi aŭ forigi la dosieron. Per Kopii Lokon vi povas kopii la plenan vojon de la dokumento al la tondujo.

Vi povas ordigi la liston en kelkaj malsamaj manieroj dekstre alklakante la liston kaj elektante el la menuo Ordigi Laŭ. La opcioj estas:

La dokumentlisto defaŭlte bildigos vian historion ombrigante la enskribojn por la plej lastatempaj dokumentoj kun fonkoloro. Se la dokumento estis redaktita, kroma koloro estas miksita. La plej lastatempa dokumento havas la plej fortan koloron, tiel ke vi povas facile trovi la dokumentojn pri kiuj vi laboras. Ĉi tiu funkcio povas esti malŝaltita en la paĝo Dokumentoj de la agorda dialogo.

La defaŭlta loko de la dokumenta listo en la Kate fenestro estas maldekstre de la redakta areo.

la GDB de Kate kromaĵo provizas simplan fasadon al la populara GNU Projekta Erarserĉilo.

Vi povas ebligi la GDB kromaĵo en la sekcio de Kromaĵoj de la agordo de Kate.

Por ke la kromprogramo funkciu ĝuste, vi devas havi fontdosieron (de iu ajn tipo subtenata de GDB) kaj ruleblaĵo.

Post kiam ĉi tiuj preparoj estas faritaj, malfermu la fontdosieron en Kate, enigu la vojon al la plenumebla en la langeto Agordoj de la ila vido de Sensirmiga Vido, kaj elektu Sensirigi → Komenci Sencimigi el la menuo por komenci.

Ĉiuj ĉi tiuj opcioj disponeblas en la menuoj de Kate, kaj multaj disponeblas ankaŭ ĉe la ilobreto Sencimiga.

La Sencimiga Vido ila vido konsistas el pluraj langetoj:

La Voka stako ila vido enhavas liston de la formatita malantaŭa spuro resendita de GDB.

La Call Stack ilovido de la GDB-kromprogramo.

La ilovido de Lokuloj enhavas liston de ĉiuj aktuale ŝargitaj variabloj de la programo kaj iliajn respondajn valorojn.

La Lokuloj-ilovido de la GDB-kromprogramo.

Specialan dankon al la partoprenanto de Google Code-In 2011 Martin Gergov pro verkado de granda parto de ĉi tiu sekcio.

La baza ideo de la Projekta kromaĵo estas havi strukturitan liston de dosieroj apartenantaj al la projekto kun la sekvaj trajtoj:

Post kiam la Projekta kromaĵo estas ŝargita en la Kate agorda paĝo, malfermu dosieron en projekto kaj aperos flanka kolumno, kiu listigas ĉiujn projektojn kaj la projektodosierojn jene:

Kiel vi povas vidi, la nuntempe aktiva projekto estas “Kate”, kaj ĝia enhavo estas listigita en la arba vido. Alklakante dosierojn en la arba vido malfermas la dosieron en la redaktilo. Plue, kunteksta menuo estas provizita per kiu vi povas malfermi dosierojn kun aliaj aplikaĵoj, kiel ekzemple .ui dosiero kun Qt Designer.

Vi povas filtri la erojn tajpante partojn de la dosiernomo, kiun vi serĉas en la serĉbreton ĉe la malsupro de la listo.

La ideo estas, ke vi neniam devas malfermi projekton permane, ĉi tio eĉ tute ne estas subtenata. Tial, kio okazas se vi malfermas dosieron, la Projekta kromaĵo rapide skanas la dosierujon kaj ĝiajn gepatrajn dosierujojn por .kateproject dosiero. Se trovite, la projekto estas aŭtomate ŝargita.

Krome, se vi malfermas alian dokumenton en Kate, kiu apartenas al alia projekto, la Projekta kromaĵo aŭtomate ŝanĝas la aktualan projekton. Do intuicie, ĉiam la ĝusta projekto estas aktiva. Kompreneble, vi ankaŭ povas ŝanĝi la nuntempe aktivan projekton per la kombokesto.

Kate havas Serĉi-kaj-Anstataŭigi kromaĵon kiu aperas en la malsupra flanka kolumno. Se projekto estas ŝargita, malfermu la Serĉu kaj Anstataŭigi flankbreton, kaj ŝanĝu al la reĝimo por serĉi kaj anstataŭigi en la aktuala projekto:

Kun la scio pri ĉiuj dosieroj apartenantaj al projekto, la Projekta kromaĵo disponigas simplajn aŭtokompletajn instalaĵojn bazitajn sur CTags. Se projekto estas komence malfermita, CTags analizas ĉiujn projektodosierojn en fona fadeno kaj konservas la informojn de CTags al /tmp. Tiu ĉi dosiero tiam estas uzata por plenigi la ŝprucfenestron de aŭtomata kompletigo en Kate.

Kontraste, sen ĉi tiu aŭtomata kompletigo, Kate kapablas nur montri aŭtomatajn kompletigojn bazitajn sur la vortoj en la aktuala dosiero. Do la aŭtomata kompletigo provizita de la Projekta kromaĵo estas multe pli potenca.

Se CTags mankas, pasiva ŝprucfenestro avertas vin pri ĉi tiu problemo. Estas ankaŭ rimarkinde, ke la CTags-dosiero en /tmp estas purigita kiam Kate eliras, do la kromaĵo ne poluas iun dosierujon kun nedezirataj dosieroj.

Alia funkcio estas havi subtenon por la Konstrua Kromaĵo, tiel ke ĝi aŭtomate estas agordita ĝuste.

Uzante Projektoj → Iri Al (Alt+1) vi povas malfermi la vidon Aktuala Projekto ĉe la malsupro de la redaktora fenestro kun kvar langetoj:

La menuo Projektoj permesas ŝanĝi inter nun malfermitaj projektoj. Ĝi estas montrata de la Projekta kromaĵo.

Se konvene, responda LSP-komando ankaŭ estas menciita en la klarigo malsupre, kies dokumentado tiam povas disponigi kroman fonon kaj interpreton, kvankam ĝi povas varii dependi de la fakta lingvo. La frazo 'nuna simbolo' rilatas al la simbolo egalrilatanta al la nuna kursorpozicio, kiel tiel determinite per la lingvo kaj servila efektivigo.

LSP Kliento povas helpi vin salti al ajna simbolo en via projekto aŭ aktuala dosiero. Por salti al iu ajn simbolo en la dosiero, uzu la ilovidon "LSP Klienta Simbolo Skizo" ĉe la dekstra rando de kate. Ĉi tiu ilvido listigas ĉiujn simbolojn trovitajn de la servilo en aktuala dokumento.

Clangd-ŝanĝa fontokapa komando estas subtenata. Por ŝanĝi fontan kaplinion en projekto C aŭ C++ aŭ uzu la opcion "Switch Source Header" de la kunteksta menuo aŭ la ŝparvojo F12 .

Vi povas rapide salti al simbolo metante vian muson super la simbolon kaj poste premante Ctrl + maldekstran musbutonon.

La agorda paĝo de la kromaĵo plejparte ebligas konstantan agordon de iuj el ĉi-supraj menueroj. Tamen, ekzistas unu plia eniro por specifi la servilan agordan dosieron. Ĉi tio estas JSON dosiero kiu povas esti uzata por specifi la LSP-servilon por komenci (kaj poste por komuniki kun super stdin/stdout). Por komforto, iu defaŭlta agordo estas inkluzivita, kiu povas esti inspektita en la agorda paĝo de la kromaĵo. Por helpi en la klarigo malsupre, eltiraĵo de tiu agordo estas donita ĉi tie:

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

Notu, ke ĉiu "komando" povas esti tabelo aŭ ĉeno (tiam ĝi estas dividita en tabelon). Ankaŭ, altnivela "ĉiea" enskribo (apud "servilo") estas konsiderata ankaŭ (vidu pli sube). La specifita duumaro estas serĉata laŭ la kutima maniero, ekz. uzante PATH. Se ĝi estas instalita en iu propra loko, tiam ĉi-lasta eble devos esti etendita. Aŭ alternative, (sim)ligo aŭ envolvaĵskripto povas esti uzata en loko kiu estas ene de la kutima PATH. Kiel ĉi-supre ilustrite, oni povas ankaŭ specifi "vojo" kiun oni serĉos post la normaj lokoj.

Ĉiuj enskriboj en "komando", "radiko" kaj "pado" estas submetataj al varia ekspansio.

La "highlightingModeRegex" estas uzata por mapi la reliefan reĝimon kiel uzatan de Kate al la lingvoid de la servilo. Se neniu regula esprimo estas donita, la lingvo-id mem estas uzata. Se "documentLanguageId" eniro estas agordita kiel malvera, tiam neniu lingvo-identigilo estas provizita al la servilo dum malfermado de la dokumento. Ĉi tio povas havi pli bonajn rezultojn por iuj serviloj, kiuj estas pli precizaj por determini la dokumentspecon ol fari tion surbaze de kate-reĝimo.

De la supra ekzemplo, la esenco estas supozeble klara. Krome, ĉiu servila enira objekto ankaŭ povas havi "initializationOptions" eniron, kiu estas transdonita al la servilo kiel parto de la 'initialize' metodo. Se ĉeestas, "agordoj" eniro estas transdonita al la servilo per la sciigo 'workspace/didChangeConfiguration'. Aŭ de "completionTriggerCharacters" aŭ "signatureTriggerCharacters" povas esti specifita kiel JSON-objekto kun ĉenoj "exclude" kaj/aŭ "include". Ĉi tiuj estos uzataj por respektive ekskludi aŭ aldoni kelkajn signojn al la respektiva ekigilaro kiel provizita de la servilo.

Diversaj stadioj de superregado/kunfandi estas aplikataj;

Unu servila instanco estas uzata per (radiko, servilospeco) kombinaĵo. Se "root" estas specifita kiel absoluta vojo, tiam ĝi uzis kiel-estas, alie ĝi estas relative al la “projectBase” (kiel determinite de la Projekta kromaĵo) se aplikebla, aŭ alie rilate al la dosierujo de la dokumento. Se ne specifita kaj "rootIndicationFileNames" estas tabelo kiel dosiernomoj, tiam gepatra dosierujo de aktuala dokumento enhavanta tian dosieron estas elektita. Alternative, se "root" ne estas specifita kaj "rootIndicationFilePatterns" estas tabelo de dosierŝablonoj, tiam gepatra dosierujo de la nuna dokumento kongrua kun la dosierŝablono estas elektita. Kiel lasta rezerva, la hejma dosierujo estas elektita kiel "radiko". Por iu ajn dokumento, la rezulta "root" tiam determinas ĉu aŭ ne aparta kazo estas necesa. Se jes, la "root" estas transdonita kiel rootUri/rootPath.

Ĝenerale, oni rekomendas lasi radikon nespecifita, ĉar ĝi ne estas tiom grava por servilo (via kilometraĵo tamen povas varii). Pli malmultaj servilaj instancoj estas evidente pli efikaj, kaj ili ankaŭ havas "pli larĝan" vidon ol la vido de multaj apartaj okazoj.

Kiel menciite supre, pluraj eniroj estas submetataj al varia ekspansio. Taŭga apliko de tio kombinita kun aliroj de "envolvaĵo-skripto" permesas personigon al multaj cirkonstancoj. Ekzemple, konsideru python-disvolvan scenaron kiu konsistas el pluraj projektoj (ekz. git repos), ĉiu kun sia propra virtualenv-aranĝo. Uzante la defaŭltan agordon, la pitona lingvoservilo ne konscios pri la virtuala env. Tamen, tio povas esti riparita per la sekva aliro. Unue, la sekva fragmento povas esti enigita en la "Uzanto-Servilo-Agordoj" de LSPClient:

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

La radika eniro supre estas relativa al la projekta dosierujo kaj certigas ke aparta lingvoservilo estas komencita por ĉiu projekto, kio estas necesa en ĉi tiu kazo ĉar ĉiu havas apartan virtualan medion.

pylsp_in_env estas malgranda "envolvaĵa skripto" kiu devus esti metita en PATH kun la sekva (alĝustigota) enhavo:

#!/bin/bash
cd $1
# rulu la servilon (python-lsp-server) ene de la virtualenv
# (t.e. kun agordo de virtualenv-variabloj)
# do fontu la virtualenv
source XYZ
# servilaj postuloj aŭ argumentoj povas varii
exec miaservilo

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

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

La kromprogramo Serĉi & Anstataŭigi de Kate permesas serĉi tekston aŭ regulajn esprimojn en multaj malsamaj dosieroj samtempe. Vi povas serĉi ĉiujn malfermitajn dosierojn, ĉiujn dosierojn en unu dosierujo kaj laŭvole ĝiaj subdosierujoj, aŭ en la aktiva dosiero. Vi povas eĉ filtri laŭ dosiernomo, ekzemple serĉante nur dosierojn, kiuj finiĝas per aparta dosier-etendaĵo.

Kate Fragmentoj estas kromaĵo uzata por ŝpari al vi iom da tempo aldonante subtenon por tiel nomataj “fragmentoj” (reuzebla fontkodo, maŝinkodo aŭ teksto). La kromaĵo ankaŭ subtenas kodkompletigon kaj JavaScript.

La panelo por Kate-Fragmentoj.

En la panelo vi devus vidi liston de fragmentaj deponejoj, kune kun ebloj por krei viajn proprajn, akiri ilin de la Interreto aŭ ŝargi ilin el loka dosiero. Ĉiu deponejo havas markobutonon, kiu povas esti uzata por aktivigi aŭ malaktivigi ĝin. Estas ankaŭ butonoj por redakti kaj forigi ekzistantajn deponejojn.

Krei kaj Redakti Deponejojn

Por krei novan deponejon de fragmentoj, alklaku Aldoni Deponejon. Vi nun devus vidi dialogon, kiu petas la nomon de la fragmenta dosiero, permesilo kaj aŭtoro. Post elekto de la dezirataj opcioj, alklaku OK.

La interfaco de deponeja redaktilo.

La redaktilo de fragmentoj de deponejo enhavas la jenajn opciojn:

Nomo

Aperas en la listo de fragmentoj en la ila vido kaj ankaŭ estas serĉata kiam oni uzas la kodkompletigan funkcion.

Nomspaco

Prefikso uzata dum kodokompletigo.

Permesilo

Elektu la permesilon por via fragmento-deponejo.

Aŭtoroj

Enigu la nomon(j)n de la aŭtoro(j) de la fragmenta dosiero.

Dosiertipoj

Elektu la dosiertipojn, al kiuj vi volas ke la fragmento-deponejo apliku. Ĝi estas agordita al “” defaŭlte, do la deponejo validas por ĉiuj dosieroj. Vi povas ŝanĝi ĝin al io kiel C++ ekzemple, aŭ elekti el listo alklakante la aĵojn. Vi povas specifi pli ol unu dosiertipo premante la Majuskligo dum aldonado de tipoj.

Krei kaj Redakti Pecetojn

La interfaco de redaktilo de fragmentoj.

Nomo

La nomo estos montrata en la kompletigolisto.

Ŝparvojo

Premante ĉi tiun ŝparvojon enigos la fragmenton en la dokumenton.

Fragmentoj

La tekston, kiun via fragmento enigos en la dokumenton.

Fragmento povas enhavi redakteblajn kampojn. Ili povas esti biciklitaj premante Tab. La jenaj esprimoj povas esti uzataj en la ŝablona teksto por krei kampojn:

${field_name} kreas simplan, redakteblan kampon. Ĉiuj postaj okazoj de la sama field_name kreas kampojn kiuj spegulas la enhavon de la unua dum redaktado.

${field_name=defaŭlto} povas esti uzata por specifi defaŭltan valoron por la kampo. defaŭlto povas esti ajna JavaScript esprimo.

Uzu ${field_name=teksto} por specifi fiksan ĉenon kiel defaŭltan valoron.

${func(alia_kampo1, alia_kampo2, ...)} povas esti uzata por krei kampon kiu taksas JavaScript funkcias en ĉiu redakto kaj enhavas ĝian enhavon. Vidu la langeton Skriptoj por pliaj informoj.

${cursor} povas esti uzata por marki la finpozicion de la kursoro post kiam ĉio alia estis plenigita.

Skriptoj

JavaScript helpaj funkcioj por uzi en viaj fragmentoj.

Ĉiuj JavaScript funkcioj devas resendi la enhavon, kiun vi volas meti en ŝablonkampon kiel ĉenon.

Funkcioj estas nomitaj en amplekso kiu enhavas la enhavon de ĉiuj redakteblaj ŝablonkampoj kiel lokaj variabloj. Ekzemple en fragmento enhavanta ${kampo}, variablo nomata kampo ĉeestos kiu enhavas la ĝisdatigitan enhavon de la ŝablona kampo. Tiuj variabloj povas aŭ esti uzataj en la funkcio statike aŭ transdonitaj kiel argumentoj, uzante la ${func(kampo)} aŭ ${field2=func(kampo)} sintakso en la fragmentĉeno.

Vi povas uzi la Kate scripting API por akiri la elektitan tekston, plenan tekston, dosiernomon kaj pli uzante la taŭgajn metodojn de la objektoj dokumento kaj vido. Raportu la dokumentaron pri scripting API por pliaj informoj.

Por pli kompleksaj skriptoj povas esti grave kompreni, ke unue, la kruda fragmento estas enmetita en la dokumenton, kaj poste funkcioj estas taksataj. Ekz., se funkcio retrovas la tekston sur la linio kie la fragmento estas enmetita, tiu teksto ankaŭ enhavos ${functionCall()}.

Kiel ekzemplo de laboro kun elektoj uzante la scripting API, simpla maniero envolvi elektitan tekston ene de etikedoj estas ĉi tiu fragmento: <strong>${view.selectedText()}</strong>

La sekva ekzemplo alvokas skripton, kiu enmetas defaŭltan tekston, se ne ekzistas elekto. Fragmento:

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

Skripto:

function gamoKomando(komando, difin) {
    if (view.selectedText().length 
> 0) {
        return komando.replace("%%1", view.selectedText());
    } else {
        return komando.replace("%%1", difin);
    }
}

Elektante el listo de fragmentoj.

Vi povas voki fragmentojn en du manieroj:

Se la fragmento enhavas variablojn (krom ${cursor}) la kursoro aŭtomate iros al la unua okazo de variablo kaj atendos ke vi skribu ion. Kiam vi finos, vi povas premi Tab movi al la sekva variablo, kaj tiel plu.

Kate Fragmentoj estis skribitaj fare de Joseph Wenninger.

Specialan dankon al la partoprenanto de Google Code-In 2011 Martin Gergov pro verkado de granda parto de ĉi tiu sekcio.

Registri kaj ludu klavarajn makroojn (t.e. klavarajn agosekvencojn).

Eblas konservi klavarajn makroojn donante al ili nomon.

Nomitaj makrooj estas konstantaj inter la seancoj de Kate, ili estas konservitaj en la dosiero keyboardmacros.json en la uzantdatuma dosierujo de Kate (kutime ~/.local/share/kate/).

Aktuale, klavaraj makrooj ne ludas ĝuste se iuj specoj de GUI-fenestraĵoj estas uzataj: QMenu, QuickOpenLineEdit aŭ TabSwitcherTreeView, ekzemple. Mi ne certas kial sed mia unua supozo estus, ke ĉi tiuj fenestraĵoj funkcias ne-norma maniero rilate klavarajn eventojn.

La Structured Query Language (SQL) estas speciala lingvo por ĝisdatigi, forigi kaj peti informojn de datumbazoj.

La Kate SQL-Aldonaĵo permesas vin:

Elektu Aldoni Konekton el la menuo aŭ ilobreto SQL, kaj poste elektu la Qt™ datumbaza pelilo, kiun vi volas uzi (inkluzive de QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 kaj QPSQL). Se vi ne povas vidi la deziratan pelilon, vi devas instali ĝin. Tiam, premu Sekva.

Se la datumbazo, kiun vi elektis, uzas dosieron, simple indiku la lokon de la datumbazo kaj premu la butonon Sekva. Se ĝi postulas konektiĝi al servilo, vi devas enigi la gastigan nomon de la servilo, vian uzantnomon kaj pasvorton, kaj ajnan alian informon, kiun specifa pelilo povas postuli. Tiam premu Sekva.

Fine, donu nomon al via konekto, kaj premu Finu.

Vi povas foliumi vian datumbazon per la Datumbaza skemo retumila ilo-vido maldekstre. La informoj montritaj varias depende de kiun datumbazan pelilon vi uzas.

Por refreŝigi ĉi tiun liston, dekstre alklaku ie ajn en la ila vido kaj elektu Refreŝigi. Por generi demandon pri iu ajn enskribo en la listo, dekstre alklaku enskribon, elektu Generu, kaj elektu la demandtipon (SELECT, UPDATE, INSERT, aŭ DELETE) de la submenuo kiu aperas.

La SQL-Kromaĵo estis verkita de Marco Mentasti.

Specialan dankon al la partoprenanto de Google Code-In 2011 Ömer Faruk ORUÇ pro verkado de granda parto de ĉi tiu sekcio.

Ĝi permesas al programistoj vidi simbolojn (funkcioj, makrooj kaj strukturoj) el fontkodo.

Alklakante la analizitajn informojn vi povas facile foliumi la kodon.

Nuntempe la sekvaj lingvoj estas subtenataj:

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

Listo de funkcioj:

Vi povas agordi la kromprogramon Vido de Terminalilo sur la paĝo Terminalo de la agorda dialogo.

La jenaj opcioj disponeblas:

Vi povas uzi ĉi tiun kromprogramon por prilabori elektitan tekston per finaj komandoj. La elekto estos uzata kiel enigo por la komando, kaj la eligo aŭ anstataŭigos la elekton aŭ estos kopiita al la tondujo, depende de la prefero de la uzanto.

Kate Kromaĵo “XML Valido” kopirajto 2002 Daniel Naber (daniel.naber AT t-online.de).

Dokumenta kopirajto 2002 Daniel Naber

Komencu Kate kaj malfermu la agordan dialogon sub Agordoj → Agordu Kate.... Tiam elektu XML Kompletigo kiu aperos en la paĝo Apliko → Kromaĵoj kaj fermu la dialogon. Post tio, elektu XML → Asigni Meta DTD.... Se via dokumento enhavas neniun “DOCTYPE” aŭ la doktipo estas nekonata, vi devos elekti meta DTD el la dosiersistemo. Alie la meta DTD kiu kongruas kun la DOCTYPE de la aktuala dokumento estos ŝargita aŭtomate.

Vi nun povas uzi la kromprogramon dum tajpas vian tekston:

Vi povas testi ĉiujn funkciojn kaj limigojn ŝargante katexmltools/testcases.xml en qtpaths --paths GenericDataLocation en Kate kaj sekvante la instrukciojn.

Kate Kromaĵo “XML Kompletigo” kopirajto 2001,2002 Daniel Naber (daniel.naber AT t-online.de).

KDE SC-4 versio kopirajto 2010 Tomáš Trnka

Dokumenta kopirajto 2001,2002 Daniel Naber