Projekta KromprogramooLa baza ideo de la Projekta kromaĵo estas havi strukturitan liston de dosieroj apartenantaj al la projekto kun la sekvaj trajtoj:
Provizi strukturitan vidon de la dosieroj
Igi ĝin facila kaj tre rapida malfermi kaj ŝanĝi projektojn
Subteni serĉon kaj anstataŭigu projekton
Provizi simplan aŭtomatan kompletigon
Simpligi rapidan malfermadon de dosieroj en la projekto
Subteno por konstrui la projekton
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.
La Projekta kromaĵo havas aŭtomatan ŝargan funkcion. Vi povas legi la dosierliston de la versio-kontrolsistemo. Tiucele, aŭtomata ŝargo por la respektiva versio-kontrolsistemo devas esti ebligita en la agordoj (aktivigita defaŭlte):
Vi nur devas krei dosieron .kateproject en la radika dosierujo de la projekto. Ekzemple, la dosiero “Kate” .kateproject aspektas jene:
{
"nomo": "Kate",
"dosieroj": [
{
"git": 1
}
]
}
La dosierenhavo estas skribita en JSON sintakso. La projektonomo estas “Kate”, kaj la dosieroj enhavitaj en devus esti legitaj de Git.
Ankaŭ subtenata anstataŭ git estas subfosado per svn kaj mercurial per hg. Se vi ne volas legi dosierojn de versio-kontrolsistemo, vi povas simple alvoki kate el komandlinio kiel:
kate /path/to/folder
aŭ vi povas instrui ĝin rekursie ŝargi dosierojn el dosierujoj jene:
{
"name": "Kate",
"files": [
{
"directory": "kate",
"filters": [
"*.cpp",
"*.h",
"*.ui",
"CMakeLists.txt",
"Find*.cmake"
],
"recursive": 1,
"hidden": 1
}
],
"exclude_patterns" : [
"^build/.*"
]
}
Ĉi tie, subdosierujoj kaj filtriloj difinas kio estas parto de la projekto. Vi ankaŭ povas miksi versiokontrolon kaj dosierojn bazitajn sur filtriloj. Kaŝitaj dosieroj ne estos reakiritaj se la opcio "kaŝita" estas 0. "exclude_patterns" estas listo de regex-ŝablonoj uzeblaj por ekskludi dosierujojn kaj dosierojn el la projektarbo. En ĉi tiu ekzemplo, Ĉiuj dosieroj kaj dosierujoj en dosierujo konstrui el la radiko estos ekskluditaj.
Se vi volas aldoni subtenon por la konstruaĵo, vi povas skribi .kateproject jene:
{
"name": "Kate",
"files": [
{
"git": 1
}
],
"build": {
"directory": "build",
"build": "make all",
"clean": "make clean",
"install": "make install",
"targets": [
{
"name": "all",
"build_cmd": "ninja"
"run_cmd": "./bin/kate"
},
{
"name": "kate",
"build_cmd": "ninja kate-bin"
}
]
}
}
La celoj supre specifitaj tiam aperos en la Konstrua Kromaĵo sub "Celoj de Projektaj Kromaĵoj". Se la tabelo "celiloj" estas specifita tiam "konstrui", "purigi" kaj "instali " estas ignoritaj. Ĉiu elemento en la tabelo precizigas celon. "nomo" estas la nomo de la celo, "build_cmd" estos uzata por konstrui la celon, "run_cmd" estos uzata por ruli la celon. Plej grava el ĉio estas "dosierujo", ĉi tie estos rulitaj la komandoj.
Se vi havas .kateproject dosieron spurita de kontrolversia sistemo, sed vi devas ĝustigi la agordon por aparta laborspaco, vi povas konservi tiujn ŝanĝojn en aparta dosiero nomita .kateproject.local. La enhavo de ĉi tiu dosiero havos prioritaton super .kateproject.
Uzante → (Alt+1) vi povas malfermi la vidon Aktuala Projekto ĉe la malsupro de la redaktora fenestro kun kvar langetoj:
Terminala emulilo komencanta en la radika dosierujo de la projekto.
Enigi signojn en la serĉbreton komencos la serĉon kaj montros kongruajn nomojn de funkcioj, klasoj, simboloj ktp. kune kun speco, dosiernomo kaj linionumero.
Elektu eron en la listo por salti al la responda linio en la fontdosiero.
Klaku Komenci Analizon por ruli statikan kodan analizon por la C kaj C++ uzante cppcheck kaj por generi raporton montrantan dosiernomon, linionumeron, severecon (stilo, averto, ktp;) kaj la afero trovita.
Elektu eron en la listo por salti al la responda linio en la fontdosiero.
Teksto enigita en ĉi tiu langeto estos konservita en la dosiero
.kateproject.notes.