DemoWWW

• Ensin...
• Sitten...
• Jos homma ei toimi
• Siirto muualle kuin Agoran W:-asemalle
• Käyttö harjoitustyön siirtoon
• Lisäkikkoja
• Mitä tiedostoja tarvitaan jotta DemoWWW-toimisi
• Pikanäppäimet
• Komentorivin optiot
• Käyttäjäikkuna

Demojen palauttaminen DemoWWW-ohjelman avulla

Ensin...

Sitten...

1. Käynnistä komentokehote
2. Tee hakemisto c:\MyTemp\ohj2\OMATUNNUS\demoN ('OMATUNNUS' ja 'N' tietysti korvataan sopivasti). (Tosin DemoWWW toimii miltä tahansa levyltä - esim. U: - ja missä tahansa hakemistossa, kunhan files.txt ja tehtävät ovat samassa puussa).
3. Kopioi kaikki tehtävätiedostot edellä mainittuun hakemistoon.
4. Kirjoita demowww
5. Ensimmäisellä käyttökerralla näkyviin tulee ensin Velho-ikkuna. Valitse oikea kurssi.
6. Valitse oikea työn "tyyppi".
7. Demon tai pääteohjauksen tapauksessa tarkista että tehtäväkerran numero on oikein.
8. Seuraavaksi kysytään siirtotapaa, joka Agoran tapauksessa EI ole FTP, eli painetaan vaan Seuraava.
9. Kirjoita Salasana-kohtaan joku salasanantapainen, joka kelpaa myös hakemiston nimeksi (katso syy tästä). Salasanan pitää olla kaikkien demojen osalta sama.
10. Kun salasana kuitataan, tulee ruutuun sinisellä se teksti, joka sinun pitää kirjoittaa Korppiin kurssin kohtaan DemoWWW. Voit pistää tekstin nyt leikepöydälle klikkaamalla sinistä tekstiä ja liimata sen sitten Korpissa, niin vältät kirjoitusvirjeitä
11. Lisää linkkiteksti Korppiin DemoWWW-kohdan alle.
12. Kun Velho-ikkuna suljetaan OK-nappulasta, jäljelle jää kaksi ikkunaa. DemoWWW-ikkunan kautta pääsee muokkaamaan indeksitiedostoa (files.txt), johon kootaan linkit kaikkiin demotehtäviin. ViewFile-ikkuna näyttää yksittäisen demotiedoston sisällön.
13. Tarkista että pääikkunan 2. rivillä oleva demon numero on oikein ja vaihda se tarvittaessa oikeaksi. Mikäli demon numero ei näy, niin valitse valikoista 'edit/options...'. kirjoita 'Demo nr'-kohtaan demojen numero.
14. Jos edelliset kohdat on tehty oikein, pitäisi työkalurivin alapuolella olla neljän tekstiruudun rivi. Demotehtävät lisätään tätä riviä apuna käyttäen
15. Kirjoita Filename-kohtaan demotehtävä-tiedosto, esim. 'd3teht123.txt'
16. Kirjoita Task-kohtaan ne tehtävät jotka tuo tiedosto kattaa, esim. '1-3', jos tuossa tiedostossa on tehtävät 1, 2, ja 3, tai '1,2,4' jos tiedostossa on tehtävät 1, 2 ja 4. Guru tai Bonus tehtävät merkitään esim. G1-2 tai B1 (Task-kohtaan, itse tiedostossa pitäisi näkyä esim. [TG1-2:2])
17. Kirjoita Points-kohtaan kuinka monta pistettä itse antaisit itsellesi tehtävästä - tietysti tehtävänannon max-pisterajan rajoittamana!
18. Kirjoita Comment-kohtaan kommentit tehtävästä - esim. 'etu- ja sukunimen vaihtamistehtävä'
19. Aloita uusi rivi painamalla ctrl-r. toista kohdat 15 - 18 kunnes kaikki tehtävät on lisätty
20. Tarkista että kaikki tiedostot näkyvät oikein painamalla Ctrl-I (tai painamalla printteri-nappia). Tehtäväsi avautuvat selaimeen (jos tässä vaiheessa tulee virheilmoitus siitä että index.html:ää ei löytynyt, älä välitä siitä jos tehtäväsi kuitenkin avautuvat selaimeen). Sulje kaikki netscapen ikkunat ennenkun tämän teet.
21. Klikkaa 'copy all files to www'-nappia (eli kirjekuorinappia) jos kaikki on kunnossa. Käy tarkistamassa että kaikki toimii osoitteesta http://www.ad.jyu.fi/users/K/KÄYTTÄJÄTUNNUS/ohj2/PASSWD/demoN/
22. Siirron voit testata myös TestaaDemo.bat:ia kutsumalla: Kirjoita optioissa kohtaan DemoWWW täsmälleen sama teksti, jonka olet kirjoittanut Korppiin. Paina Testaus-nappia (Ctrl-T). Lue tarkaan tulevat ilmoitukset! Kokeile klikata jokaista linkkiä.

Jos homma ei toimi

1. Kopioi kaikki tehtävät samaan hakemistoon
2. Kirjoita files.txt (tämän voi tehdä DemoWWW-ohjelmalla tai vaikka notepadilla). Sovella edellä annettuja ohjeita (formaatin täytyy olla oikea, ks lisätietoja tästä).
3. Siirrä tiedostot V:-levyllä oikeaan paikkaan (V:\ohj2\PASSWD\demoN)
4. Korppiin asetukset jotka on kuvattu tällä sivulla.
5. Tarkista että toimii!

Siirto muualle kuin Agoran W:-asemalle

