Tämä tiedosto sisältää yleisiä ohjeita Meedio-projektia varten. --------------------------------------------------------------------------- Ennen kuin luot tai käsittelet tiedostoja, aja seuraavat käskyt linuxissa: newgrp meedio sekä umask 002 niin oikeidet menevät automaattisesti oikein ilman chmod-kikkailuja. --------------------------------------------------------------------------- PAKKAUS JAVALLA: hakemisto(polu)n oltava samanniminen kuin itse pakkaus. Java-tiedoston alkuun package pakkauksennimi; --------------------------------------------------------------------------- Ryhmän muuttaminen: chgrp meedio tiedoston.nimi - muuttaa tiedoston ryhmän meedio tiedostoksi Kaikkien omien tiedostojen ryhmän muuttaminen: mene /home/group/ -hakemistoon. Aja komento chgrp -R meedio meedio/ Nyt koko meedio-hakemiston kaikki omat tiedostot muuttuvat ryhmän meedio tiedostoiksi. --------------------------------------------------------------------------- Word-dokumenttien muuntaminen PDF-muotoon TKTL:llä: Valitse tulostus valikosta tulostimeksi "ps to file". Mene linuksissa hakemistoon, jossa edellä syntynyt .prn päätteinen tiedosto on. Muuta tiedosto.prn .ps-päätteiseksi komennolla mv tiedosto.prn tiedosto.ps. Muuta tiedosto.ps pdf-tiedostoksi komennolla: ps2pdf tiedosto.ps Jos ps2pdf:n kanssa tulee ongelmia, voi koittaa vielä seuraavia: ps2pdf:n sijasta käytä ps2pdf14 (uudempi) ps2pdf:n sijasta ensin ps2ps (!) ja sitten ps2pdf14 (jostain syystä tuo voi auttaa printtaamisessa) Kun dokkari on pdf-muodossa sen voi printata 2-puolisena ps2-tulostimelle antamalla acroreadissa printtauskomennoksi: mpage -1t -n0 -P2 --------------------------------------------------------------------------- CVS: ---- lisää nämä .profile tiedostoon: if [ "X$GROUP" = "X" ]; then export PATH="$PATH:/opt/cvs/bin" export MANPATH="$MANPATH:/opt/cvs/man" fi export CVSROOT="/home/group/meedio/cvsroot" export PATH="$PATH:/home/group/meedio/skriptit" Jos vapauta/lukitse ei silti toimi, aja edel. komennot itse. aluksi: (tämä siis vain 1. kerralla) -------------------------------------- mene /koodit/OMANIMI -hakemistoon, ja cvs checkout MDECodes Kun haluat tehdä töitä (ole /koodit/OMANIMI/MDECodes - hakemistossa) ----------------------- lukitse tiedosto.java , jos saat ilmoituksen, että tiedosto on jo lukittu niin joku muu editoi sitä. Älä tee töitä. Odota vuoroasi. kun olet valmis: (ole /koodit/OMANIMI/MDECodes - hakemistossa) ----------------- vapauta tiedosto.java Niin tiedosto vapautuu muidenkin käyttöön. kun haluat päivättää uusimmat versiot versionhallinnasta itsellesi: (ole koodit/OMANIMI/MDECodes - hakemistossa) ------------------------------------------------------------------- paivita --- Omat luomukset cvs:ään: (Ottaa koko sen hetkisen hakemistopuun) cd omahakemisto cvs import moduulinnimi Meedio start --------------------------------------------------------------------------- JUnit testaus: Lisää .profile tiedostoosi seuraava export lause: export CLASSPATH="$CLASSPATH:/home/group/meedio/junit/junit3.7/junit.jar" Tee testiluokkia testattavaa luokkaa varten tarpeellinen määrä ja nimeä ne selkeästi, esim. XMLElementTest.java. Katso koodia varten edellä mainittu tiedosto. Saat sen käyttöösi menemällä koodit hakemistossa omaan hakemistoosi ja kirjoittamalla komennon: cvs checkout MDETests Tämän jälkeen löydät esimerkkitiedostot MDETests hakemistosta, jonne voit myös tehdä omia testiluokkiasi. MDETests hakemistossa on sekä TestCase- että TestSuite-esimerkit. XMLElementTest.java on TestCase esimerkki. Eli tämä luokka määrittelee yhden testitapauksen XMLElementille. Toinen TestCase-esimerkki on XMLElementTest2.java. XMLElementTestSuite.java on TestSuite esimerkki, eli se sisältää kaksi testitapausta: XMLElementTestin ja SMLElementTest2:n. XMLElementTestSuiten ajaminen ajaa molemmat siihen liitetyt testitapaukset. ------------------------------ Ajaminen tapahtuu seuraavasti: Anna komennot: export CLASSPATH="$CLASSPATH:." java junit.swingui.TestRunner XMLElementTestSuite & Tämä ajaa molemmat testitapaukset ja näet ajon jälkeen kaikki tapahtuneet virheet. Test hierarchy -välilehdeltä voit selata eri testitapauksia ja niissä ilmenneitä virheitä metodikohtaisesti. Voit korjata virheen aiheuttanutta metodia, kääntää luokan uudelleen ja ajaa testin uudelleen klikkaamalla "metodipuun" ylhäällä olevaa "run"-painiketta, tämän voit tehdä sulkematta JUnitin ikkunaa. TestSuitelle voi antaa myös toisia TestSuiteja, jotka voivat sisältää sekä TestCaseja että TestSuiteja. Näin ollen voi testata vaikka ohjelman kaikki luokat yhdellä ajolla. ------------------------------------------------------------------------- Jena-ohjeita: Jenan käyttöön tarvitaan seuraavat CLASSPATHit: export CLASSPATH="$CLASSPATH:/home/group/meedio/jena/Jena-1.4.0/lib/jena.jar:/home/group/meedio/jena/Jena-1.4.0/lib/xerces.jar" export CLASSPATH="$CLASSPATH:/home/group/meedio/jena/Jena-1.4.0/lib/jakarta-oro-2.0.5.jar" export CLASSPATH="$CLASSPATH:/home/group/meedio/jena/Jena-1.4.0/lib/concurrent-1.3.0.jar" Näillä saat käyttöön Jenan ontologian / instanssien käsittelyluokat ja RDQL:n. Lisäksi Oraclen tietokantayhteyttä varten tarvitaan jdbc ajuri: export CLASSPATH="$CLASSPATH:/opt/jdbc/oracle/classes12.jar" ------------------------------------------------------------------------- LATEX-ohjeita: Jokainen editoi oman lukunsa .tex -päätteistä tiedostoa. ../meedio/tex/ hakemistossa on esimerkki .tex -tiedostot, joista meedio.tex on käännettävä, jossa tuodaan sisään kaikki muut tiedostot, esim. johdanto.tex. tämän lisäksi tex-hakemistossa on tyyli.sty-tiedosto, joka sisältää dokumentin asettelun. .tex ja tyyli.sty tiedostot kopioidaan samaan hakemistoon ja ne käännetään komennolla latex meedio.tex (meedio.tex tilalla on ko. dokumentin nimi, esim toteutus.tex) kahteen kertaan. Tämä siksi, että viittaukset ja hakemistot näkyisivät kunnolla. LATEX-komennot löytyvät ohjeesta, johon on linkki ryhmän kotisivulla. ------------------------------------------------------------------------- Toteutusdokumentin editointi: Toteutusdokumenttia editoidaan ../meedio/public_html/dokumentit/toteutus/ -hakemistossa. Kun otat oman lukusi käyttöön, lukitse se tuttuun tapaan lukitse-komennolla ja lopetettuasi editoinnin, vapauta tiedosto vapauta-komennolla. Esim. lukitse johdanto.tex kirjoita dokumenttia... vapauta johdanto.tex