Quanta Plusi kasutaja käsiraamat
Autoriõigus © 2002, 2003, 2004, 2005 Quanta Plusi arendajate meeskond
Käesolevat dokumenti võib kopeerida, edasi levitada ja/või muuta vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele, nagu need on avaldanud Vaba Tarkvara Fond; kas Litsentsi versioon 1.1 või ükskõik milline hilisem versioon; kaasa arvatud mittemuudetavad sektsioonid (puudub), esikaane tekstid (puudub), ja tagakaane tekstid (puudub). Litsentsi koopiaga võimaldab tutvuda sektsioon "GNU Vaba Dokumentatsiooni Litsents".
Quanta Plus on veebi IDE, mille eesmärk on olla neutraalne ja läbipaistev kõigi märgistuskeelte suhtes ning samas toetada populaarseid veebipõhiseid skriptikeeli, CSSi ning muid W3C® soovitustele tuginevaid standardeid.
Sisukord
Näidete nimekiri
Quanta Plus on K töölaua keskkonna veebiarendusvahend. Quanta Plusi siht on võimaldada kiiret ja hõlpust veebiarendust ning see on kiiresti muutunud paljude suurepäraste omadustega võimekaks redaktoriks. Meie eesmärgiks on jäänud luua kõigi aegade kõige parem veebiarendusvahend. Me saame aru, et see nõuab märksa rohkemate inimeste aktiivset kaasamist, seepärast olemegi asunud arendama vahendeid, mis lubavad veebimeistritel Quanta Plusi kohandada, laiendada ja täiustada. Seetõttu palume ka just teil, veebiarendajatel, anda meilegi teada, kuidas olete Quanta Plusi täiustanud. Me organiseerime teie täiustused viisil, et kõik Quanta Plusi pruukivad veebiarendajad saaksid kasutada ressursse, laiendusi ja uusi pluginaid ning sel moel tõusta kõigi aegade parimateks veebimeistriteks. | ||
| --Eric Laffoon, http://quanta.sourceforge.net | ||
Püüdes luua parimat HTML-redaktorit, kerkis Quanta Plusi arendajatel pähe üsna hullumeelne idee: “Aga kui muudaks Quanta Plusi üldiseks ja laiendatavaks märkekeele redaktoriks?” Sest nii saaks sellest ju maailma parim veebiarenduskeskkond, mida KDE suudab pakkuda! Ja nii läkski...
Olemata enam seotud HTML-i külge, on Quanta Plus teel igakülgse ja parima veebiarenduskeskkonna staatuse poole. Õigupoolest: kui on võimalik midagi defineerida XML-ina, peaks Quanta Plus olema igati võimeline pakkuma sellele arenduskeskkonda (IDE).
Kohe tuleb lisada, et Quanta Plus kujutab endast silmapaistvat saavutust, mille taga seisab kogu KDE arendamisega tegelev kogukond. Vaba tarkvara kehastusena kasutab Quanta Plus ära põhimõtet “Miks kirjutada midagi, mida keegi on juba kirjutanud?” Tänu KDE avarale raamistikule ongi selline koostöö võimalikuks saanud.
Quanta Plus pakub veebiarendajatele tundlikku ja võimsat paljudokumendilist töökeskkonda (MDI), mis võib oluliselt tõsta produktiivsust. Oma käe järgi kohandatud toimingute, skriptide ja tööriistaribade loomisega on peaaegu kõike võimalik muuta automaatseks. Rakendus Kommander lubab laiendada Quanta Plusi selliselt, et sa ei pruugi oma mälu isegi vaevata skriptisüntaksi meeldetuletamisega. Täpsemalt räägib selles Peatükk 7, Quanta Plusi laiendamine.
Quanta Plus kasutab päris mitut olulist põhimõtet ning kõige selle mõistmiseks, mida Quanta Plus pakkuda suudab, tuleb esmalt need põhitõed selgeks teha. Käesolev peatükk ongi sellele pühendatud.
Quanta Plus jagab töötsooni kolmeks: globaalne, kohalik ja projekti piirkond. See erinevus mõjutab Quanta Plusi paljusid komponente.
Globaalsed elemendid on kättesaadavad kõigile Quanta Plusi kasutajatele. Tööriistaribadest toiminguteni asub kõik globaalseks märgitu Quanta Plusi üldises kataloogistruktuuris. See võimaldab näiteks administraatoritel salvestada teatud tööriistaribad, toimingud ja mallid globaalsesse puusse, mida seejärel saavad ühtmoodi kasutada kõik, kes antud süsteemis Quanta Plusi pruugivad.
Kohalikud elemendid kuuluvad konkreetsete kasutajate veebiarendusressursside hulka, koosnedes kasutajale vajalikest mallidest ja tööriistaribadest. Need asuvad kasutajate kodukataloogis. See muudab kõik kasutaja kohalikud elemendid kättesaadavaks mis tahes veebiarendusprojektis, millest kasutaja soovib osa võtta.
Projektielemendid on mõeldud kasutamiseks ainult konkreetses projektis. Neiks võivad olla mis tahes elemendid alates CSS mallidest kuni omaloodud toimingutega tööriistaribadeni, mis võimaldavad ette võtta spetsiaalseid ülesandeid antud projekti failidega. See on ühtlasi kõige piiratum valdkond. Kõik projekti töötsoonis salvestatud elemendid salvestatakse projekti kataloogipuusse.
Quanta Plus käesoleva dokumendi redigeerimisel.
Quanta Plusi MDI jaguneb mitmeks põhiosaks: redaktori aken, kiirinfo puud, infokaardid ja tööriistaribad. Täpsemat infot nende komponentide kohta annavad “Redaktoriaken”, “Tööriistavaated”, “Infokaardid” ja “Tööriistaribad”.
Quanta Plusi redaktoriaken.
Quanta Plusi redaktori aken võimaldab ühekorraga avada palju faile. Kui avatud on vaid üks fail, täidab dokument kogu redaktori akna. Kui avatakse teine dokument, eraldatakse redaktori akna allosas väike ruumiosa kaartidele, kus on näha failide nimed ja olekuikoon (siintoodud pildil on see näha flopiikoonina, mis ilmub failinime kõrvale, kui seda on muudetud, osutades, et faili võiks olla kasulik salvestada).
Hiire parema nupuga kaartidel klõpsates avaneb kontekstimenüü, milles leiduvad kirjed käivad parajasti avatud dokumendi kohta: aktiivse, mõne muu või kõigi kaartide sulgemine, lülitumine mõnele muule kaardile, dokumendi uuestilaadimine, kustutamine või üleslaadimine, lülitumine järjehoidjaga reale, CVS-toimingu sooritamine avatud dokumendiga.
Hiire parema nupuga redaktori alas klõpsates avaneb samuti kontekstimenüü, mille kirjed käivad redigeeritava dokumendi sisu kohta: põhilised redigeerimistoimingud (lõika/kopeeri/aseta), kursori all asuva sildi redigeerimine, kursori all oleva sildiga hõlmatud ala valimine, kontekstiabi kursori all oleva sõna kohta või faili avamine, kui kursori all olev string viitab failile.
Redaktori akna kohal asetseb redaktoririba. Praegu on Quanta Plusi vaikeväärtuseks HTML 4.01 Transitional, mis pakub välja teatud vaikimisi laetavate tööriistaribade valiku. Quanta Plusi arenedes uuendatakse ka neid tööriistaribasid, et tulla paremini vastu kasutajate vajadustele ja võimaldada neil kasutada kõiki uusi võimalusi.
Tööriistaribade kasutamine peaks olema ilmselge. Kui soovid lisada mõne elementaarse sildi (näiteks <p>) oma dokumenti, klõpsa lihtsalt vastavat silti esindaval ikoonil. Seejärel saad sisestada vajalikud andmed. Kui soovid lisada mõne keerulisema sildi, mis eeldab teatud atribuute (näiteks ankur), võid kasutada dialoogi, kus saab erinevad väljad täita vajaliku infoga.
Ankru (<a>) dialoog.
Tööriistavaated.
Tööriistavaated ehk kiirinfopuud (QIT) võimaldavad ringi liikuda ja Quanta Plusi kohta infot hankida. Praegusel kujul näitavad kaardid faili-, projekti-, malli-, dokumendi struktuuri, skripti-, atribuudi- ja dokumentatsioonipuud.
QIT: mis on mis
Siin saab lehitseda kogu failisüsteemi puu kujul. Failisüsteemi saab vaadelda kahest vaatepunktist: esiteks kasutaja kodukataloogist ning teiseks failisüsteemi juurkataloogist. Puud saab kasutada masinas nende failide leidmiseks, mida soovid redigeerida või lisada käesolevasse projekti. Klõps hiire parema nupuga puuvaates oleval failil pakub mitmeid võimalusi valitud faili käsitlemiseks ning lubab selle ka lisada aktiivsesse projekti (kui see on olemas) või lülitada vaadet puu ja nimekirja vahel. Aga proovi seda ise!
Projektihaldus on vahest Quanta Plusi tugevaim külg. See kaart võimaldab vahetult ligi pääseda projekti kuuluvatele failidele ning neil hiire nuppga klõpsates mitmesuguseid asju ette võtta, näiteks lisada, eemaldada või üles laadida üksikuid faile või neid kõvakettalt sootuks kustutada.
Veel üks Quanta Plusi võimalusi on mallid. Need võivad olla mis tahes sulle meelepärane asi alates piltidest kuni koodilõikude või kas või tervete veebilehekülgedeni.
Mallid on sorteeritud kolme kategooriasse vastavalt nende ulatusele või nähtavusele: globaalsed, kohalikud ja projektimallid (nagu Quanta Plusi töötsoonis tervikuna). Nagu nimigi ütleb, on globaalsed mallid alati kasutatavad. Kohalikud mallid on kättesaadavad nende loojale ja projektimallid on nähtavad vaid siis, kui avatud on vastav projekt. Lähemalt räägib mallidest “Mallid”.
Siit leiab infot erinevate skriptide kohta, mida sul on võimalik kasutada. Ka siin toimib jaotus globaalseteks, kohalikeks ja projektiskriptideks. Klõps hiire nuppga mõnel kirjel näitab kogu saadaolevat infot antud skripti kohta. Klõps hiire nuppga aga võimaldab üht-teist ette võtta, näiteks skript käivitada, seda redigeerida või e-postitsi kellelegi lähetada.
See kaart võimaldab näha, kuidas saab dokumendist aru parser. Klõps hiire nuppga elemendil asetab kursori tekstis antud elemendile. Klõps hiire nuppga elemendil lubab mitmel moel puus ringi liikuda ja seda uuendada.
See kaart asub teistest allpool ning võimaldab hõlpsasti redigeerida atribuute ja nimeruume. Sisule orienteeritud kirjete süsteem lubab muuta mis tahes atribuuti kõigest mõne hiireklõpsuga.
Atribuudipuu
Siin on ära toodud põhjalik dokumentatsioon veebitehnoloogiate kohta, mida saab lehitseda otse Quanta Plusi aknas. Eelnevalt pakitud Quanta Plusi dokumendid võib alla laadida aadressilt Quanta Plusi dokumentatsioonisaidilt, aga samahästi võib ka ise luua dokumente Quanta Plusi jaoks ja kohta. Lisades projekti kataloogi "doc", saab lisada, rdigeerida ja vaadata projektiga seotud dokumentatsiooni.
Quanta Plusi infokaardid.
Vaikimisi näitab Quanta Plus akna allosas kaht kaarti, mis pakuvad teatud tulusat infot: teadete aken ja probleemide aken.
Sellel kaardil näeb kõigi Quantas käivitatud skriptide infot, näiteks aktiivses dokumendis kasutatud DTD ja kõik selle muudatused.
Sellel kaardil näeb kõiki aktiivse dokumendi märkekeele vigu. Ka Quanta Plusis käivitatud skriptid annavad oma vigadest (kui neid esineb) teada sellel kaardil.
Quanta Plusi HTML tööriistaribad.
Quanta Plusi tööriistaribad on loodud mahukate ja igati laiendatavatena. Nende mõistmine ei valmista erilisi raskusi: klõpsa nupule ja tulemuseks on nupuga seotud toiming. Mis aga asja mõnusaks teeb, on see, et Quanta Plus laseb toiminguid ise määrata.
Quanta Plusi tööriistaribade kasutamine on imelihtne. Valides menüü , saab neid igati avada, salvestada, lisada ja e-postiga saata. Kui otsustad tööriistariba laadida, võid valida ühe Quanta Plusi kolmest töötsoonist. Loodud tööriistariba saab salvestada kohalikuna või projekti. Kui soovid, et see oleks kättesaadav globaalselt, pead paluma administraatori õigustega isikul asetada see Quanta Plusi globaalsesse kataloogi.
Quanta Plusi tööriistaribade üks vaimustavamaid omadusi on see, et neid saab otse rakendusest e-postiga teistele saata. Quanta Plus saadab tööriistaribad gzipitud tar-arhiivina KMaili vahendusel. Kui saad e-postiga tööriistariba, võid selle salvestada (ja laadida) Quanta Plusis nagu iga muu tööriistariba!
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See peatükk kirjeldab Quanta Plusi neid osi, millega sa kõige rohkem kokku puutud. See võimaldab sul töötada produktiivsemalt ning samal ajal kõike Quanta Plusis just oma käe järgi kohandada.
Nagu mainitud, saab Quanta Plusi tööriistaribasid peamiselt hallata menüü vahendusel. Kasutamine ja loomine on aga mõneti erinevad tegevused ja siinkohal võtame vaatluse alla just kasutamise. Tööriistaribade loomisest räägib eraldi osa “Tööriistaribade loomine”.
Tööriistaribade kasutamine on päris lihtne: klõpsa soovitud elemendi või toimingu ikoonil ning juhtub üks kolmest: element lisatakse (lisavõimalusena ka sulgev element), ilmub elemendi dialoog, mille väljadel saab määrata kindlaks elemendi atribuudid, või siis käivitub toiming, mis teeb midagi muud asjalikku praeguses failis või projektis. Kui arvad, et on äärmiselt aeganõudev ja tüütu kogu aeg käsitsi sisestada mingit elementi, mida Quanta Plus ei paku, saab selle lisada. Täpsemalt räägib sellest “Dokumenditüübi redigeerimispakett (DTEP)”.
Tööriistaribasid ja selle elemente saab seadistada kontekstimenüüst (avaneb hiire parema nupu klõpsuga tööriistaribal), mille abil on võimalik luua uus toiming, uus tööriistariba, valida teatud toiminguid, näiteks Eemalda tööriistariba ja Nimeta tööriistariba ümber, või valida käsk Tööriistariba seadistamine, mis avab dialoogi, kus saab määrata, millised toimingud peavad olema näha sellel või muudel tööriistaribadel.
Kontekstimenüüd tööriistaribal paikneval toimingul (ikoonil) avades näeb seal lisaks mainitud valikutele veel kirjeid Eemalda toiming ja Muuda toimingut, mida ilmselt pole vaja lahti seletada.
Tööriistaribasid ja nende toiminguid saab seadistada menüüköskudega -> ja ->
Kasutaja määratud toimingutest kõneleb pikemalt “Kasutaja määratud toimingud”.
Sildidialoog näeb välja selline:
Sildidialoog.
Siintoodud pildil on ankrusildi dialoog. Kui tead midagi XHTML keelest, siis märkad, et siin on kõik sellised atribuudid, mis ankrus ikka olla võivad. Pane tähele ülal asuvaid kaarte Main, Core and i18n, Events ja Focus, mis sisaldavad vastavalt oma funktsioonile muid ankruelemendis kasutatavaid atribuute. Nüüd tuleb lihtsalt täita tühjad väljad selliste atribuutidega, mida soovid ankrus näha, klõpsata nupule OK ja heihopsti! korralikult vormindatud ankur ongi seal, kus parajasti asub kursor.
Quanta Plusi projektinõustaja ( ->) muudab projekti loomise lustimänguks.
Projektinõustaja.
Väljade tähendus on ilmselge ja neid oleks mõtet täita ülevalt alla, nii võtab näiteks projektinime määramine vähemaks vaeva ülejäänud projektis pidevalt kogu kataloogistruktuuri sisestamisel. Me oleme siiski vaba tarkvara ega piira kuidagi sinu võimalusi rakendust kasutada. Kõik otsinguteed ja autoriinfo väljad on muudetavad nii dialoogis kui ka hiljem menüükäsuga -> (Shift+F7).
Projekti üldised seadistused
Siin saab anda projektile nime. Meie andsime enda omale näiteks nimeks “foo”. Kui täidad välja Nimi, täidetakse väli Fail sinu eest automaatselt ära.
See on Quanta Plusi projektifaili nimi. Vaikimisi on see sinu projekti nimi väiketähtedega, ilma tühikuteta ja laiendiga webprj (nt. foo.webprj). See fail on salvestatud projekti baaskataloogi.
Siin saab valida protokolli, mida kasutada projektile juurdepääsuks. Kui projekt asub samal masinal, kus kasutad Quanta Plusi, võib jätta väärtuseks 'kohalik'. Protokollide nimekiri sõltub süsteemist. Protokollideks võivad olla SSH, FTP, NFS, SMB, WebDAV ja paljud muud. Protokollide kasutamisel aitab kaasa KDE võimas KIO moodulite arhitektuur. See raamistik lubab igal KDE rakendusel kasutada ka võrgus asuvaid ressursse sama hõlpsasti, nagu asuks nad kohalikus masinas.
Siin saab määrata selle serveri aadressi, millele soovid ligi pääseda (kui sa ei kasuta just protokolli 'kohalik'). Sobib nii masinanimi (masin.kuskil.ee) või IP aadress (127.0.0.1).
Võrgumasinasse sisselogiva kasutaja nimi. See on tõstutundlik.
Parool võrgumasinasse siselogimiseks. See on tõstutundlik.
Selle võib jätta tühjaks, et kasutataks porti, mida valitud protokoll vaikimisi tarvitab. Midagi siin muuta on vaja ainult juhul, kui seda nõuab server.
Juurkataloog, kuhu on salvestatud kõik projektifailid ja -kataloogid.
Asukoht, kuhu on salvestatud projektis kasutatavad tööriistaribad. Vaikimisi on see templates. Kui sul on olemas valik faile, mida soovid kasutada mitme projekti juures, võib olla mõttekas määrata siin hoopis nende failide kataloog.
Asukoht, kuhu on salvestatud projektis kasutatavad tööriistaribad. Vaikimisi on see toolbars. Kui sul on olemas valik tööriistaribasid, mida soovid kasutada mitme projekti juures, võib olla mõttekas määrata siin hoopis nende failide kataloog.
See võimaldab lisada faile kohalikust failisüsteemist. Valida võib ka mitu faili või kogu kataloogi.
See võimalus on hea siis, kui sul on staatiline veebisisu, mida soovid alla laadida ja muuta. Kui server kasutab skripte (nt. PHP, Python, jne.), tuleb sul failid muul moel hankida.
Failide lisamine projekti
Märkimisel kaasatakse failid, mis asuvad baaskataloogis. Kui on märkimata, võib projekti nii-öelda tühja koha peale luua.
Märkimisel kaasatakse projekti ainult märkekeele-, skripti- ja pildifailid.
Märkimisel näidatakse kõiki faile ja katalooge baaskataloogis ning sul on võimalik nende seast vajalikud välja selekteerida.
Näitab peakataloogi faile, kus saab märkides vajalikud projekti kaasata või märget eemaldades välja jätta.
Projekti muud seadistused
Sisesta siia oma nimi (või ka varjunimi).
E-posti aadress, kuhu soovid saata projektiga seonduvaid asju.
Võimalus valida märkekeel, mida antud projektis põhiliselt kasutad.
Võimalus valida kodeering, milles tuleb projekti failid avada ja salvestada.
Võimaldab anda asukoha prefiks, mis osutab kuhugi mujale kui kohalikku failisüsteemi. See on kasulik näiteks lehekülgede puhul, millel on dünaamiline sisu ja mis sõltuvad serveri toimimisest (nt. PHP, JSS, Python jne.). Kirjuta siia aadressi esimene osa, nagu see eksisteerib serveril. ning Quanta Plus lõpetab ise faili otsingutee. Kui näiteks domeen on bar.com ning sa redigeerid lehekülge index.html, võid seda redigeerida võrgumasinal (foo.bar.com), laadida serverile ning vajutada F6, et näha tulemusi asukohas www.bar.com, mitte kohalikus failisüsteemis.
Prefiks, mida soovid kasutada.
Kopeerib globaalsed mallid projekti kataloogipuusse.
Kopeerib kohalikud mallid projekti kataloogipuusse.
Uue projekti nõustaja viimasel kaardil on kolm võimalust, mis peaksid elu mitmeti kergemaks muutma. Neid saab kasutada ka menüükäsuga -> (profiilide üleslaadimise kaardil) või kiirklahviga Shift+F7.
Projekti omaduste dialoog näeb välja selline:
Üldiste valikute kaart
Mõned elemendid on samad, mida kohtab projekti nõustajas. Neid kirjeldab “Uued projektid”. Siin on kirjeldatud nõustajas puuduvaid valikuid.
Projekti üldised seadistused
Failide nimekiri (kasutada võib ka metamärke), mida ignoreeritakse, kui sooritad mingeid projektiga seotud toiminguid (näiteks ).
Eelneva täiendus, võimaldab projekti toimingutest välja jätta failid, mida toob ära fail .cvsignore.
Projektivaade, mis laetakse projekti avamisel. Projektivaadetest räägib lähemalt “Projektivaated”.
Võimaldab valida kasutatava siluri. Praegu on toetatud ainult Gubed. Gubedi kohta leida rohkem infot siit. Siluripluginat saab seadistada klõpsuga nupule Valikud. Täpsemalt räägib silumisest “Silumine Quanta Plusis”.
Projektivaade, mis laetakse projekti avamisel. Projektivaadetest räägib lähemalt “Projektivaated”.
Kaardil Profiilide saatmine saab määrata üleslaadimise profiile (vt. “Profiilide üleslaadimine”), samuti lubada iga profiili puhul serveri sisu puuvaate näitamine, kui märgid ära kasti Igal profiilil näidatakse puuvaadet.
Kaardil Meeskonna seadistamine saab lisada, muuta ja eemaldada projekti liikmeid, samuti määrata kindlaks meililisti. Täpsemalt räägib sellest “Meeskonnatöö”.
Kaardil Sündmuste seadistamine saab sisse lülitada sündmuste toimingute lubamise ning neid toiminguid lisada, muuta ja eemaldada. Sündmuse toiming käivitatakse teatud eelnevalt määratud sündmuse toimumisel, näiteks faili salvestamisel. Täpsemalt räägib sellest “Sündmuste toimingud”.
Vaikimisi avab Quanta Plus käivitamisel viimati kasutatud projekti. Seda omadust ei saa praegu muuta.
Uue projekti avamiseks vali menüüst käsk või vajuta tööriistaribal ikooni Ava projekt. Ilmub projekti avamise dialoog, mis võimaldab valida just selle projekti, mida soovid. Projektidel on laiend webprj.
Quanta Plusi sulgemisel salvestatakse projektifail automaatselt. Sul palutakse enne Quanta Plusi sulgemist salvestada muudatused failides, kui neid esineb. Sama juhtub uue projekti laadimisel.
Projektipuu pakub võimaluse pääseda hõlpsasti ligi projekti failidele. Siin saab hallata kõiki aktiivse projekti faile.
Failide puhul avab klõps hiire nuppga järgmise menüü:
Need kirjed kõnelevad ise enda eest, nii et uuri neid omal käel.
Kataloogid on põhimõtteliselt samasugused, kuid hiire nupp ei paku oma menüüs võimalusi ja :
Ka need kirjed on nii iseenesestmõistetavad, et ei vaja lähemat seletamist.
Projekti üleslaadimise dialoog:
Projekti üleslaadimise dialoog.
Siin saab valida profiili. Profiil sisaldab infot üleslaetavate failide asukoha kohta. Lähemalt räägib sellest “Profiilide üleslaadimine”.
Selle nupuga saab luua uusi üleslaadimise profiile.
See võimaldab muuta parajasti valitud üleslaadimise profiili.
See võimaldab eemaldada parajasti valitud profiili. Kui saadaval on vaid üks profiil, ei saa nuppu kasutada.
Parool salvestatakse mällu ja kustutatakse sealt pärast programmi sulgemist. See on kasulik juhul, kui sul on vaja sageli faile üles laadida, aga sa ei soovi kasutada vähemturvalist võimalust “Parool salvestatakse kettale”.
Üleslaadimiseks valitakse kõik projekti failid.
Üleslaadimiseks valitakse kõik muudetud failid.
Nimekirjast eemaldatakse kõik failid.
Kõigi nimekirja failide valimine/valiku tühistamine.
Kerib lahti kõik kataloogid.
Kerib kokku kõik kataloogid.
Värskendab nimekirja.
Käivitab üleslaadimise
See katkestab käimasoleva üleslaadimise või lihtsalt sulgeb dialoogiakna, kui sul tuli enne üleslaadimise alustamist mõni parem mõte.
Quanta Plus võimaldab luua hulga üleslaadimise profiile ja sel moel laadida projekte (kas täielikult või osaliselt) erinevatele serveritele. Profiili muutes või luues näed sellist dialoogi:
Kirjuta siia meelepärane profiili nimi.
Serveri nimi, kuhu failid kopeeritakse. Kõlbab nii täielik domeeninimi kui ka IP aadress.
Failide üleslaadimiseks kasutatav protokoll. Sõltuvalt KDE versioonist võivad valikuvõimalused erineda. Igatahes peaks oleva võimalik valida FTP, faili (st. kohaliku) ja NFS vahel.
Failide edastamisel kasutatav port. Tavaliselt ei pea selle üle pead vaevama, kui just sinu võrguadministraator ei kasuta mõnda tavapärasest erinevat porti.
Autentimiseks kasutatav kasutajanimi.
Autentimiseks kasutatav parool.
Sõltuvalt sinu paranoilisustasemest võib see olla hea või halb võimalus. Kasuta seda oma paremal äratundmisel. Aga et sa teaksid: parool säilitatakse kettal puhta tekstina, kuid kergelt segiaetuna, nii et seda ei saa niisama lugeda, küll aga suudab igaüks, kel vähegi teadmisi programmeerimisest, selle hõlpsasti lahti harutada.
Asukoht serveris, kuhu failid kopeeritakse.
Võimaldab muuta parajasti vaadatava profiili vaikimisi kasutatavaks
Projektivaade koosneb teatud valikust failidest ja tööriistaribadest. Projektis võib olla mitu vaadet, mis tähendab, et pelgalt vaadet vahetades saab laadida terve rea faile ja tööriistaribasid, mis asendavad seni avatud olnud failid ja tööriistaribad.
Vaateid saab salvestada, avada ja kustutada menüü käskudega või projektiriba abil, mille saab avada menüükäsuga ->->.
Võimalik on valida endale vaikevaade, mis laaditakse projekti avamisel. Vt. “Projektide seadistamine”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Mallid on põhimõtteliselt eelnevalt vormindatud dokumendid, koodilõigud ja lingitavad failid. Quanta Plus kasutab malle samamoodi kui standardseid faile, andes neile omalt poolt vajaliku vormingu. Mallipuusse võib kopeerida, liigutada või linkida suvalise süsteemis olemasoleva hoidla. Quanta Plusi mallid ei piira sinu tegevusvabadust karvavõrdki vähem kui tavalised failid.
Mallid paiknevad alamkataloogides. Pole vahet, kui sügavale puu viia, kuid Quanta Plus eeldab siiski, et alamkataloogides asuvad samalaadse tegevuse mallid, mida pakub vastav emakataloog. Lisaks võimaldavad mallid kasutada eel- ja järelteksti nende sidumiseks mitte-dokumentidest mallidega. See lihtsustab vajalike siltide loomist. Edaspidi kavatseme pakkuda ka võimalust edastada tekstile muutujaid, näiteks pildi suuruse infot, mis aitab veelgi paremini silte luua.
Mallide sügavam mõte on tekitada “kontseptuaalsed” mallid, mis võimaldavad näiteks määrata nimekirja korraldamise või luua infosektsiooni. Ideaalis peaks need muutma kasutaja töö tootlikumaks ja dünaamilisemaks. Lõppsiht oleks sellise strukturaalse mallisüsteemi loomine, mis võimaldaks käigult valmis teha kas või kogu veebisaidi, andes sellele vaid meelepärase sisu. Kui soovid sellele kaasa aidata, siis vaata lähemalt meie abisoovide lehekülge.
Mõned Quanta Plusiga kaasa pandud mallid võivad seada piiranguid enda kasutamisele. Loe hoolikalt iga malli alguses toodud kasutamistingimusi, enne kui seda rakendama asud.
Quanta Plus toetab paljsid mallitüüpe, nimelt:
| Binaarmallid |
| Dokumendimallid |
| Tekstijupid |
| Saidimallid |
Binaarfailid on kõik see, mis pole puhas tekst. Need võivad olla mis tahes failid (välja arvatud tekstifailid), sealhulgas pildid, PDF, Flash jne. Binaarmallid kaasatakse dokumenti tavaliselt viitadega (st. pildid kui <img src=/src/url>). Mõned näited leiab mallipuust globaalsete mallide all. Mallipuud tutvustab lähemalt “Tööriistavaated”.
Dokumendid võivad olla mis tahes tüüpi tekstidokumendid. Nende mallide põhjal saab luua uusi dokumente. Üldiselt oleks mõttekas spetsiifilisemad või erinevat tüüpi dokumendid koondada erinevatesse alamkataloogidesse. Seal on võimalik sooritada kõige olulisem redigeerimine ning enda tegevus organiseeritumalt ja tõhusamalt lõpule viia. Mõned näited leiab mallipuust globaalsete mallide all. Mallipuud tutvustab lähemalt “Tööriistavaated”.
Sellist tüüpi mall on tulus juhul, kui sa ei soovi luua malli põhjal uut dokumenti, vaid lihtsalt sisestada dokumentidesse ühesugust teksti. Mall võib sisaldada mida tahes alates kommentaarist ja lõpetades täieliku menüükäsitlemise JavaScripti meetodi või Perli skriptiga. Mõned näited leiab mallipuust globaalsete mallide all. Mallipuud tutvustab lähemalt “Tööriistavaated”.
Nagu nimigi ütleb, on need mallid abiks kogu veebisaidi loomisel malli põhjal. Need kujutavad endast mitmesuguste dokumentide kogumit, mida saab korraldada kataloogidesse, kõik üheskoos tihendatud tar-arhiivis. Hetkel ei paku Quanta Plus veel saidimallide näidiseid.
Malle saab kasutada vastavalt nende töötsoonile Quanta Plusis.
Loo dokumendistruktuur, mis sulle meeldib (XML, HTML, DocBook jne.) ning vali menüükäsk ->->.
Kui see on tehtud, märkad (ka siis, kui salvestasid projektimallina), et malli ei ole näha projekti kaardivaates. Vaata mallipuud, kus leiad oma malli projektimallide kaardilt.
Vali dokumendis mingi tekst ja seejärel menüükäsk ->->. Teine võimalus on valik lihtsalt lohistada Mallipuusse.
Binaarmalli loomine on väga lihtne: kopeeri lihtsalt fail mallikataloogi. Selleks saab kasutada tavapäraseid failihaldusvõimalusi, näiteks lohistamine või kopeerimine ja asetamine Konquerorist või Failipuust.
Projektimallid võimaldavad tähelepanu koondada sisule. Sa võid luua päiseid, jaluseid või muuta veebisaidi dünaamiliseks, kaasates ning linkides PHP faile. Lisaks sellele on veel mitmeid lahedaid asju, mida tasuks mallide kasutamisel projektides silmas pidada.
Projekti luues võid sellesse kopeerida kas või kõik globaalsed ja kasutaja mallid. Sa saad ka valida, kus mallifailid asuvad: nad võivad näiteks paikneda serveri juurkataloogis, kust neid saab hõlpsasti üles laadida, või siis ka kuskil ainult sulle teadaolevas ja ligipääsetavas kohas mõnes alamkataloogis. Kui lingid faili, mida ei leidu projekti mallides, soovitatakse sul see enne linkimist kopeerida projektimallide kataloogi. See väldib linkide katkemist üleslaadimisel. Sa saad alati ise määrata, kuhu ja millised mallid panna, nii et nende asukoht on vaid sinu enda teha. Quanta Plus siiski ei jälgi seda ise, nii et liigutamise korral tuleb muuta ka linke.
Mallistruktuur mallikaardil tugineb failidele, mis asuvad kataloogides $ ja KDEDIR/share/apps/quanta/templates $. Need kataloogid on defineeritud ühena järgnevatest sisutüüpidest (vaata eespool): HOME/.kde/share/apps/quanta/templates
Iga kataloogi käitumise määramiseks tee kataloogi nimel mallivaates klõps hiire nuppga ja vali . Ilmub järgmine dialoog:
Omaduste dialoog.
Hüpikkast kolme äsja mainitud tüübiga, st. failid, tekst, mall. See kast ei ole kasutatav, kui oled märkinud kasti, mis lubab kasutada eellaselt päritud atribuuti.
<foo>)See on vaikimisi lubatud ning sobib üldiselt kõigile kataloogidele, välja arvatud mallipuu ülemkataloogid. Kui see on lubatud ka mallipuu ülemkataloogi puhul, tühistab see sisuliselt antud kataloogi mallid, kui neis ei ole just selgelt vastupidi määratud. Kui tegemist ei ole ülemkataloogiga, siis <blah> kohal seisab näiteks text/all või midagi sellist. Kui seal midagi ei seisa, on tõenäoline, et tegemist on ülemkataloogiga.
Võimaldab antud kataloogi mallide puhul kasutada eel- ja järelteksti. Selleks võib olla kõigile käesoleva projekti mallidele ühine päis/jalus, misjärel võib kopeerida malli sisu kataloogi ning tulemuseks on korralik lehekülg, kus juba olemas ka vastav päis ja jalus.
Tekst, mis lisatakse enne malli sisu.
Tekst, mis lisatakse pärast malli sisu.
Lisaks sellele võid hiire nuppga klõpsates kasutada mitmekesiseid failihaldusvahendeid kataloogide loomiseks või mallide kopeerimiseks ja asetamiseks ühest kohast teise.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Lehekülje visuaalse esituse (VPL) redaktor (kannab ka nimetust WYSIWYG ehk “Mida sa näed, seda sa saad”) võimaldab redigeerida HTML või XHTML dokumenti ning näha jooksvalt kõiki muudatusi. Sarnaselt suvalise tekstiredaktoriga saab dokumendis klõpsata ning klõpsamise kohta ilmub kursor, lubades lisada teksti, pilte, tekstidekoratsioone jne. VPL eesmärk on pakkuda võimalust luua suurepäraseid ja korrektseid veebilehekülgi ilma interneti märkekeeli üksipulgi selgeks tegemata.
Quanta Plus pakub välja kaks režiimi: VPL redaktor ja VPL ja lähteteksti redaktor, mis on kättesaadavad menüüst . Esimene neist asendab Lähteteksti redaktori VPL redaktoriga, teine aga jagab redaktori akna kaheks: Lähteteksti redaktor ja VPL redaktor.
VPL redaktor töötab nii: dokument laetakse normaalse HTML või XHTML leheküljena ning nähtavale ilmub kursor. Siis võid dokumenti redigeerida ning uuesti Lähteteksti redaktorile lülitudes näha, et VPL redaktoriga tehtud muudatused on liidetud Lähteteksti redaktori vaatesse.
Kui redigeerida VPL redaktoriga dokumenti, mis sisaldab PHP koodi, siis osutab väike roheline ikoon PHP koodile. Seda koodi ei saa vahetult VPL redaktoris redigeerida, PHP muutmiseks on vajalik Lähteteksti redaktor. Vähemalt praegu ei ole kavas seda muuta.
Teine režiim on esimesega üpris sarnane, ainult et muudatusi näeb otsekohe kas Lähteteksti redaktoris või VPL redaktoris ning kursorid lähteteksti redaktoris ja VPL redaktoris on sünkroniseeritud. Selle režiimi avab F9, kui see on aga juba avatud, viib sama käsk fookuse ühelt vaatelt teisele, jäädes dokumendis endas samasse asukohta.
Värskendamisintervall VPL redaktori ja Lähteteksti redaktori vahel on seadistatav. Vali -> ja seejärel kaart . Seal saab valida, kas värskendatakse ainult vastava käsu peale või automaatselt. Kui valida automaatne võimalus, saab määrata värskendamise intervalli. Üldiselt tasuks siin silmas pidada, et mida kiirem on arvuti, seda väiksem võiks olla määrang ja vastupidi.
VPL ja lähteteksti redaktori režiim.
Oletame nüüd, et soovid redigeerida oma veebilehekülje tiitlit. Kuidas seda teha? Käivita ->. See võimaldab redigeerida “nähtamatuid” silte, kui kasutusel on VPL redaktor. Dialoog Dokumendi omadused avatakse ka siis, kui luua VPL redaktoris uus dokument. Nii kahandatakse vajadust kõike käsitsi määrata. Selle abil on võimalik redigeerida järgmisi asju:
Dokumenti pealkiri.
Metasildid võimaldavad salvestada infot dokumendi enda kohta, nt. võtmesõnu, mida saaks kasutada interneti otsingumootorid. Metaelemente saab lisada või eemaldada allolevat kaht nuppu klõpsates ning seejärel nimekirjas olevaid kirjeid redigeerides, nt. seades “võtmesõnad” veergu “nimi” ja “võtmesõna1 võtmesõna2” veergu “sisu”.
CSS reeglid on uus viis anda veebilehitsejale teada, kuidas lehekülge näidata. CSS reegleid saab lisada või kustutada allolevate nuppudega. Võimalik on täita ka tühjad väljad, näiteks Metaelemendid. CSS reeglite muutmine ei ole veel toetatud.
On ka võimalik linkida väline CSS laaditabel. Selleks klõpsa nupul Lehitse ja vali vajalik fail.
Kursorit saab kasutada nagu tekstiredaktoris, liigutades seda nooltega. Vahel võib küll juhtuda, et kursor ei taha minna sinu soovitud asukohta. Tavalisel moel käib ka valimine. Teksti saab lisada klaviatuurilt sisestades, eemaldada aga klahviga Backspace või Delete.
Nüüd jõuame siltide lisamiseni. Lisada on võimalik pilte, aplette, tekstidekoratsioone, näiteks rasvane kiri ja muu selline ning kõike seda samu tööriistu kasutades, mida pruugib ka lähteteksti redaktor. Arvesta, et siltide lisamine ei eemalda varasemaid identseid silte, nt. kui lisada ankrusilt mingile tekstile, tuleb eemaldada sama tekstiga seotud muu ankur.
Mõned tööriistariba elemendid on tõenäoliselt välja lülitatud, näiteks Tabelinõustaja või Kiirnimekirja nõustaja. Hiljem hakkavad nad VPL redaktoris tööle, kuid praegu tuleb kasutada tööriistaribal võimalusi Tabelid või Nimekirjad.
Sildi, olgu siis pildi, apleti või mille tahes muutmiseks lülitu atribuudipuule (selle avab ->. Klõpsa sildil, mida soovid redigeerida, või kui see ei ole kättesaadav, siis mis tahes objektil, mida vajalik silt sisaldab. Atribuudipuu näitab nii aktiivset silti kui ka kõigi selle eellaste ja atribuutide nimekirja. Praegu ei toeta VPL näiteks XHTML+MathMl, kuid igatahes saab selles vaates redigeerida nimeruume. Klõpsa lihtsalt väljal Väärtus ja muuda seda, mida soovid muuta. Kui soovid liikuda aktiivse sildi eellaste juurde, vali silt ning atribuudipuu laebki selle.
Sildi kustutamiseks kasutame atribuudipuud. Kas oled märganud kaht väikest punast risti ülemises parempoolses servas? Esimene neist kustutab ainult parajasti valitud sildi ning kui HTML/XHTML spetsifikatsioon ei luba mõningatel kustutatud sildi järglastel muutuda kustutatava sildi eellassildi järglasteks, kustutatakse ka need ja nii edasi. Valitud sildi teine rist kustutab nii valitud sildi kui ka selle järglased, nii et siin tasub olla hoolikas ja ettevaatlik.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See peatükk tutvustab kõiki funktsioone, mida saab leida menüüribalt.
Loob uue tühja faili.
Avab olemasoleva faili.
Hõlpsama kasutamise huvides on toodud ära nimekiri viimati avatud failidega. Nimekiri muutub iga kord, kui avad faili, mida selles veel ei ole — see sunnib kõige varem avatud faili nimekirjast välja.
Salvestab muudatused aktiivses failis.
Salvestab aktiivse faili uue nimega.
Võimaldab salvestada koodi ja isegi terveid faile mallina, mida saab hiljem teiste failide juures kasutada. Vaata lähemalt peatükki Mallid. Kui püüad valitud teksti/faili salvestada väljaspool kohaliku/projetimalli kataloogi, saad veateate.
Võimaldab salvestada faili kohaliku mallina.
Võimaldab salvestada faili projektimallina.
Võimaldab salvestada valitud teksti (nt. koodijupi) kohaliku malli failina.
Võimaldab salvestada valitud teksti (nt. koodijupi) projektimalli failina.
Salvestab kõik muudetud failid redaktoris.
Laeb parajasti aktiivse dokumendi uuesti.
Dokumente saab kohe päris tegelikult välja trükkida. Kasutatakse kprinteri liidest.
Lõpetab Quanta Plusi töö
Tühistab viimase toimingu.
Sooritab uuesti viimase tagasivõetud toimingu.
Lõikab valitud tekstiploki ja asetab selle sisu lõikepuhvrisse.
Kopeerib valitud tekstiploki lõikepuhvrisse.
Asetab lõikepuhvri sisu kursori asukohta.
Teisendab lõikepuhvri teksti HTML-erimärgid HTML-olemiteks enne nende asetamist põhiteksti, et neid oleks vaatamisel võimalik korrektselt esitada, ilma et kliendi veebilehitseja neid siltideks peaks.
Teisendab lõikepuhvri teksti kodeeritud URL-iks, mis on korrektne viis kaasata erimärke ja tühikuid URL-idesse. Kasutatakse peamiselt URL-i asetamiseks ankrusilti.
Valib kogu aktiivse dokumendi teksti.
Tühistab kogu aktiivse dokumendi teksti valiku.
Lülitab sisse/välja bloki esiletõstmise. Võimaldab valida tekstiplokke klaviatuurilt ilma klahvi Shift all hoidmata.
Sama, mis klahvi Insert vajutamine.
Otsib aktiivsest dokumendist stringi või regulaaravaldise vastavust.
Kordab otsingut dokumendis käesolevast asukohast edasi.
Kordab otsingut dokumendis käesolevast asukohast tagasi.
Asendab stringi või regulaaravaldise aktiivses failis.
Liigub määratud reale. See on päris kasulik, kui PHP skript paistab üle pea kasvavat!
Otsib stringi või regulaaravaldist valitud kataloogi failides. Omamoodi grepi või sedi GUI mõningate eelnevalt määratud mustritega, mis otsingut hõlbustavad.
Laiendab ehk avab lühendid. Lühendeid saab defineerida dialoogis ->.
Vormindab lähteteksti ümber samade reeglite põhjal, millega VPL komponent lisab silte.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Lülitab failipuu näitamise sisse ja välja.
Lülitab projektipuu näitamise sisse ja välja.
Lülitab mallipuu näitamise sisse ja välja.
Lülitab skriptipuu näitamise sisse ja välja.
Lülitab struktuuripuu näitamise sisse ja välja.
Lülitab atribuudipuu näitamise sisse ja välja.
Lülitab dokumentatsioonipuu näitamise sisse ja välja.
Lülitab teadete akna näitamise sisse ja välja. See on aken, kus saab näha skriptide ja siluja tegevuse väljundit.
Lülitab probleemide teadustaja näitamise Quanta Plusi peaakna allosas sisse ja välja. Probleemide teadustaja muutub aktiivseks, kui lülituda struktuuripuule.
Näitab annotatsioonivaadet. Sellest räägib lähemalt “Annotatsioonid”.
Näitab üleslaadimisprofiili faile serveris.
Lülitab ikoonipiirde näitamise redaktori põhiakna vasakus servas sisse ja välja. See piire võimaldab klõpsates järjehoidjaid lülitada.
Lülitab reanumbrite näitamise redaktori põhiakna servas sisse ja välja.
Lülitab sisse ja välja teksti vormindamise konkreetsele laiusele kirjutamise ajal.
Lülitab redigeerimiseks sisse dokumendi lähteteksti.
Lülitab dokumendi redigeerimiseks sisse VPL redaktori.
Lülitub dokumendi redigeerimiseks poolitatud ekraani vaatele.
Aktiivse dokumendi eelvaatlus.
Liigub eelvaatluses ühe sammu tagasi.
Liigub eelvaatluses ühe sammu edasi (eelnevalt peab olema tagasi mindud).
Laadib eelvaatluse uuesti kettalt.
Vaatab aktiivset faili Konqueroris.
Vaatab aktiivset faili Mozilla Firefoxis.
Vaatab aktiivset faili veebilhtisejas Mozilla®.
Vaatab aktiivset faili Netscape®s.
Vaatab aktiivset faili Operas.
Vaatab aktiivset faili Lynxis (tekstipõhine veebilehitseja).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Lisab järjehoidja aktiivse faili aktiivse rea asukohta.
Kustutab kõik aktiivse dokumendi järjehoidjad.
Kui aktiivses failis on järjehoidjaid, on meed näha menüüs koos kirjetega Eelmine või Järgmine vastavalt kursori asukohale dokumendis.
Kui järjehoidjaid esineb mõnes muus avatud dokumendis, on need näha menüüs nende dokumentide nime kandvasse alammenüüsse koondatult.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Seda, kuidas kasutada Quanta Plusis projekte, kirjeldab “Projektid”.
Käivitab projekti loomise nõustaja.
Avab kettalt olemasoleva projektifaili. Quanta Plusi projektid salvestatakse laiendiga .webprj.
Näitab nimekirja viimati kasutatud projektidega.
Sulgeb aktiivse projekti.
Avab “vaate” ehk varem salvestatud konkreetse failide kogumi.
Salvestab parajasti avatud failid “vaatena”.
Salvestab parajasti avatud failid “vaatena” uue nime all.
Kustutab “vaate”.
Avab dialoogi, mis võimaldab valida failid, mida soovid lisada aktiivsesse projekti. Need kopeeritakse seejärel projektikataloogi, kus neid saab redigeerida.
Lisab aktiivsesse projekti kataloogi ja kogu selle sisu.
Uurib läbi projekti kataloogi, et tuvastada võimalikke uusi faile. See lubab näiteks kopeerida graafikafaile projektikataloogi või selle alamkataloogi ning need seejärel projektile lisada.
Laeb projektifailid serverile. Saadaolevate transpordiprotokollide valik sõltub sellest, millist KDE versiooni sa kasutad ja kas oled laadinud alla täiendavaid KIO mooduleid või mitte.
Seadistused, mis puudutavad seda, kuidas Quanta Plus sinu projekti haldab. Lähemalt vaata selle kohta peatükist Quanta Plusi projektid.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Laeb globaalsena defineeritud tööriistariba. Need paiknevad vaikimisi kataloogis $. KDEDIR/share/apps/quanta/toolbars
Laeb kohalikuna defineeritud tööriistariba. Need paiknevad vaikimisi kataloogis $. HOME/.kde/share/apps/quanta/toolbars
Laeb projekti tööriistariba. Need paiknevad kataloogis projekti_kataloog/toolbars
Dialoog tööriistaribade salvestamiseks. Võimaldab valida tööriistariba tüübi: kohalik või projekti tööriistariba.
Salvestab kohaliku tööriistaribana ($) HOME/.kde/share/apps/quanta/toolbars
Salvestab projekti tööriistaribana (ProjectDir/toolbars
Avab uue tööriistariba loomise dialoogi. Selles saab anda ainult nime. Toimingud tuleb lisada menüükäsuga ->. Tööriistaribad saab salvestada menüükäsuga ->, samuti palutakse salvestamata tööriistaribade sulgemisel need salvestada.
Eemaldab tööriistariba kasutuselt, kuid mitte kettalt. Kui sa ei ole eemaldatavat tööriistariba salvestanud, palutakse sul seda teha.
Lubab tööriistariba ümber nimetada.
See on võimalus saata enda lemmiktööriistariba kellelegi teisele (näiteks Quanta Plusi meeskonnale, kes saaks selle järgmises versioonis juba pakituna kaasa panna!). E-posti rakenduse aken avaneb automaagiliselt, samuti automaagiliselt lisatakse tööriistariba e-kirjale kaasatud failina.
Võimaldab laadida tööriistariba ressursside peaserverisse. Vt. “Ressursside jagamine”.
Võimaldab laadida tööriistariba peaserverisse, kust teised saavad seda alla laadida. Vt. “Ressursside jagamine”.
See võimaldab tõmmata tööriistaribasid internetist. Vt. “Ressursside hankimine”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Avab dialoogi, mis võimaldab muuta aktiivse dokumendi DTD-d (dokumendi tüübi määratlust).
Võimaldab muuta DTEP description.rc konfiguratsioonifaili.
Laeb sinu või kellegi teise loodud DTD ja teisendab selle Quanta Plusi vormingusse.
Laeb/uuendab olemeid DTD-st. See on kasuks, kui soovid uuendada olemeid DTEP-s ilma kogu DTEP-d regenereerimata. Kui DTEP on globaalne ja sul ei ole KDE globaalses kataloogis kirjutamisõigust, ei saa sa ka olemeid laadida.
Laeb sinu DTEP.
Võimaldab saata DTEP KMaili abil sõbrale.
See võimaldab laadida DTEP serverile. Vt. “Ressursside jagamine”.
See võimaldab tõmmata DTEP pakette internetist. Vt. “Ressursside hankimine”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See menüü sisaldab silte, mis leiduvad parajasti laaditud tööriistaribadel, s.t. kui laaditud on standardne (HTML) tööriistariba, siis on menüüs näha alammenüü , mis sisaldab antud tööriistariba silte/tegevusi.
Võimaldab kasutada aktiivse märgistuskeele sildi seadistustedialoogi, kui see on võimalik. See kirje on alati olemas, sellele järgnevad DTD alammenüüd.
Tõstab aktiivse sildiala esile. Sildiala algab hiirekursori asukohast.
Lülitab sisse või välja siltide nutika lisamine. Praegu toimib ainult (X)HTML DTD-de korral. Nutikas lisamine tähendab, et Quanta Plus keeldub lisamast tööriistariba abil sisestatud silti, kui see ei saa esineda antud asukohas.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Menüü toob ülalmainitud menüüelementide järel ära kõik kättesaadavad pluginad. Neist mõnel klõpsamine aktiveerib antud plugina. Klõps aktiveeritud plugina nimel lülitab selle välja.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Võimaldab valida esiletõstu režiimi aktiivsele failile. Saadaolevate esiletõstu skeemide nimekiri sõltub Kate paigaldatud versioonist.
Võimaldab valida rea lõpu koodi tüübi. See on kasulik, kui arendustegevuses osaleb ka teisi operatsioonisüsteeme kasutavaid inimesi. Valikuvõimalused: , , .
Liigutab valitud tekstibloki ühe tabeldusmärgi võrra paremale.
Liigutab valitud tekstiploki ühe tabeldusmärgi võrra vasakule.
Eemaldab kogu taanduse.
Muudab valitud teksti kommentaariks.
Eemaldab valitud tekstilt kommentaarimärgi.
Reamurdmine aktiivses aknas eelnevalt määratud veerus.
Kontrollib aktiivse dokumendi õigekirja.
Võimaldab redigeerida parajasti avatud dokumendi omadusi, kui kasutatakse VPL redaktorit.
Muudab siltide ja/või atribuutide tähesuuruse vastupidiseks.
Kontrollib aktiivse dokumendi süntaksit valitud DTD suhtes välist rakendust tidy kasutades.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Sulgeb aktiivse kaardi (dokument, plugin, eelvaatlus või dokumentatsioon).
Sulgeb kõik avatud kaardid.
Võimaldab lennult lülitada erinevaid kasutajaliidese režiime. KDE teekide teatud piirangute tõttu võib lülitumine võtta aega ja põhjustada inetuid ilminguid. Soovitatav on kasutada IDEAl režiimi, mis on vaikerežiim, või kaartidega lehekülje režiimi, mida kasutas Quanta Plus 3.2 ja varasemad versioonid.
Lisaks sellele on menüüs kirje iga avatud kaardi kohta. Neist mõnda valides aktiveeritakse valitud kaart.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Näitab või peidab tööriistaribad, mis ei kuulu kasutajale.
Lülitab spetsiifilise DTD tööriistariba näitamise sisse ja välja.
Lülitab olekuriba näitamise Quanta Plusi peaakna allservas sisse ja välja.
Quanta Plusi käitumise seadistamine.
Põimitud eelvaatluse seadistamine.
Ilmuvas dialoogis tehtud muudatused mõjutavad kõiki rakendusi, mis kasutavad KHTML-komponenti, sealhulgas veebilehitsejat Konqueror.
Siin saab määrata tööriistaribadel kasutatavaid toiminguid. Vt. “Kasutaja määratud toimingud”.
Siin saab määrata ja muuta pluginaid.
Võimaldab seadistada redaktoriakna käitumist. Vaata lähemalt Kate käsiraamatut.
Dialoog võimaldab lisada/eemaldada tööriistaribade elemente ning muuta neil esinevate ikoonide järjekorda.
Võimaldab seadistada terve hulga Quanta Plusis kasutatavaid kiirklahve.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Quanta Plus sisaldab standardset KDE menüüd ning veel järgmisi elemente:
Peaks tekitama hiirekursori asukohta kohtspikri. Käsiraamatu kirjutamise ajal ei olnud veel rakendatud.
Quanta Plus on väga kvaliteetne vabalt saadav ja vaba litsentsiga toode, kuid nagu vaba tarkvara projektide puhul ikka, ei ütle arendajad kunagi abist ära. Kui sa soovid Quanta Plusi arendamisele rahaliselt kaasa aidata, saad siit teada, kuidas seda teha.
Tavapärased KDE abimenüü elemendid on järgmised:
Käivitab KDE abisüsteemi ja avab this application abimaterjali (käesoleva käsiraamatu).
Muudab hiirekursori noole ja küsimärgi kombinatsiooniks. Klõpsates nüüd mõnel this application elemendil, avaneb väike abiaken (kui see on antud elemendi kohta olemas), mis selgitab elemendi funktsiooni.
Avab vearaporti dialoogi, mille abil saab teada anda veast või esitada oma “soov” millegi parandamiseks.
Näitab versiooni ja infot autori kohta.
Näitab KDE versiooni ja muud olulisemat põhiinfot.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See peatükk kirjeldab võimalusi määrata Quanta Plusi käitumine,
Seadistustedialoogid saab avada menüüst Seadistused. Me puudutame siin neist ainult mõningaid, sest ülejäänud ei ole omased ainult Quanta Plusile ning nende lühikese kirjelduse annab “Menüü ”.
Seadistustedialoogi saab avada menüükäsuga + Dialoogil on mitu kaarti, mida me nüüd tutvustame.
Siin saab muuta Quanta Plusi käitumist siltide osas, sealhulgas automaatse lõpetamise võimalusi. Valikud on järgmised:
Sildi tähesuurus: automaatselt lisatud siltide tähesuurus. Vaiketähesuurus tähendab, et sildid lisatakse nii, nagu neid kirjeldavad tagXML-failid.
Atribuudi tähesuurus: automaatselt lisatud atribuutide tähesuurus. Vaiketähesuurus tähendab, et atribuudid lisatakse nii, nagu neid kirjeldavad tagXML-failid.
Atribuudi jutumärgid: kuidas asetatakse jutumärkidesse Quanta Plusi lisatud atribuudid.
Automaatne lisasiltide sulgemine: märkimisel suletakse sildid, mille jaoks sulgev silt ei ole kohustulik, automaatselt pärast sildi > sisestamist.
Automaatne tavasiltide sulgemine: sama, mis eelmine kõigi muude siltide jaoks, välja arvatud muidugi üksiksildid.
Automaatse lõpetamise kasutamine: võimaldab lülitada sisse või välja siltide, atribuutide, funktsioonide jms. automaatse lõpetamise.
Alustava/lõpetava sildi automaatne uuendamine: märkimisel muudetakse alustava sildi muutmisel alati automaatselt vastavat sulgevat silti ja vastupidi.
Rõhumärkidega tähtede automaatne asendamine: märkimisel asendatakse rõhumärkidega tähed kirjutamise ajal nende koodiga.
See kaart tegeleb töökeskkonna ja teatud vaikeseadistustega.
MIME tüübid: erinevat tüüpi failide äratundmiseks kasutatavad MIME tüübid. Nupuga Vaikeväärtused saab väljad täita vaikeseadistustega.
Vaikekodeering: uute failide või muul meetodil kui -> (seal saab kodeeringut muuta) laetud failide kodeering. Projekti laadimisel on võimalik seda tühistada dialoogis Projekti omadused.
Vaike-DTD: uute failide või tundmatu DTD-ga failide puhul kasutatav DTD. Projekti laadimisel on võimalik seda tühistada dialoogis Projekti omadused.
VArukoopia luuakse: Quanta Plus loob varukoopiad teatud ajavahemiku tagant, nii et näiteks voolukatkestuse või krahhi korral saab dokumendi varukoopia põhjal taastada. See ei ole sama, mis varukoopia loomine faili salvestamisel. Selle võimalusega luuakse varukoopia isegi veel salvestamata dokumentidest.
Käivitamisvalikud: enesestmõistetavad valikud selle kohta, mis toimub rakenduse käivitamise ajal.
Siin saab määrata Quanta Plusi kasutajaliidese välimust.
Eelvaatlus ja dokumentatsioon võivad olla näha redaktorialas või omaette tööriistavaates, millisel juhul saab korraga näha nii dokumentatsiooni/eelvaatlust kui ka lähteteksti.
Samuti on võimalik seadistada tööriistavaadete ja dokumendikaartide välimust.
Võimalus Järgmisel käivitamisel lähtestatakse aknapaigutus vaikeväärtustele on kasuks juhul, kui oled kasutajaliidese MDI-režiimi muutes ning tööriistavaateid dokkides ja lahti haakides täiesti segi pööranud. See on sama, mis käsureavõti --resetlayout.
Siin saab määrata ka failipuude käitumist.
Sektsioonis Hoiatused saab sisse või välja lülitada hoiatuste näitamise. Sisselülitamist võib vaja minna näiteks siis, kui oled teadete näitamise keelanud teatekastides valikuga Rohkem ei näidata.
Siin saab muuta VPL-i käitumist. Nii on võimalik lasta skriptide asemel näidata ikooni, samuti saab seadistada jagatud režiimi kasutamisel VPL-i ja lähteteksti vaate sünkroniseerimist. Režiimide aktiveerimisest räägib lähemalt “Menüü ”
Siin saab täpsemalt häälestada parserit ja struktuuripuud, mis tähistab visuaalselt parseri sõlmi dokumendis.
Sektsioonis Klõps struktuuripuu elementidel saab muuta toiminguid, mida võetakse ette hiirenuupudega struktuuripuus klõpsates.
Sektsioonis Struktuuripuu välimus saab määrata, milliseid sõlmi puus näidatakse, kui sageli puud redigeerimise ajal uuendatakse ja millise tasemeni tuleks uuendamisel struktuuripuu automaatselt avada. Tühjad sõlmed on tühimärkidega tekstisõlmed, tühjad grupid aga sellised grupid, millele aktiivses dokumendis ei leidu ühtki elementi.
Siin saab määrata lühendeid ehk omamoodi malle, mis asendatakse redigeerimise ajal pikema tekstiga. Lühendid on korraldatud gruppidesse, iga grupp kehtib enam kui ühe DTEP jaoks. See tähendab, et sul võib siin olla grupp, mis kehtib PHP jaoks, kus lühendimall "ifclause" tähendab midagi muud kui grupis, mis kehtib JavaScripti jaoks.
Kasutaja määratud toimingute loomist ja muutmist kirjeldab “Kasutaja määratud toimingud”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Siin saab hallata pluginaid. Pluginad on KPart-rakendused, mille on kirjutanud keegi muu ja mida saavad ära kasutada kõik KPart-teadlikud rakendused, millest tuntuim on kahtlemata Konqueror. Plugina loomisel tuleb määrata:
Nimi: kasutajale nähtav nimi
Väljundiaken: pluginad võivad näha olla kaardina redaktorialal või omaette tööriistavaates all
Asukoht: plugina asukoht, kui see ei ole standardne (näiteks like $).KDEDIR/lib
Failinimi: plugina libtool-faili suhteline asukoht ja nimi (näiteks kde3/libcervisiapart.la)
Input: plugin saab siinmääratud info enda käivitumisel, nii et see avab praeguse faili, praeguse faili kataloogi (Praeguse faili asukoht) või projekti kataloogi.
Lugemisõigusega komponent: märgi, kui plugin keeldub laadimast. Lugemisõigusega KParts keeldub tavaliselt laadimast, kui see ei ole märgitud.
Plugina kontrollimine: märkimisel kontrollib Quanta Plus, kas sisestatud info on korrektne või mitte. Eemalda märge, kui plugin ei ole veel kättesaadav ja sa soovid selle alles hiljem paigaldada - nii saad dialoogi rahulikult sulgeda.
Pluginate kasutamisest kõnelevad “Menüü ” ja “Pluginate kasutamine”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See peatükk kirjeldab Quanta Plusi muid omadusi.
Quanta Plus 3.2 pakub palju uusi XML töövahendeid ja nendega kaasas käivaid võimalusi. Need tööriistad on oma Quanta Plusi integreerituse poolest unikaalsed. Kõik nad tarvitavad kasutajaliidesena Kommanderit ning taustaliidese rollis on libxml2 ja libxslt. Selline kombinatsioon muudab nad kiireks, tõhusaks, tootlikuks ja täisväärtuslikuks tööriistade komplektiks.
Quanta Plus toetab KDE kaht peamist dokumentatsioonivahendit: meinproc ja checkXML.
Kõik, kes on töötanud KDE dokumentatsiooni kallal, teavad, mis on meinproc ja kui suurepärane asi see on. Ja nüüd pakume me sedasama väga korraliku graafilise liidese näol! Enam ei pea sa shellis vaeva nägema, võid lihtsalt klõpsata ikoonile ja asi ants!
See rakendus eeldab, et fail index.docbook on kataloogis olemas. Kui index.docbook asub aktiivses töökataloogis, jäta märgituks aktiivne töökataloog. Kui mitte, siis eemalda märge kastist aktiivne töökataloogja määra väljal muu kataloog kataloog, kus fail tegelikult asub.
Väljundfailid salvestatakse allikfailidega samasse kataloogi. Kõik HTML-failid eemaldatakse iga kord, kui meinproc tööle pannakse.
Taas tuleb öelda, et kõik, kes on KDE dokumentatsiooniga vaeva näinud, teavad, kui kasulik abivahend see on. Ning taas tuleb öelda ka seda, et Quanta Plus pakub seegi kord välja suurepärase graafilise kasutajaliidese.
Kui parajasti avatud fail ongi index.docbook, jäta märgituks aktiivne töökataloog. Kui mitte, eemalda märge kastist aktiivne töökataloog ja määra kataloog, kus tegelikult asub index.docbook.
Kui tekib mingi väljund, on sinu fail vigane. Palun paranda teatatud vead ja proovi uuesti.
Quanta Plusil on suurepärane XML-i kontrollimise tööriist, mis tarvitab taustaprogrammina xmllint.
Kui kontrollitav fail on Quanta Plus aknas parajasti aktiivne, jäta lihtsalt märgituks aktiivne fail. Kui mitte, eemalda märge kastist aktiivne fail ja vali kontrollitav fail.
Kui soovid teada ainult seda, kas fail on korrektne, märgi kast Ainult korrektsuse kontroll.
Kui kasutad DTD-d ja see on määratud XML-failis, vali DTD (seesmine) (see on ka vaikevalik), vastasel juhul DTD (väline), mille korral tuleb definitsiooni URI valijaga anda ka DTD asukoht. Ka W3C® XML ja RelaxNG skeemi suhtes kontrollimisel tuleb asukoht definitsiooni URI valijaga väliselt määrata.
Jah, tõesti, Quanta Plusil on ka XSL-i töötlemise vahend! See kasutab taustaprogrammina programmi xsltproc, mida pakub libxml2.
Kui töödeldav fail on Quanta Plus aknas parajasti aktiivne, jäta lihtsalt märgituks aktiivne fail. Kui mitte, eemalda märge kastist aktiivne fail ja vali töödeldav fail.
Vali XSL-fail, mida soovid kasutada.
Nimi, mida tulemusfail peaks kandma. Väljundfail salvestatakse vaikimisi sinu kodukataloogi.
See rakendus ei ole eriti paindlik. Vabandame ja püüame järgmine kord paremini teha...
Quanta Plus võib laadida KPart-pluginaid. KPart on veel üks KDE võimsaid omadusi, suhteliselt väike ja korduskasutatav, mis lubab KDE arendajatel kerge vaevaga kasutada ära teiste programmeerijate panust. Üheks selliseks näiteks on ka Quanta Plus. Quanta Plusi redaktor kasutab ära Kate KParti. Kate KPartil oli juba enamik funktsioone, mida Quanta Plus vajas, näiteks süntaksi esiletõst. Selle põimimine Quanta Plusi võimaldas Quanta Plusi arendajatel keskenduda sellele, mida Quanta Plus ennekõike peab tegema, mitte aga pead murdma arvukate probleemidega, mida uue redaktori väljatöötamine vältimatult oleks kaasa toonud.
Pluginatel, mida Quanta Plus laeb, ei pruugi olla midagi pistmist Quanta Plusi endaga, mis muudabki kogu pluginate süsteemi äärmiselt võimsaks: sa võid kasutada arvukaid lisavõimalusi, ootamata, kuni keegi Quanta Plusi meeskonnast selle kuidagimoodi välja töötab. Pluginaid saab laadida graafilise kasutajaliidese (GUI) paljudes osades, aga sellest juba pikemalt allpool.
Plugina või KParti paigaldamiseks kasuta menüükäsku ->. See avab järgmise dialoogi:
Plugina redigeerimise dialoog.
Selles dialoogis saab hallata kõiki teadaolevaid pluginaid ja lisada ka uusi. Kirjeldame nüüd kõiki GUI elemente:
Siin saab määrata pluginate otsingutee ehk asukoha. Kui lisada plugin ilma asukohata, otsib Quanta Plus pluginat just neist kohtadest.
Avab dialoogi, mis võimaldab lisada uue plugina.
Võimaldab muuta valitud plugina seadistusi.
Eemaldab valitud plugina.
Värskendab dialoogi sisu.
Pluginatest räägib põhjalikumalt “Pluginate seadistamine”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Sageli töötab projekti kallal mitu inimest, kelle vahel valitsevad teatud hierarhilised suhted. Quanta Plus toetab meeskondade kasutamist ning neid saab mitmeti seadistada dialoogis -> (Shift+F7).
Meeskonnaliikme redigeerimise dialoog
Väljad Nimi ja E-posti aadress peaks olema enesestmõistetavad. Hüüdnimi tuvastab üheselt konkreetse kasutaja.
Väli Roll määratleb meeskonnaliikme positsiooni projekti raames ja võib olla üks järgnevatest:
Meeskonna juht
Alamprojekti juht
Ülesande juht
Lihtliige
Ülesanne kirjeldab meeskonna liikmele omistatud ülesannet.
Alamprojekt: siin saab valida alamprojekti. Neid saab seadistada ja luua klõpsuga nupule Muuda alamprojekte. Igal alamprojektil on kasutajatele nähtav nimi ja asukoht, kusjuures viimane on määratud suhtelise asukohana projektipuus paikneva kataloogi suhtes. See tähendab, et alamprojekt on peaprojekti kuuluv kataloog. Näiteks võib peaprojekt olla sinu firma veebilehekülg ja alamprojekt intraneti veebilehekülg, mis asub projekti kataloogis intranet.
Ühel liikmel võib projektis olla ka mitu rolli, näiteks meeskonna juht ja alamprojekti juht.
Kasutajal tuleb meeskonnaliikmete nimekirjast valida, kes on ta ise. Selleks vali nimekirjast õige liige ja klõpsa nupule Määra iseendaks. Valitud liige (sinu identiteet) on näha teksti Mina olen: järel.
Hüüdnimed ja iseenda määratlemine on olulised suhtlemisel ja annotatsiooni puhul. Viimastest räägib lähemalt “Annotatsioonid”.
Lisaks võimalusele hoida liikmetel silm peal on meeskonna liikmete kirjapanemisel veel üks pluss: sul on võimalik määrata sündmused, millega informeeritakse meeskondade juhte teatud toimingute korral. Täpsemalt räägib sellest “Sündmuste toimingud”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Sündmuste toimingud on toimingud, mis käivitatakse siis, kui projektis midagi juhtub. Näiteks võib olla logimine projekti avamisel ja sulgemisel, mis lubab hiljem hinnata, kui palju keegi selle kallal vaeva on näinud, või e-kirja saatmine faili salvestamise või faili lisamine CVS-i skripti abil pärast seda, kui fail on lisatud projekti ja nii edasi ja nii edasi.
Dialoogi -> (Shift+F7) kaardil Sündmuste seadistamine saab luua, muuta ja kustutada sündmuste toiminguid.
Sündmuse redigeerimise dialoog
Dialoogi kirjed on järgmised:
toiming käivitatakse, kui toimub nimekirjast valitud sündmus. Sündmuste nimed peaksid olema enesestmõistetavad.
käivitatava toimingu tüüp. Võimalikud valikud on
toiming, mis ei ole kasutaja määratud skriptitoiming. Kasutaja toimingutest räägib “Kasutaja määratud toimingud”
Toimingu nimi määrab toimingu, mis käivitatakse sündmuse toimumisel.
toimingu korral saadetakse e-kiri isikule, kes on valitud väljal Saaja. Selleks võib olla meeskonna või alamprojekti juht. Juhtide defineerimisest räägib lähemalt “Meeskonnatöö”.
sündmus logitakse faili. Selle toimingu argumendid on:
täieliku asukohaga failinimi
Kui palju infot logi sisaldab
Kas luua/kirjutada üle olemasolev fail või lisada sellele uus logitav sündmus.
kasutaja määratud skriptitoiming. Kasutaja toimingutest kõneleb “Kasutaja määratud toimingud”.
Toimingu nimi määrab toimingu, mis käivitatakse sündmuse toimumisel.
Muud kirjed sõltuvad sellest, mis on valitud väljal Toiming.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Annotatsioonid on dokumentides esinevad erilised kommentaarid. Tavalistest kommentaaridest erinevad need järgmiste asjade poolest:
infot kogub Quanta ning seda näitab tööriistavaade Annotatsioonid.
informatsiooni saab läkitada meeskonna liikmele
Annotatsiooni lisamine on väga lihtne: vali redaktori kontekstimenüüst käsk Annoteeri või lisa kommentaarialasse võtmesõna @annotation ning selle järele annotatsiooni tekst.
Näide 6.1. Annotatsiooni näide XML-is
<!-- @annotation Võimalik, et see kood on vigane. -->
<!-- @annotation Mitmerealine annotatsioon. -->
Näide 6.2. Annotatsiooni näide PHP-s
/* @annotation PHP ala annoteerimisel tuleb kasutada PHP kommentaare */
Annotatsioone saab adresseerida meeskonna konkreetsele liikmele. Süntaks on sellisel juhul @annotation(hüüdnimi) või @annotation(roll), where hüüdnimi on meeskonna liikme hüüdnimi, roll aga roll projektis, mille korral on võimalikud järgmised võimalused:
meeskonna juht
ülesande juht
alamprojekti juht
Näide 6.3. Märkus meeskonna liikmele hüüdnimega eric
<-- @annotation(eric) Eric, palun vaata seda ise. Andras -->
Näide 6.4. Meeskonna juhi teavitamine
<-- @annotation(meeskonna juht) See on meeskonnale väga tähtis -->
Näide 6.5. PHP alamprojekti juhi teavitamine
// @annotation(alamprojekti juht:PHP) Mida sa sellest arvad?
Hüüdnimede ja rollinimetuste puhul ei tehta suur- ja väiketähtedel vahet, kuid tühikud sulgude ning : ümber muudavad annotatsiooni vigaseks.
Lähemalt räägib meeskonna liikmetest, nende rollidest ja hüüdnimedest “Meeskonnatöö”.
Projektis leiduvaid annotatsioone saab uurida vaates Annotatsioonid. See koosneb kolmest kaardist:
Aktiivses failis leiduvad annotatsioonid.
Projekti just sulle adresseeritud annotatsioonid. Kirjed on rühmitatud failiti.
Kõigis projekti failides leiduvad annotatsioonid, mis on rühmitatud failiti.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Quanta Plus 3.3 on siluri käsitlemise uuesti tagasi toonud. Nüüdseks iganenud PHP (3) sisseehitatud siluri ning dbg siluri toetusest loobuti. Selle asemel töötati välja üldine silumispluginate süsteem, mis võimaldab teostada erinevaid (silumis)pluginaid.
Hetkel on kasutamiseks valmis ainult üks plugin, mis lisab Quanta Plusile Gubed PHP Debuggeri kasutamise toe.
Siluri kasutamiseks oma projektis ava projekti seadistused ja vali sobiv silumisplugin. Siluri spetsiifiliste seadistuste muutmiseks klõpsa nuppu 'Eelistused', mille leiad silumisplugina valiku juurest.
Kui projektis on silur aktiveeritud, lisandub Quanta Plusi kasutajaliidesesse mõningaid uusi elemente:
Ilmub uus menüü, mis võimaldab kasutada enamikku siluri võimalusi.
Tööriistariba kõige enam kasutatavate silumiskäskudega.
Vaade, kus näidatakse jälgitavate muutujate sisu. Ilmub vaikimisi dokituna vasakule.
Vaade, kus näidatakse kõiki katkestuspunkte, ridu ja tingimusi. Ilmub vaikimisi dokituna alla.
Tööriistavaade, kus näidatakse siluri väljundit (HTML-ina). Ilmub vaikimisi dokituna alla.
Sõltuvalt konkreetsest silumispluginast võivad olla näha kõik või vähemalt järgnevalt kirjeldatud funktsioone.
Selle toiminguga saab vajadusel luua ühenduse siluriga või anda pluginale korraldus asuda jälgima silumist. Toiming käivitatakse vaikimisi, kui avada silurit kasutav projekt, nii et enamasti ei ole vaja selle pärast muret tunda.
Vastupidine menüükäsule ->->. Sulgeb ühenduse siluriga või peatab selle tegevuse jälgimise.
Saadab HTTP päringu serverile sooviga algatada silumine. See toiming võrdub brauseri kasutamisega aktiivse dokumendi vaatamisesk. Päringu väljundit näidatakse silumisväljundi vaates.
Peatab skripti töö.
Annab silurile korralduse käivitada skript ja edastada töö käigus infot jälgitavate muutujate ja parajasti teostatava rea rea kohta. Kui see käsk anda skripti pausi ajal, täitmist lihtsalt jätkatakse. Kui see antakse enne silumise alustamist, alustab skript tegevust niipea, kui silumine on käivitatud.
Annab silurile korralduse käivitada skript, aga mitte edastada töö käigus infot jälgitavate muutujate ja parajasti teostatava rea rea kohta. Kui see käsk anda skripti pausi ajal, täitmist lihtsalt jätkatakse. Kui see antakse enne silumise alustamist, alustab skript tegevust niipea, kui silumine on käivitatud.
Annab silurile korralduse täita skripti järgmine instruktsioon ilma funktsioonidesse või kaasamistesse sisse astumata.
Annab silurile korralduse täita skripti järgmine instruktsioon ja võimaluse korral astuda sisse funktsioonidesse ja kaasamistesse.
Annab silurile korralduse jätkata täitmist kuni aktiivsest funktsioonist väljumiseni.
Annab silurile korralduse jätta järgmise instruktsioon vahele ja minna järgmise juurde, nagu aktiivset ei eksisteerikski.
Annab silurile korralduse tappa parajasti töötav skript
Avab dialoogi, kus saab määrata tingimuslikud katkestuspunktid.
Lülitab rea katkestuspunkti kursorireal aktiivsele reale
Eemaldab kõik katkestuspunktid.
Avab dialoogi, kus saab määrata muutuja või avaldise, mida soovid jälgida. Jälgitav väärtus on näha muutujate vaates.
Avab dialoogi, kus saab määrata muutuja ja selle uue väärtuse.
KXsldbg, nagu ka käsiraamatu selle osa autor on Keith Isdale. KXsldbg on KDE kasutajaliides ja KPart programmile xsldbg, mille leiab koos teiste Keithi loodud asjadega aadressilt http://xsldbg.sf.net.
KXsldbg käivitamiseks vali menüükäsk ->.
Täpsemat infot KXsldbg kasutamise kohta vaata palun juba selle käsiraamatust.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See peatükk kirjeldab Quanta Plusi kohandamist just sinu vajadustele, samuti seda, kuidas just sina saad aidata muuta Quanta Plusi veel paremaks.
Quanta Plus kasutab dokumenditüübi redigeerimispakette (DTEP) märke- ja skriptikeelte ning CSS toetuse pakkumiseks. Need paketid lubavad Quanta Plusil näiteks pakkuda selliseid võimalusi, nagu automaatne lõpetamine ja sõlmepuud. Pakettide lihtsus ja paindlikkus muudab Quanta Plusi kiireks ja arendajasõbralikuks arenduskeskkonnaks (IDE) veebiarendajatele. Kõik see on teinud Quanta Plusist hõlpsasti kasutatava ja tootlikkust suurendava keskkonna.
DTEP esineb kahel kujul: perekond 1 ehk märkekeeled ja perekond 2 ehk skriptikeeled ja CSS. DTEP koosneb kahest osast: siltide kataloog ja tööriistaribad. Sildikataloogidesse kuulub kaht tüüpi faile: description.rc ja TagXML-failid, mille laiendiks on .tag. Tööriistaribad on käepärased ikoonidega nupukogumid (redigeerimisakna kohal), mis suudavad teksti või midagi muud dokumenti kiiremini lisada kui kasutaja käsitsi klaviatuuril sisestada.
DTEP on võimalik luua käsitsi (lähemalt edaspidi), alla laadida või automaatselt luua olemasoleva DTD põhjal. Teisendamisest kõneleb lähemalt “DTD teisendamine DTEP-ks”.
Käesolev käsiraamat kirjeldab, kuidas luua TagXML-faile, faili description.rc ja tööriistaribasid ehk lühidalt: kuidas luua DTEP.
TagXML-failid (.tag) määravad nii sildile omased atribuudid kui ka omaduste dialoogi paigutuse ja sisu, mida Quanta Plus sildi kohta näitab. Fail description.rc sisaldab reegleid ja infot DTEP kohta. Tööriistaribad pakuvad hõlpsa võimaluse lisada dokumenti silte, ilma et peaks muretsema kirjavigade ja muu sellise pärast.
Sildikataloogid ongi lihtsalt kataloogid, koosnedes ainult failist description.rc ja TagXML-failidest. Sildikataloogidel on võimaluse korral märkekeele konkreetse versiooni nimi (näiteks html-4.01-strict).
Allolev tabel toob ära elemendid, mida TagXML määrab ja defineerib sõltumata sellest, kas need on nõutavad või mitte. Kui ka kõik ei ole nõutavad, on siiski soovitatav, et kasutaksid neist võimalikult paljusid, et teised kasutajad võiksid omandada kogemusi ja õppida nendega paremini töötama.
| Element | Vaikimisi kasutamine | Kasutamise näide |
|---|---|---|
| TAGS | nõutav | alati |
| tag | nõutav | alati |
| label | mittekohustuslik | nõutav omaduste dialoogi loomiseks |
| attr | mittekohustuslik | nõutav atribuudi defineerimiseks |
| tooltip | mittekohustuslik | nõutav omaduste dialoogis kohtspikrite näitamiseks |
| whatsthis | mittekohustuslik | nõutav omaduste dialoogis abivõimaluse “Mis see on?” näitamiseks |
| list | mittekohustuslik | nõutav, kui atribuut on tüübiga “nimekiri” |
| item | mittekohustuslik | nõutav, kui kasutatakse <list > |
| textlocation | mittekohustuslik | alati |
| location | mittekohustuslik | nõutav pealdise kasutamisel |
| text | mittekohustuslik | nõutav pealdise kasutamisel |
| children | mittekohustuslik | siltide nimekiri, mis võivad esineda defineeritava sildi sees |
| child | nõutav | alamsildi kirje |
| stoppingtags | mittekohustuslik | siltide nimekiri, mis defineerivad muu sildi lõpetamise |
| stoppingtag | nõutav | stoppingtags kirje |
Nüüd hakkame üksikasjalikult kirjeldama iga elementi alates sellest, kus neid saab kasutada, kuni selleni, mis võib nende sees peituda.
See on TagXML-dokumendi juurelement, mis võib dokumendis esineda ainult üks kord. See võib sisaldada mitme sildi definitsiooni. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| PUUDUB | tag |
Sildi kui sellise defineerija. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| TAGS | label, attr, stoppingtags |
| Atribuut | Tüüp | Väärtused | Vaikimisi | Kasutamine | Kirjeldus |
|---|---|---|---|---|---|
| name | string | nõutav | Määrab defineeritava sildi nime. | ||
| single | tõeväärtus | mittekohustuslik | Määrab, kas silt nõuab lõpetavat silti </(sildinimi) > või mitte. | ||
| type | string | xmltag | mittekohustuslik | Määrab defineeritava sildi tüübi. | |
| xmltag | Sildi tüüp on XML-põhine (ainult perekond 1). | ||||
| entity | See silt kirjeldab olemit (ainult perekond 1). | ||||
| property | Sildi tüüp on seotud CSSiga (ainult perekond 2). | ||||
| function | Sildi tüüp on skriptifunktsioon. Kasutamisel muutuvad <attr > funktsiooni argumentideks (ainult perekond 2). | ||||
| class | Sildi tüüp on skriptiklass (ainult perekond 2). | ||||
| method | Sildi tüüp on klassimeetod (ainult perekond 2). | ||||
| returnType | string | void | mittekohustuslik | Määrab defineeritava sildi tüübi tagastamise (ainult perekond 2). | |
| void | Sildi tüüp tagastab void. | ||||
| int | Sildi tüüp tagastab täisarvu (int). | ||||
| float | Sildi tüüp tagastab murdarvu (float). | ||||
| long | Sildi tüüp tagastab long. | ||||
| string | Sildi tüüp tagastab stringi (string). | ||||
| version | string | mittekohustuslik | Määratleb keele versiooni, milles silt kehtib | ||
| extends | string | mittekohustuslik | Kehtib ainult siis, kui sildi tüüp on "klass". Antud klassi baasklassi nimi. (Ainult perekond 2.) | ||
| class | string | mittekohustuslik | Kehtib ainult siis, kui tüüp on "meetod". Määrab klassi nime, kuhu antud meetod kuulub. (Ainult perekond 2.) | ||
| common | tõeväärtus | mittekohustuslik | kui on "jah", määrab see silt üldise atribuudigrupi ning selle sildi sees esinevaid atribuute saab siduda suvalise muu sildiga (ainult perekond 1). | ||
| comment | string | mittekohustuslik | kommentaaristring on näha sildi nime juures lõpetamise kastis |
Seab dialoogile pealdise. Teksti määrab silt <tekst >. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| tag | text, location |
Määrab sildi atribuudi. See element esineb üks kord iga atribuudi kohta, määrates atribuudi nime ja tüübi. Samuti sisaldab see lisasilte, mis määravad, kuidas atribuuti esitatakse jne. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| tag | location, list, tooltip, whatsthis, textlocation |
| Atribuut | Tüüp | Väärtused | Vaikimisi | Kasutamine | Kirjeldus |
|---|---|---|---|---|---|
| name | string | nõutav | Määrab defineeritava atribuudi nime. | ||
| type | string | input | nõutav | Määrat defineeritava atribuudi tüübi. | |
| input | See väli toetab mis tahes tekstikirjeid (tekstiväli). | ||||
| check | Väljal on tõeväärtus (märkekast). | ||||
| color | Välja väärtus on värv. | ||||
| url | Välja väärtus on URL (kohalik fail, millele viidatakse). | ||||
| list | Välja väärtus on element määratud nimekirjast. | ||||
| status | string | mittekohustuslik | nõutav | Määrab, kas argument on nõutav või mitte (ainult perekond 2). | |
| mittekohustuslik | Argument on mittekohustuslik. | ||||
| nõutav | Argument on nõutav. | ||||
| implied | Argumenti eeldatakse. | ||||
| source | string | mittekohustuslik | Määrab allika, mida kasutatakse atribuudikirje täitmisel sildi redigeerimise dialoogis ja atribuudipuus | ||
| selection | Valitud teksti kasutatakse allikana | ||||
| dcop | DCOP-meetodi tulemust kasutatakse allikana | ||||
| interface | string | mittekohustuslik | Nõutav on source="dcop". Allikandmete hankimiseks kasutatakse Quanta Plusis DCOP-liidest. | ||
| method | string | mittekohustuslik | Nõutav on source="dcop" ja liidese nimi. Allikandmete hankimiseks kasutatakse Quanta Plusis DCOP-liidest. | ||
| arguments | string | mittekohustuslik | Nõutav on source="dcop", liidese ja meetodi nimi. Argumendid edastatakse meetodile. See võib olla tühi või "%tagname%", mis tähendab aktiivse sildi nime. |
Defineerib dialoogi välja kohtspikri. See on puhta teksti tüüpi element.
Praegu on toetatud ainult puhas tekst (märkekeelt kasutada ei saa).
| Eellane/eellased | Järglased |
|---|---|
| attr | PUUDUB |
Defineerib dialoogi välja abivõimaluse 'Mis see on?' See on puhta teksti tüüpi element.
Praegu on toetatud ainult puhas tekst (märkekeelt kasutada ei saa).
| Eellane/eellased | Järglased |
|---|---|
| attr | PUUDUB |
Konteinersilt, mis koondab nimekirja elemendid. See tohib esineda ainult üks kord atribuudi kirjelduse kohta. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| attr | item |
Defineerib nimekirja elemendi. See on puhta teksti tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| list | PUUDUB |
Määrab sildi atribuudi teksti asukoha dialoogis. See silt võib esineda ainult üks kord atribuudi kohta dialoogis (st. üks kord iga sildi <attr > kohta). See element on tühi.
| Eellane/eellased | Järglased |
|---|---|
| attr | PUUDUB |
| Atribuut | Tüüp | Kasutamine | Kirjeldus |
|---|---|---|---|
| row | Mittenegatiivne täisarv | nõutav | Määrab dialoogis välja või pealdise rea. |
| col | Mittenegatiivne täisarv | nõutav | Määrab dialoogis välja või pealdise veeru. |
| rowspan | Mittenegatiivne täisarv | mittekohustuslik | Määrab ridade arvu, millele väli peab laienema. |
| colspan | Mittenegatiivne täisarv | mittekohustuslik | Määrab veergude arvu, millele väli peab laienema. |
Määrab välja asukoha ja suuruse dialoogis. See väli tohib esinda üks kord iga dialoogi välja kohta (st. kord iga sildi <attr > ja <label > kohta). See element on tühi.
| Eellane/eellased | Järglased |
|---|---|
| label, attr | PUUDUB |
| Atribuut | Tüüp | Kasutamine | Kirjeldus |
|---|---|---|---|
| row | Mittenegatiivne täisarv | nõutav | Määrab dialoogis välja või pealdise rea. |
| col | Mittenegatiivne täisarv | nõutav | Määrab dialoogis välja või pealdise veeru. |
| rowspan | Mittenegatiivne täisarv | mittekohustuslik | Määrab ridade arvu, millele väli peab laienema. |
| colspan | Mittenegatiivne täisarv | mittekohustuslik | Määrab veergude arvu, millele väli peab laienema. |
Defineerib pealdise või märkekasti teksti. See on puhta teksti tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| label, attr | PUUDUB |
Defineerib elementide nimekirja, mis võivad esineda määratud sildi raames. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| tag | child |
Defineerib järglassildi. See element on tühi.
| Eellane/eellased | Järglased |
|---|---|
| children | PUUDUB |
| Atribuut | Tüüp | Väärtused | Kasutamine | Kirjeldus |
|---|---|---|---|---|
| name | string | nõutav | Määrab sildi, mis võib esineda teatud sildi raames. | |
| kasutusala | string | mittekohustuslik | Määrab seose eellasega. | |
| nõutav | Eellasel peab olema vähemalt üks selle nimega järglane. |
Defineerbi elementide nimekirja, mis sunnivad peale sildi lõpetamise. See on puhta elemendi tüüpi element.
| Eellane/eellased | Järglased |
|---|---|
| tag | stoppingtag |
Kõik TagXML-failid peavad algama XML deklaratsiooniga <?xml version="1.0" encoding="UTF-8"?> ning nad peavad olemas korralikult pesastatud ja suletud.
Tühikud segavat mõju ei avalda, kuid silma peaks peal pidama märkidel & ja <. On tõenäoline, et need asendatakse vastavalt märkidega & ja < sellistes elementides nagu <tooltip >, <whatsthis >, and <text >. See ei põhjusta vahest küll krahhi, kuid hulk sinu tööd ja vaeva võib küll kaduma minna.
TagXML-failide kontrollimiseks klõpsa “tööriistade” hüpikdialoogil Quanta Plusi ülaosas ja vali “TagXML kontrollimine”. Ilmub dialoog, kus tuleb järgida väga lihtsaid ja arusaadavaid juhiseid.
Seda võimalust ei saa veel kasutada. Praegu on võimalik kontrollida ainult juhul, kui TagXML-fail on Quanta Plusis avatud.
Järgnev kujutab endast korrektset TagXML-faili (perekond 1). See kirjeldab, muide, W3C® XML skeemi elementi <schema >. Selle TagXML-faili nimi peaks olema schema.tag. Lihtne, eks ju?
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE TAGS> <TAGS> <tag name="schema"> <label> <text >id</text> <location col="0" row="0"/> </label> <attr name="id" type="input"> <tooltip >Elemendi unikaalne ID.</tooltip> <whatsthis >Elemendi unikaalne ID.</whatsthis> <location col="1" row="0"/> </attr> <label> <text >version</text> <location col="0" row="1"/> </label> <attr name="version" type="input"> <tooltip >Skeemi versioon.</tooltip> <whatsthis >Skeemi versioon.</whatsthis> <location col="1" row="1"/> </attr> <label> <text >targetNamespace</text> <location col="0" row="2"/> </label> <attr name="targetNamespace" type="input"> <tooltip >Selle skeemi nimeruumi URI viide.</tooltip> <whatsthis >Selle skeemi nimeruumi URI viide.</whatsthis> <location col="1" row="2"/> </attr> <label> <text >xmlns</text> <location col="0" row="3"/> </label> <attr name="xmlns" type="input"> <tooltip >Ühe või enama nimeruumi URI viide selle skeemi jaoks. Kui prefiksit ei kasutata, on võimalik selle nimeruumi komponentide mittekvalifitseeritud kasutamine.</tooltip> <whatsthis >Ühe või enama nimeruumi URI viide selle skeemi jaoks. Kui prefiksit ei kasutata, on võimalik selle nimeruumi komponentide mittekvalifitseeritud kasutamine.</whatsthis> <location col="1" row="3"/> </attr> <label> <text >attributeFormDefault</text> <location col="0" row="4"/> </label> <attr name="attributeFormDefault" type="list"> <items> <item >qualified</item> <item >unqualified</item> </items> <tooltip >Selle skeemi kõigi atribuutide vaikimisi vorm.</tooltip> <whatsthis >Selle skeemi kõigi atribuutide vaikimisi vorm.</whatsthis> <location col="1" row="4"/> </attr> <label> <text >elementFormDefault</text> <location col="0" row="5"/> </label> <attr name="elementFormDefault" type="list"> <items> <item >qualified</item> <item >unqualified</item> </items> <tooltip >Selle skeemi kõigi elementide vaikimisi vorm.</tooltip> <whatsthis >Selle skeemi kõigi elementide vaikimisi vorm.</whatsthis> <location col="1" row="5"/> </attr> <label> <text >blockDefault</text> <location col="0" row="6"/> </label> <attr name="blockDefault" type="input"> <location col="1" row="6"/> </attr> <label> <text >finalDefault</text> <location col="0" row="7"/> </label> <attr name="finalDefault" type="input"> <location col="1" row="7"/> </attr> </tag> </TAGS>
Järgnev kujutab endast korrektset TagXML-faili (perekond 2). Juhtumisi on tegemist PHP ülekoormuse funktsiooniga. Selle TagXML-faili nimi peaks olema overload.tag.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE tags> <tags> <tag name="overload" type="function" returnType="void"> <attr name="class_name" type="string" status="optional"/> </tag> </tags>
Ka description.rc on üsna lihtne ning sellele on isegi oma redaktor, mille saab avada menüükäsuga ->. See võimaldab muuta nimekirjast valitud DTEP faili description.rc. Uue DTEP faili description.rc muutmiseks tuleb luua lihtne description.rc järgmiste kirjetega:
[General] Version = Use 1 for Quanta Plus version <=3.1.2 and 2 for any version greater. Name = DTD definition string. (-//W3C®//DTD HTML 4.01 Transitional//EN) NickName = The beautified name of the DTD. (HTML 4.01 Transitional). If not defined, Name is used as NickName.
Kui oled selle loonud, paiguta see sildifailide kõrvale, lae uus DTEP menüükäsuga -> ning kui see on laetud, saad hakata DTEP seadistusi muutma. Uuri redaktoridialoogis kirjete kohtsipkreid ja "Mis see on?" abitekste, et saada aru, milleks iga kirje on mõeldud. Teine võimalus on muidugi lugeda lähtetekstiga kaasasolevat faili quanta/data/dtep/dtd-description.txt, milles kirjeldatakse vormingut.
Toiminguid esineb igas rakenduses ja pole mingit kahtlust, et sa oled nendega nii või teisiti kokku puutunud. Klõps tööriistariba nupule, menüükirje valimine või kiirklahvi kasutamine käivitab tavaliselt mingi toimingu. Quanta Plus on toimingud viinud uuele tasemele. Rakenduse looja poolt juba lähtekoodi sisse kirjutatud toimingute asemel saavad nüüd ka tavalised kasutajad toiminguid luua ja muuta ning sel moel Quanta Plusile uusi võimalusi lisada. Need ongi kasutaja määratud toimingud ning õigupoolest on ka paljud Quanta Plusi standardsed toimingud kasutaja määratud (ja muudetavad) toimingud.
Kasutaja määratud toiminguid on kolme tüüpi:
Toimingut saab luua menüükäsuga ->. Klõpsa nupule , mille järel avaneb selline dialoog:
Toimingu kasutajale nähtav nimi.
Toimingule omistatav ikoon. Parajasti kehtiva ikooni muutmiseks klõpsa sellele.
Toimingu lühikirjeldus.
Toimingule omistatav kiirklahv. Klõpsa kiirklahvi omistamiseks kirjele Kohandatud või selle juures asuvale nupule. Klõpsa kirjele Puudub, kui soovid parajasti kehtiva kiirklahvi eemaldada.
Kasutaja määratud tööriistaribad, kus antud toiming on näha. Vaata “Tööriistaribade loomine”.
Erinevat tüüpi toimingute spetsiifilised seadistused. Vaata allpool.
Need on kasulikud XML-siltide lisamiseks, aga mõistagi saab neid ka muuks tarvitada.
Sildi nimi.
Sisselülitamisel lisatakse see tekst toimingu käivitamisel lõpetava sildina. Kui enne toimingu käivitamist on dokumendis valitud ala, lisatakse <tag> valitud ala ette ja </tag> selle järele.
Sisselülitamisel näidatakse juhul, kui antud sildile on olemas tagXML-fail, enne sildi lisamist dokumenti sildi muutmise dialoogi, kus saab vajaduse korral sildi atribuute täpselt defineerida.
Kõigepealt tuleb anda skripti nimi koos interpretaatoriga. Näide: sh /home/minukodu/minuskript.sh.
Kuigi kasutada võib ka absoluutseid asukohti, on soovitatav pruukida käsureal muutujat %scriptdir, näiteks sh %scriptdir/minuskript.sh. Sel juhul üritab Quanta Plus leida sinu skripti järgmistest kohtadest:
globaalne skriptikataloog: $KDEDIR/share/apps/quanta/scripts
kohalik skriptikataloog: $KDEHOME/share/apps/quanta/scripts
sinu otsingutee: $PATH
%f asendatakse aktiivse dokumendi URL-iga. Kohalike dokumentide korral kärbitakse dokumendist file:/.
%input asendatakse valitud sisendiga. Vaata allpool.
%projectbase asendatakse aktiivse projekti URL-iga. Kui projekti pole laetud, on tühi.
%pid asendatakse töötava Quanta Plusi protsessi PID-ga. Kui Quanta Plus töötab unikaalses režiimis, lisatakse PID-i numbri ette tekst "unique ". Kasulik, kui kasutab DCOP-i Quanta Plusi juhtimiseks välise skriptiga.
%userarguments on kasulik sündmuste korral. See kirje asendatakse sündmuse omadustega järgmises järjekorras:
Skripti unikaalne ID
Sündmuse nimi
Sündmuse parameetrid, tavaliselt aktiivse dokumendi failinimi või projektifaili asukoht.
Lisaks mainitud meetoditele võib skript saada standardsisendis sisendi ka Quanta Plusilt. Liitkastis Sisend saab valida, mida standardsisendisse saata. Võimalused on järgmised:
Puudub: skriptile ei saadeta midagi.
Aktiivne dokument: skriptile saadetakse kogu dokument.
Valitud tekst: skriptile saadetakse dokumendi valitud ala. Muutuja %input kasutamine ongi enamasti mõttekas ainult antud juhul.
Sarnaselt sisendile võib ära kasutada ka käivitatud rakenduse väljundi. Väljund võib olla kaht laadi:
tavaline väljund, mis saadetakse standardväljundisse;
veateated, mis saadetakse standardsesse veaväljundisse.
Puudub: rakenduse väljundit ignoreeritakse.
Lisatakse kursori asukohta: väljund lisatakse aktiivsesse dokumenti kursori asukohta.
Asendatakse valik: dokumendi valitud ala asendatakse väljundiga.
Asendatakse valik: dokumendi valitud ala asendatakse väljundiga.
Luuakse uus dokument: luuakse uus dokument, mis sisaldab kogu skripti väljundit.
Asendatakse käesolev dokument: kogu dokument asendatakse väljundiga.
Teateaken: väljundit näeb kaardil Teated.
Standardse veaväljundi korral (Viga) on valikud samasugused nagu tavalise väljundi puhul.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Järgnevas selgitame, kuidas luua DTEP jaoks tööriistaribasid. Tööriistaribad on graafilised elemendid, mis on omistatud toimingutele. Toimingud kujutavad Quanta Plusis alust peaaegu kõigile laiendustele, mida Quanta Plus praegu või tulevikus kasutab. Sama mehhanism, mis defineerib Quanta Plusis toiminguid, võimaldab automaatset lõpetamist ning sildidialooge. Toimingute puhul sisuliselt puuduvad piirangud. Näitena kasutame siinkohal meie veebilehtedel HTML tidy't.
Alustuseks tuleb luua kasutaja tööriistariba. Vali menüükäsk ->.
Kui märkekeeles on palju silte, on soovitatav jagada need loogilistesse gruppidesse. Igale grupile tuleb luua uus kasutaja tööriistariba. Antud juhul pole neid eriti palju, seepärast piirdume ühe tööriistaribaga ja anname sellele vastava märkekeele nime.
Kui kõik vajalikud tööriistaribad on loodud, tuleb neile lisada toimingud ja viimased seadistada. Selleks vali menüükäsk -> .
Selles aknas peaks kõik iseenda eest kõnelema. Klõpsa akna allosas asuvale nupule , mis avab redigeerimisrežiimi.
Täida kõik vajalikud väljad ja lisa silt vastavale tööriistaribale.
Nüüd tee sama muude toimingute ja siltidega ning kui sildil on atribuute ja sa kavatsed neid kasutada, märgi ära ka kast Käivitatakse dialoog "Sildi muutmine" (kui võimalik), et sinu käest iga kord vastava toimingu kasutamisel küsitaks.
Nüüd peaks sul olema midagi sellist.
Klõpsa nuppu ja näed, kuidas toiming lisatakse valitud tööriistaribale.
Nähh! See ikoon on veidi imelik. Isegi mina ise ei pruugi mäletada, et see käib selle toimingu kohta, mis siis veel teistest rääkida! Vahetame selle enne välja, kui häda käes.
Antud toimingut paremini kirjeldava ikooni loomiseks kasutame rakendust KIconEdit. Ava see käsuga menüüst -> (või kuidas iganes sinu distributsioon seda ei nimetaks).
KIconEdit kasutab vaikesuurusena 32x32 pikslit, kuid meie soovime suurust 22x22. Muutmiseks kasuta menüükäsku ->.
Pea meeles, et sa lood ikooni, mis ei aita mitte ainult sul endal meeles pidada, milline toiming mida teeb, vaid tuleb samamoodi kasuks ka teistele DTEP kasutajatele.
Et silt, millele ma ikooni looma asusin, kannab nimetust “start”, siis otsustasin luua “alustamismärgi”. Roheline värv (mida sageli tarvitatakse tähenduses “mine”, “alusta” või “jätka”) annab või vähemalt peaks andma kasutajale märku, et sellele toimingule klõpsates asetatakse dokumenti silt <start>.
Nii, ikoon on valmis tehtud ja käes aeg see salvestada.
Kui oled ikooni(d) valmis teinud, tuleb need toiminguga siduda. Selleks ava uuesti -> (Quanta Plusis mõistagi) ja vali toiming, mille jaoks ikooni lõid. Välja Tekst kõrval asub nupp. Vajuta sellele.
Vali Muud ikoonid ja seejärel klõpsa nupule .
Mine nüüd kataloogi, kuhu ikooni salvestasid, vali ikoon ja klõpsa nupule .
Klõpsa nupule ning jätka ikoonide seostamist muude siltidega või klõpsa , kui oled omadega valmis.
Oletame, et soovid lisada oma tööriistaribale mõned Quanta Plusi levinumad funktsioonid või arvad, et tööriistariba tuleks paremini organiseerida, näiteks see eraldajatega toimingute gruppidesse jagada. Ava selleks dialoog Tööriistaribade seadistamise dialoog (->). Kontrolli, et soovitud tööriistariba oleks valitud.
Mina valisin oma tööriistaribale eraldaja (vasaku veeru ülaosast). Kui oled valinud elemendi, mida soovid tööriistaribale lisada, klõpsa paremale osutava noolega nupule, mis lisabki elemendi sinu tööriistaribale.
Ma arvan ka, et mulle meeldiks kiiresti kasutada võimalust Eelvaatlus Konqueroris, seega valin ka selle ja lisan tööriistaribale.
Vaata, kuidas eraldaja tuleb rühmitamisel kasuks. Muidu oleks võinud mõni, kes minu tööriistariba esimest korda näeb, arvata, et nupp Konqueror on sama, mis alustamisnupp või lausa selle vastand.
Rakenda muudatused ja klõpsa lõpetamiseks nupule .
Ah, kui lahe uus tööriistariba! Igati käepärane ja mõnus.
Testi kindlasti oma tööriistariba, proovides klõpsata kõigile nuppudele, et näha, kas kõik teevad ikka seda, mida nad peavad tegema.
Seejärel salvesta tööriistariba: ->->.
Salvesta see kindlasti õigesse kataloogi. Kuna NeXML-i ei ole veel olemas, on see mul mul tipptaseme kataloogis, aga sinu tööriistaribad tuleb salvestada korrektsesse kataloogi. Kohenda kindlasti ka faili description.rc, et tööriistariba(d) laetaks alati, kui lood uue selle tüübiga faili.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Võib-olla üks tavakasutajale kõige silmatorkavamaid lisandusi Quanta Plusis on võimalus lisada dokumentatsiooni endale meelepärase märgistus- või skriptikeele kohta. See peatükk selgitab, kuidas luua PHP dokumentatsioonipuu isiklikuks kasutamiseks.
Enne seda, kui asud looma omaenda dokumentatsiooni, võiksid kontrollida Quanta Plusi hoidlast, ega keegi juba midagi sellist teinud pole.
Loomisprotsess koosneb kahest osast. Esiteks tuleb hankida antud märgistus/skripti/jne. keele olemasolev dokumentatsioon. Teiseks tuleb luua docrc fail. Esimene jääb su enda ülesandeks, teist asume järgnevalt kirjeldama.
Fail docrc näeb üldiselt välja selline:
#KDE Config File
[Tree]
Doc dir=dokumentatsiooni html-failide asukoht antud faili suhtes nt. php42/
#top level elements
Top Element=nende dokumentide kirjeldus nt. PHP 4.2 documentation
Section 1=Section1.html
Section 2=#Sec2.1,#Sec2.2,#Sec2.3
Sec2.1=Sec2.1.html
Sec2.2=Sec2.2.html
Sec2.3=Sec2.3.html
...
[Context]
ContextList=func1,func2,tag1,tag2,tag3
func1=func1.html
func2=func2.html
tag1=tag1.html
tag2=tag2.html
tag3=tag3.html
Fail docrc jaguneb kaheks osaks: puu ja kontekst.
Puusektsioon määrab dokumentatsiooni esitamise dokumentatsiooni kaardil. Näiteks PHP-dokumentide korral võid näha midagi sellist:
Arvestades ülaltoodut, näeb minu PHP docrc välja selline:
#KDE Config File [Tree] Doc dir=php42/ #top level elements Top Element=PHP 4.2 documentation PHP 4.2 documentation=Table of Contents,#Getting Started,#Language Reference Table of Contents=index.html Getting Started=Introduction, ... Introduction=introduction.html ... Language Reference=Basic syntax, ... Basic syntax=language.basic-syntax.html ...
Pane tähele märki # kirjete “Getting Started” ja “Language Reference” ees. See näitab, et need on omaette ühikud puus, millel on omaenda sisu. Ma ei usu, et puu sügavusele oleks kusagil limiit seatud (kui jätta arvestamata kaine mõistuse määratu) — nii et kasuta siin oma paremat äranägemist.
Sisukord (Table of Contents) on otseviitega failile (ning seetõttu on see näha puuvaates viimasena — kataloogid esimesena!).
Tühikud segavat mõju ei avalda, kuid silma peaks peal pidama märkidel & ja <. On tõenäoline, et kõigis XML-põhistes Quanta Plusi ressursifailides asendatakse need vastavalt märkidega & ja <.
Faili docrc kontekstisektsiooni kasutatakse kontekstitundliku abi pakkumiseks. Oletame näiteks, et kirjutad PHP skripti ja tahad näha funktsiooni mysql_fetch_array dokumentatsiooni. Selleks tuleb lihtsalt funktsioon esile tõsta ja vajutada kontekstiabi saamiseks klahvikombinatsiooni Ctrl+H. Kohe ilmubki nähtavale mysql_fetch_array dokumentatsioon. Siin on ainult kaks kirjetüüpi: ContextList ja failiassotsiatsiooni read.
See on päris lihtne: komadega eraldatud nimekiri kontekstielementidest, mis sinu arvates peaks olema kättesaadavad (PHP puhul on need mõistagi PHP-funktsioonid).
Need on kujul kontekstielement=html-dokumendi lehekülg, nt. acos=function.acos.html
Minu docrc omajagu kärbitud kontekstisektsioon on selline:
#Kontekstiabi võtmesõnad [Context] ContextList=abs,acos,acosh,addcslashes,addslashes,... abs=function.abs.html acos=function.acos.html acosh=function.acosh.html addcslashes=function.addcslashes.html addslashes=function.addslashes.html ...
Nüüd võid faili docrc salvestada vastavalt sellele, kas soovid seda kasutada globaalselt või kohalikult, kataloogi $ või KDEDIR/share/apps/quanta/doc$. Seejärel loo failiga HOME/.kde/share/apps/quanta/docdocrc samas kataloogis alamkataloog (seesama, mille määrasid failis docrc) ning kopeeri sinna oma HTML-dokumendid.
Kui nüüd taaskäivitad Quanta Plusi, võidki dokumente näha.
Kui oled kindel, et dokumendid on asjalikud, ning soovid neid ka teistega jagada, saada fail docrc koos kogu sinu arvates vajaliku infoga Quanta Plusi hoidlasse, kus neid saab kasutada ka ülejäänud Quanta Plusi kogukond. See ei tee sind küll rikkaks, kuid laseb tunda heameelt, et oled andnud oma panuse parimasse olemasolevasse veebiarendusplatvormi.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Quanta Plusi kasutajana ei pruugi sa üksi olla. sul on võimalik jagada teistega mitmesuguseid ressursse (DTEP paketid, toimingutega tööriistaribad, skriptid, mallid). Seda saab teha kahel moel:
Ressursse saab saata e-kirjaga sõpradele, partneritele või kellele tahes. Menüükäsku Saada e-postiga võib näha mitmel pool, näiteks ->, ->, failide ja kataloogide kontekstimenüüs mallide ja skriptide puuvaates.
Ressursse saab laadida meie peahoidlasse, kust neid saavad endale tõmmata teised Quanta Plusi kasutajad. Saadetised vaadatakse üle ja muudetakse kättesaadavaks ainult juhul, kui meie arendajate meeskond hindab need korrektseks ja kasulikuks. Üleslaadimise korrektsuse tagamiseks oleks mõttes need digitaalselt allkirjastada, milleks läheb vaja GPG/PGP võtit. Seda infot saavad ressursside ehtsuse kontrollimiseks kasutada nii meie arendajad kui ka hiljem allalaadijad.
Ressursside tõmbamisest peaserverilt räägib “Ressursside hankimine”.
Üleslaadimisel palutakse sul sisestada oma salajase GPG võtme paroolifraas (paroolifraasi ei salvestata) või kui sul peaks olema rohkem salajasi võtmeid, siis valida see, mida soovid kasutada. Täida dialoogis Uue kuuma kraami jagamine kõik väljad (Eelvaaatluse URL võib jääda tühjaks) ning alusta üleslaadimist klõpsuga nupule OK.
Üleslaadimise saab algatada menüüst ->, ->, failide ja kataloogide kontekstimenüüst mallide ja skriptide puuvaates.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Quanta Plusi on võimalik uuendada ka ilma uut versiooni hankimata lihtsalt uusi ressursse tõmmates: DTEP paketid, toimingutega tööriistaribad, mallid, skriptid, dokumentatsioon. Üks võimalus on saada neid e-postiga või tõmmata mõnelt veebiserverilt, millisel juhul need tuleb tavaliselt ise käsitsi paigaldada. Heal juhul saad kaasa ka paigaldamisskripti, mis võtab seda vaeva vähemaks. Kuid Quanta Plusil on ka asjalik server, mis sisaldab selliseid ressursse, mida ei ole kaasatud rakenduse põhipaketti kas suuruse või vähese kasutamisvajaduse tõttu või mida on kasutajad ise hiljem meile annetanud. Neid saab paigaldada juba automaatselt. Selliseid ressursse saab tõmmata mitmel pool menüüs esineva käsuga Lae alla. Täpsemalt leiab sellised käsud menüüst ->, ->, failide ja kataloogide kontekstimenüüst mallide ja skriptide puuvaates.
Kui ressurss on tõmmatud, kontrollib Quanta Plus enne selle paigaldamist ressursi korrektsust ja signatuuri. Probleemide korral näidatakse sulle hoiatust ning sa saad otsustada, kas jätkata paigaldamist või mitte. Palun suhtu hoiatustesse tõsiselt ja loe need hoolikalt läbi. Kui ressursiga on kõik korras, ilmub lihtsalt infodialoog, kus saad näha, kes on ressursi loonud.
Kontrolli kindlasti, et paigaldad ressursse, eriti tööriistaribasid ja skripte, ainult usaldusväärsetest allikatest!
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Oma töös saab kasutada ka XML-keeli, mida Quanta Plus veel ei toeta, kui luua DTEP pakett. Selle loomine võib võtta siiski palju aega, sest kirja tuleb panna sadu sildifaile tagXML-vormingus. Seda saab küll ka märksa vähema vaevaga teha - nimelt DTD-d automaatselt DTEP paketiks teisendades.
Teisenduse saab käivitada menüükäsuga ->. Vali .dtd-fail, milles on defineeritud DTD, mida soovid kasutada, ning seejärel ilmub nähtavale selline dialoog:
Kirjed on järgmised:
Sihtkataloogi nimi: selle nime all salvestatakse loodav DTEP kataloogi $KDEHOME/share/apps/quanta/dtep
Nimi: DTD nimi (definitsioonistring).
Hüüdnimi: DTEP kasutajale nähtav nimi
!DOCTYPE definitsiooni rida: string, mis peab esinema !DOCTYPE-sildis, näiteks HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"
DTD URL:: DTD-failile osutav URL
Vaikimisi laiend: laiend, mida kasutavad tavaliselt antud DTD-d pruukides kirja pandud failid
Tõstutundlikud sildid ja atribuudid: see peaks olema enesestmõistetav ja on enamasti õige igasuguste XML-keele variantide korral
DTEP täppishäälestus pärast teisendust: märkimisel avab Quanta Plus pärast teisendust description.rc redaktori, et saaksid kohe uue DTEP päris oma käe järgi sättida. Soovitatav on see valik sisse lülitada.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Vabandused kõigi ees, keda ma olen unustanud või kelle nime ma olen valesti kirjutanud!
Suur tänu kõigile, kes kulutasid oma aega projektile kaasaaitamiseks!
Quanta Plusi arendajate meeskond:
Algne CSS redaktor
Kommander, mitmed võimalused, veaparandused
Paljude versioonide käivituslogo
VPL & tagasivõtmise/uuestitegemise süsteem
PHP4 silur
Raaminõustaja
Palju parandusi, DTD parsimise alused ja muu DTDga seotu
Tõlge taani keelde
XML parsimine & dokumentatsioon
XSL 1.0 DTEP, KXsldbg
Dokumentatsioon, veaparandused ja PHP siluja raamistik.
Projektihaldur ja veebilehekülje administraator.
Põhiarendaja
Kood, algupärane TagXML dokumentatsioon ja palju muud
Dokumentatsioon
Dokumentatsioon
DTDde lisamine ja hooldamine
endine põhiarendaja — suundus arendama kommertsversiooni
Puupõhine üleslaadimisdialoog
endine põhiarendaja — suundus arendama kommertsversiooni
Eriline tänu kuulub:
libxml2 ja libxslt kirjutajad.
Quanta Plus © 2000, 2001, 2002, 2003: Quanta Plusi arendajate meeskond.
Quanta Plus kasutaja käsiraamat © 2002, 2003: Quanta Plusi arendajate meeskond.
Käesolev dokumentatsioon on litsenseeritud vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele.
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
this application on osa KDE projektist http://www.kde.org/.
this application asub paketis kdewebdev KDE projekti peamises FTP saidis ftp://ftp.kde.org/pub/kde/.
Et this application oma süsteemis kompileerida ja paigaldada, anna this application baaskataloogis järgmised käsud:
%./configure%make%make install
Kuna this application kasutab autoconf'i ja automake'i, ei tohiks kompileerimisel probleeme esineda. Kui neid siiski ette tuleb, anna sellest palun teada KDE meililistides.
On üsna mõistlik oletada, et sa võid soovida muuta Quanta Plusi failide asukoha süsteemis endale meelepäraseks. Selleks pakub autoconf mitmeid võtmeid, mida saab edastada täitmiseks skriptile configure. Nende täieliku nimekirja saamiseks anna käsk ./configure --help. Siinkohal neid võimalusi lähemalt ei käsitleta.
Kui Quanta Plus tõrgub korralikult töötamast, võiksid kontrollida otsinguteed ja veenduda, et KDE 3 kataloog bin ikka asub sellel. Samuti kontrolli, ega kuskil ei vedele vanemat KDE versiooni, mis hõivab muutuja PATH enne KDE 3 bin kataloogi. Sama kehtib Qt™ kohta.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kehtiv avaldis, mis määrab, millised andmed on nõutavad. Vaata W3C® veebilehekülge
Täielikult kvalifitseeritud nimi. Näiteks xsl:myvariable. Vaata W3C® veebilehekülge
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team