1. Aloitus kuten Agoran tapauksessa
2. Optioissa DemoWWW-kohtaan sama teksti kuin Korpissa. Esim. www.cc.jyu.fi/~vesal/ohj2/abc123
3. Passwd-kohtaan kurssin jälkeinen sana, ed. esimerkissä abc123
4. Transfer mode -kohtaan f, eli FTP-siirto
5. Muut kohdat kuten Agoran siirrossa

Käyttö harjoitustyön siirtoon

1. Korvaa mahdollinen Demo N -rivi esim. tekstillä Vaihe 1 tms.
2. Agora: painat vain lähetä-nappia
3. Jos muu kuin Agora: optioissa DemoWWW-kohtaan kone johon siirrät, esim. www.cc.jyu.fi
4. Passwd-kohta tyhjäksi
5. Transfer mode -kohtaan f, eli FTP-siirto
6. Paina lähetä-nappia
7. Harjoitustyön siirron onnistuminen tarkistetaan selaimella

Lisäkikkoja

• Koita myös raahaus- ja pudotus-menetelmää tiedostojen lisäämiseksi
• Muitakin kommentteja voi lisätä. Kommentit alkavat aina '='-merkillä
• Files.txt-tiedoston voit tehdä kotonasi valmiiksi (esim. DemoWWW-ohjelmalla) ja tuoda se disketillä yliopistolle jossa sitten DemoWWW-ohjelman avulla lähetät demot nettiin (soveltaen edellä annettavia ohjeita sopivilta osin).

Mitä tiedostoja tarvitaan jotta DemoWWW-toimisi

• DemoWWW.exe - itse pääohjelma, jos ei lähetetä eikä esikatsella, muuta ei tarvita
• DemoWWW.html - tämä ohjetiedosto
• Perl - tulkki pitää olla asennettuna lisätoimintoihin
• DemoWWW.bat - tiedostojen lähettäminen
• lue.pl - tiedostojen lähettäminen
• vlftplib.pl - tarvitaan lisäksi jos tiedostoja siirretään muualle kuin Agoraan, FTP-siirto
• testaademo.bat - siirron onnistumisen testaaminen
• luedemo.pl - hakee demot netistä, siirron testaaminen
• laskedemo.pl - laskee demopisteet ja tekee indeksisivun, siirron testaaminen
• selain - joku selain pitää olla käytössä
• Seuraavat jos haluat tehdä JavaDoc-muotoisia tiedostoja
• Vähintään Java SDK 1.4.1 asennettuna ja ainakin JavaDoc polussa
• j2h.jar - muuttaa .java-tiedostot värikoodatuiksi html-tiedostoiksi
• j2h.bat - ajaa edellisen
• j2h - vastaava komentojono Linuxille (muokkaa CLASSPATHit tarpeen mukaan)

Pikanäppäimet

Seuraavassa c = Ctrl+, sc = Shift+Ctrl  a=Alt+
Pika näppäimet toimivat missä tahansa ikkunassa

F1      = avustus
F3      = avaa uusi files.txt tiedosto
c+S     = talleta files.txt-tiedosto
a+X     = lopeta

a+BS    = peruuta
c+X     = leikkaa (maalattu alue)
c+C     = kopioi (maalattu alue)
c+V     = liimaa

c+I     = esikatselu files.txt:stä html-muodossa
F9      = siirrä files.txt + muut tiedostot WWW:hen
c+T     = testaa siirron onnistuminen

c+L     = lisää viivarivi
c+R     = lisää uusi tehtävärivi
c+End   = siirry viimeiselle riville files.txt:ssä
c+Home  = siirry ensimmäiselle riville files.txt:ssä
c+alas  = seuraava tehtävä files.txt:stä
c+ylös  = edellinen tehtävä files.txt:stä

F5      = näytä/älä näytä tiedostoikkuna
c++     = suurenna tiedostoikkunan fonttia
c+.     = pienennä tiedostoikkunan fonttia
c+O     = vaihda OEM/Ansi tiedostoikkunassa

c+U     = näytä käyttäjäikkunan
F2      = arvo satunnainen käyttäjä (jos käyttäjä ikkunan on näkyvissä)
sc+ylös = edellinen käyttäjä (jolla valittu tehtävä tehtynä)
sc+alas = seuraava käyttäjä (jolla valittu tehtävä tehtynä)

hiiren-oikea nappi -raahaus toiseen ohjelmaan
        = siirtää valitun tehtävätiedosto toiseen ohjelmaan
raahaus toisesta ohjelmasta
        = Filename-kohtaan => korvaa tiedoston nimen
        = files.txt-tekstin päälle => lisää tiedoston(/tiedostot)
          files.txt:hen

Komentorivin optiot

Kutsu:
  DemoWWW     - aukaisee DemoWWW:n oletushaemistoon
                jos hakemistossa on files.txt se avataan, muuten
                luodaan uusi
  DemoWWW hakemisto
              - aukaiseen DemoWWW:n hakemistoon
  DemoWWW /p  - aukaisee DemoWWW:n viimeksi käytettyyn hakemistoon
  DemoWWW /u polku\user.html
              - aukaisee DemoWWW:n sekä käyttäjäikkunan ja lukee
                käyttäjäikkunaan tiedoston polku\users.html

Käyttäjäikkuna

• voidaan helposti selata eri oppilaiden tehtäviä.
• voidaan lajitella pistemäärän mukaiseen järjestykseen (Sort)
• voidaan ottaa valittu ryhmä
• voidaan arpoa satunnainen opiskelija (F2)
• voidaan laittaa ehdoksi tietty tehtävänumero
• voidaan siirtyä vain niiden oppilaiden välillä, joilla valittu tehtävä on tehtynä (sc+alas/ylös)