# Projektid

## Uued projektid

&quantaplus;i projektinõustaja ( Projekt Uus projekt... ) 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 Projekt Projekti omadused .

## Projekti üldised seadistused

Nimi

- 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.

Fail

- See on &quantaplus;i projektifaili nimi. Vaikimisi on see sinu projekti nimi väiketähtedega, ilma tühikuteta ja laiendiga `webprj` (⪚ `foo.webprj`). See fail on salvestatud projekti baaskataloogi.

Serveri seadistused

- Protokoll

- 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.

Masin

- 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).

Kasutaja

- Võrgumasinasse sisselogiva kasutaja nimi. See on tõstutundlik.

Parool

- Parool võrgumasinasse siselogimiseks. See on tõstutundlik.

Port

- 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.

Kataloogi seadistused

- Peakataloog

- Juurkataloog, kuhu on salvestatud kõik projektifailid ja -kataloogid.

Mallide kataloog

- 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.

Tööriistaribade 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.

Projekti allikad

- Kohalike või võrgufailide lisamine

- See võimaldab lisada faile kohalikust failisüsteemist. Valida võib ka mitu faili või kogu kataloogi.

Wgeti kasutamine failide allalaadimiseks saidilt

- See võimalus on hea siis, kui sul on staatiline veebisisu, mida soovid alla laadida ja muuta. Kui server kasutab skripte (⪚ &PHP;, Python, &etc;), tuleb sul failid muul moel hankida.

## Failide lisamine projekti

Lisatakse failid asukohast

- Märkimisel kaasatakse failid, mis asuvad baaskataloogis. Kui on märkimata, võib projekti nii-öelda tühja koha peale luua.

Filtrid

- Lisatakse ainult märkekeele-, skripti- ja pildifailid

- Märkimisel kaasatakse projekti ainult märkekeele-, skripti- ja pildifailid.

Lisatakse järgmise maskiga failid

- Märkimisel näidatakse kõiki faile ja katalooge baaskataloogis ning sul on võimalik nende seast vajalikud välja selekteerida.

Kaasatakse failid

- Näitab peakataloogi faile, kus saab märkides vajalikud projekti kaasata või märget eemaldades välja jätta.

## Projekti muud seadistused

Autor

- Sisesta siia oma nimi (või ka varjunimi).

E-post

- E-posti aadress, kuhu soovid saata projektiga seonduvaid asju.

Projekti vaikeväärtused

- Vaikimisi DTD

- Võimalus valida märkekeel, mida antud projektis põhiliselt kasutad.

Vaikekodeering

- Võimalus valida kodeering, milles tuleb projekti failid avada ja salvestada.

Eelvaatluse prefiksi kasutamine

- 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 &etc;). Kirjuta siia aadressi esimene osa, nagu see eksisteerib serveril. ning &quantaplus; 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

- Prefiks, mida soovid kasutada.

Globaalsete mallide lisamine

- Kopeerib globaalsed mallid projekti kataloogipuusse.

Kohalike mallide lisamine

- 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 Projekt Projekti omadused (profiilide üleslaadimise kaardil) või kiirklahviga &Shift;F7.

## Projektide seadistamine

Projekti omaduste dialoog näeb välja selline:

Üldiste valikute kaart

Mõned elemendid on samad, mida kohtab projekti nõustajas. Neid kirjeldab create-new-project-3-2. Siin on kirjeldatud nõustajas puuduvaid valikuid.

## Projekti üldised seadistused

Projektist jäetakse välja

- Failide nimekiri (kasutada võib ka metamärke), mida ignoreeritakse, kui sooritad mingeid projektiga seotud toiminguid (näiteks Loe uuesti projekti kataloog).

Failis .cvsignore toodud failid jäetakse välja

- Eelneva täiendus, võimaldab projekti toimingutest välja jätta failid, mida toob ära fail .cvsignore.

Vaikevaade

- Projektivaade, mis laetakse projekti avamisel. Projektivaadetest räägib lähemalt project-views-3-2.

Silur

- 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 debugging-3-2.

Vaikevaade

- Projektivaade, mis laetakse projekti avamisel. Projektivaadetest räägib lähemalt project-views-3-2.

Kaardil Profiilide saatmine saab määrata üleslaadimise profiile (vt. upload-profiles), 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 team-members.

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 event-actions.

## Projektide kasutamine

### Projekti failid

Vaikimisi avab &quantaplus; käivitamisel viimati kasutatud projekti. Seda omadust ei saa praegu muuta.

Uue projekti avamiseks vali menüüst Projekt käsk Ava projekt... 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`.

&quantaplus;i sulgemisel salvestatakse projektifail automaatselt. Sul palutakse enne &quantaplus;i sulgemist salvestada muudatused failides, kui neid esineb. Sama juhtub uue projekti laadimisel.

### Projekti puuvaade

Projektipuu pakub võimaluse pääseda hõlpsasti ligi projekti failidele. Siin saab hallata kõiki aktiivse projekti faile.

Failide puhul avab klõps &HPN;ga järgmise menüü:

Need kirjed kõnelevad ise enda eest, nii et uuri neid omal käel.

Kataloogid on põhimõtteliselt samasugused, kuid &HPN; ei paku oma menüüs võimalusi Ava ja Ava kasutades:

Ka need kirjed on nii iseenesestmõistetavad, et ei vaja lähemat seletamist.

### Projektide üleslaadimine

Projekti üleslaadimise dialoog:

Projekti üleslaadimise dialoog.

Profiili nimi

- Siin saab valida profiili. Profiil sisaldab infot üleslaetavate failide asukoha kohta. Lähemalt räägib sellest upload-profiles.

Uus

- Selle nupuga saab luua uusi üleslaadimise profiile.

Muuda

- See võimaldab muuta parajasti valitud üleslaadimise profiili.

Eemalda

- See võimaldab eemaldada parajasti valitud profiili. Kui saadaval on vaid üks profiil, ei saa nuppu kasutada.

Parool säilitatakse

- 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.

Kõik

- Üleslaadimiseks valitakse kõik projekti failid.

Muudetud

- Üleslaadimiseks valitakse kõik muudetud failid.

Puudub

- Nimekirjast eemaldatakse kõik failid.

Vastupidi

- Kõigi nimekirja failide valimine/valiku tühistamine.

Ava kõik

- Kerib lahti kõik kataloogid.

Sulge kõik

- Kerib kokku kõik kataloogid.

Uuenda kõik

- Värskendab nimekirja.

Jätka

- Käivitab üleslaadimise

Loobu

- See katkestab käimasoleva üleslaadimise või lihtsalt sulgeb dialoogiakna, kui sul tuli enne üleslaadimise alustamist mõni parem mõte.

### Profiilide üleslaadimine

&quantaplus; 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:

Profiili nimi

- Kirjuta siia meelepärane profiili nimi.

Masin

- Serveri nimi, kuhu failid kopeeritakse. Kõlbab nii täielik domeeninimi kui ka IP aadress.

Protokoll

- Failide üleslaadimiseks kasutatav protokoll. Sõltuvalt &kde; versioonist võivad valikuvõimalused erineda. Igatahes peaks oleva võimalik valida &FTP;, faili (&ie; kohaliku) ja NFS vahel.

Port

- Failide edastamisel kasutatav port. Tavaliselt ei pea selle üle pead vaevama, kui just sinu võrguadministraator ei kasuta mõnda tavapärasest erinevat porti.

Kasutaja

- Autentimiseks kasutatav kasutajanimi.

Parool

- Autentimiseks kasutatav parool.

Parool salvestatakse kettale

- 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

- Asukoht serveris, kuhu failid kopeeritakse.

Kasutatakse vaikeprofiilina

- Võimaldab muuta parajasti vaadatava profiili vaikimisi kasutatavaks

## Projektivaated

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üü Projekt käskudega või projektiriba abil, mille saab avada menüükäsuga Seadistused Tööriistaribad Projektiriba.

Võimalik on valida endale vaikevaade, mis laaditakse projekti avamisel. Vt. configuring-projects-3-2.