Teknillinen korkeakoulu Tik-111.361 Hypermediadokumentin laatiminen, kevät 1999 Harjoitustyön suunnitelma Harjoitustyön aihe Ryhmä: Martti Rahkila opnro Martti.Rahkila@tcm.hut.fi 16.02.1999
1 Yleistä 1 1 Yleistä Keväällä 1999 hypermediadokumentin laatiminen kurssilla harjoitustyöesimerkkinä ovat kurssin omat sivut. Näinollentämä suunnitelma, joka käsittelee kurssisivuja, on samalla myös suunnitelmaesimerkki. Suunnitelma ei ole aivan kattava, sillä luonnollisesti siitä onjätetty ulkopuolelle vain kurssin henkiläkunnan käyttöön tarkoitettu aineisto. Opintojaksojen sivuilla voidaan yleisesti ottaen erottaa kolme erilaista tavoitetta: tiedotus, oppimateriaali sekä tukitoiminnot. Näistä tiedotus on kaikkein yleisin ja soveltuu erinomaisesti toteutettavaksi WWW:ssä. Oppimateriaali on, kurssin sisällöstä riippuen, ehdottomasti hankalin ja laajin tavoite toteutettavaksi, varsinkin jos halutaan kehittää interaktiivista itseopiskeluaineistoa. Tukitoiminnot vaihtelevat kurssihallinnasta opetuksen arviointiin ja voivat niinikään olla varsin mutkikkaita, esimerkkinä vaikkapa erilaiset ryhmätyökalut. Kevään 1999 kurssisivut keskittyvät tiedotuksellisiin tavoitteisiin, mutta mukana on myös sisällöllistä aineistoa (mm. tämä esimerkkisuunnitelma) ja tukitoimintoja (kurssin arviointi). Tiedotuksellisesti kurssi voidaan jakaa kahteen eri osaan, jotka eroavat toisistaan sekä ajallisesti että kohderyhmiltään. Nämä osat ovat ns. ympärivuotiset sivut, joiden tarkoitus on palvella ketä tahansa käyttäjää, joka on kiinnostunut kurssista tai haluaa siitä lisätietoa, sekä kurssinaikaiset sivut, joiden tavoitteena on tarjota kaikki kurssin suorittamiseksi tarvittava tieto. Kurssinaikaisia sivuja päivitetään ahkerasti aina kun kurssi on käynnissä, ympärivuotisten sivujen päivitys sen sijaan noudattelee opetusohjelman mukaista päivittämistä, yleensä vuosittain. Pohjana suunnitelmalle ovat olleet TML-laboratorion omille opintojaksoilleen määritellyt tavoitteet, mutta hype-kurssin osalta on päädytty osittain poikkeaviin ratkaisuihin. 2 Kohderyhmät Kurssisivujen tärkeimmät kohderyhmät ovat: 1) Kurssia suorittavat opiskelijat, 2) kurssista kiinnostuneet opiskelijat, 3) kurssihenkilökunta (joka siis on jätetty tästä esimerkkisuunnitelmasta tietoisesti pois) sekä 4) korkeakoulun opetuksen kanssa tekemisissä olevat henkilöt kuten muut opettajat, opintoneuvojat, suunnittelijat jne. Kohderyhmistä voidaan olettaa seuraavaa: 1) Kurssia suorittavat opiskelijat - tiedoiltaan ja taidoiltaan varsin heterogeeninen, mutta voidaan olettaa, että kaikki ovat jossain määrin tuttuja WWW-sivujen toteutuksen kanssa (vrt. kurssin suosi-
2 teltavat esitiedot) - selvästi kiinnostuneita kurssinsisällöstä - ovat suhteellisen hyvin tuttuja selainohjelmien kanssa (voidaan myös olettaa, että suurin osa käyttää kehittyneimpien selainten uusimpia versioita mutta lisäksi myös muita!) 2) Kurssista kiinnostuneet opiskelijat - tarvitsevat tietoa kurssista, jotta voivat päättää onko kurssi heille sopiva ja miten sijoittaa sen opintosuunnitelmaan - markkinointia, mutta tiukasti asialinjalla! - todennäköisesti joukossa myös ei-suomenkielisiä opiskelijoita - selainohjelmista tai osaamisen tasosta ei voida olettaa mitään! 4) Korkeakoulun opetuksen kanssa tekemisissä olevat - tarvitsevat tietoa, jolla vertailla kurssia muuhun opetustarjontaan - ovat kiinnostuneita myös siitä, mitä kaikkea tietoa sivuilta on löydettävissä (jota voitaisiin mahdollisesti hyödyntää muissa kursseissa) - selainohjelmista tai osaamisen tasosta ei voida olettaa mitään! 3 Vuokaavio Vuokaavioesitys on jaettu kahteen osaan: ympärivuotisiin (kuva 1) ja kurssinaikaisiin sivuihin (kuva 2). 4 Sisältö 4.1 Yleiset periaatteet 4.1.1 Käyttöliittymä Käyttäjä etenee sivuilla pääosin tekstimuotoisina esitettyjen linkkien avulla. Linkit järjestetään joko listoiksi tai sijoitetaan suoraan tekstiaineiston sekaan. Kaikkien sivujen alussa on hype-tunnus, joka toimii myös linkkinä joko kurssin kotisivulle (ympärivuotiset sivut) tai kevään 1999 pääsivulle (kurssinaikaiset sivut). Sivujen lopussa on niinikään palkki, josta pääsee myös kotisivuille tai karttasivulle, joka sisältäämyös sivujen ilmestymisaikataulun. Selaimen Back-nappulan käyttö oletetaan hyvin tunnetuksi. 4.1.2 Graafinen ilme Koska kurssisivujen on tarkoitus toimia esimerkkinä yhtenäisestä kokonaisuudesta, graafinen ilme pidetään tiukasti yhtenäisenä kautta linjan, mutta toisaalta myös riittävän poikkeavana TML-laboratorion muista sivuista. Kurssisivujen graafinen ilme pidetään suhteellisen yksinkertaisena ja hillittynä. Elävyyttä pyritään luomaan harkitusti käytetyillä 3-D efekteillä. Sivuille halutaan myös luoda selvät rajat: alku ja loppu, joiden välistälöytyy varsinainen informaatio. 4.2 Kotisivu Yhteenveto: Kotisivun tarkoitus on ensisijaisesti palvella kurssista kiinnostunutta opiskelijaa, joka ei välttämättä tiedä kurssista mitään. Näin myös riippumatta
Kuva 1: Ympärivuotisten sivujen vuokaavioesitys HTML Rakenne kuvattu erikseen Opintojaksoesite Kuvaus Tavoitteet Kieli Suorittaminen Erikoistapaukset Yhteystiedot Kurs Course Overview TML Kurssin kotisivu Esittely (3 kieltä) Viimeisimmät tiedot Arkisto FAQ Palaute TML-linkit Uusimmat tiedot Arkisto Kts. Esite Kts. Esite Status: linkki uusimpiin tietoihin (K-99) kurssin K-98 K-97 K-96 aikana, muuten tieto seuraavan kurssin ajankohdasta FAQ Vastaukset useimmin esitettyihin kysymyksiin kurssista ja harjoitustyöstä Palaute Palaute/kysely/ yhteydenottolomake 4.2 Kotisivu 3
4 Viesti lähetetty Palaute/ kyselylomake HTML JAVA JAVASCRIPT PDF-dokumentti CGI/TIETOKANTA tms. Ilmoittautuminen Luennot Kirjallisuus ja lähdeaineisto Ilmoittautumisomake TOPI Aiheet Ohjeet 1. Osaan Esimerkkisuunnnitelma HYPE kotisivu K-99 kurssisivut Uutiset Tavoitteet Ilmoittautuminen Suorittaminen Luennot Lähteet Harjoitustyö Palvelin Aikataulu Arvostelu FAQ Henkilökunta Arviointi Muuta FAQ KARTTA Tehtävät Harjoitustyö Hype-palvelin Arvostelu Aikataulu Lupahakemus Tulokset Palautusohjeet PDF-ohjeet Ohjeet 2. Osaan Ohjeet 3. Osaan Esimerkkidokumentaatio Kirjautuminen Arviointilomake Arvioinnin Arvioinnin tulokset tulokset Huono esimerkki Kuva 2: Kurssinaikaisten sivujen vuokaavioesitys
4.3 Opintojaksoesite 5 siitä, sattuuko kurssi olemaan käynnissä vai ei. Sivu sisöltää linkit opintojaksoesitteisiin suomeksi, ruotsiksi tai englanniksi. Näiden alapuolella oleva liikennevalo kertoo kurssin tilan: käynnissä vai ei. Valon vieressä oleva selite kertoo saman sanoin. Sivun alareunasta löytyy lisäksi linkit kurssiarkistoon, FAQ:iin sekä palautelomakkeeseen. Tavoite: Kertoa onko kurssi käynnissä vai ei sekä tarjota linkit esitteisiin ja lisäaineistoon. 4.3 Opintojaksoesite Yhteenveto: kooste kurssin olennaisista asioista suomeksi, ruotsiksi ja englanniksi. Muistilista, jonka voi vaikka printata. 4.4 Arkisto Yhteenveto: kokoelma linkkejä aiempien vuosien kurssisivuille. Kun kurssi ei ole käynnissä, arkistosta voi opiskelija löytää lisätietoa esimerkiksi kurssin työmäärän arvioimiseksi. Arkiston merkitys on kuitenkin suurempi kurssi- ja opetushenkilökunnalle. 4.5 Palaute Yhteenveto: Välitön yhteydenottokanava kaikenlaisten kurssiin liittyvien kysymysten esittämiseen. Sikäli kuin kysymykset liittyvät parhaillaan suoritettavaan kurssiin, lomakkeessa on valmiit kohdat myös harjoitustyön aihetta yms. varten. 4.6 FAQ Yhteenveto: FAQ:iin kootaan vastauksia useimpiin kurssia koskeviin kysymyksiin. Luonnollisesti kaikki kurssin suorittamista jne. koskevat asiat sijoitetaan suoraan uusimmille kurssisivuille ja FAQ:in tarkoitus on sisältää lähinnä yleisluontoista tietoa kurssista. 4.7 Muuta tietoa Yhteenveto: linkki news-ryhmään, kurssin yhteystiedot. 4.8 Uusimmat kurssisivut 4.8.1 Pääsivu Yhteenveto: Pääsivu sisältää kaiken kurssin suorittamista varten tarvittavan tiedon alkaen tavoitteista ja ilmoittautumisesta päätyen kurssiarviointiin. Rakenne on periaatteessa lista, joka on järjestetty sekä ajallisesti että sisällöllisesti kurssin suorittamista tukevaan muotoon. Pääotsikoiden seassa on lisäksi selittäväätekstiä. Sivun yläreunassa on lisäksi Uutiset -appletti, jossa pyörii kulloisellakin hetkellä ajankohtaisia tiedotteita. Tavoite:toimiipäävalikkona, josta löytää kaiken kurssin suorittamista varten tarvitavan tiedon järjestettynäsisällöllisesti ja ajallisesti järkeväksi listaksi.
6 4.8.2 Ilmoittautumislomake Yhteenveto: Kurssin pääasiallinen ilmoittautumiskanava on TOPI, mutta niille opiskelijoille, jotka eivät voi tätä käyttää on vaihtoehtona ilmoittautumislomake. Lomakkeessa on valmiit kohdat aiheelle ja taustatiedoille. 4.8.3 Luennot Yhteenveto: Luentoaikataulu, jossa luentojen aihepiirit, luennoitsijat ja mahdolliset yritysten nimet. Linkit luentoaineistoon, jos saatavissa. 4.8.4 Kirjallisuus ja lähdeaineisto Yhteenveto: Suurehko kokoelma linkkejä hyväksi havaittuun tietoon aihepiirien mukaisestijärjestettynä. Linkkientoimivuustäytyytestata määräajoin. Listaa kasvatetaan opiskelijoilta ja luennoitsijoilta saatavien tietojen perusteella. 4.8.5 Harjoitustyö Yhteenveto: Harjoitustöiden pääsivu noudattelee samaa linjaa kurssin pääsivun kanssa: kaikki harjoitustöihin liittyvä materiaali esitetään listamuodossa alkaen aiheista ja päätyen 3. osan palautukseen. Pääsivulla on lisäksi yleiskuvaus harjoitustöistä. Aiheet Yhteenveto: Yksinkertainen luettelo harjoitustyöaiheista/aihepiireistä varustettuna esimerkeillä. Ohjeet 1. osaan Yhteenveto: Harjoitustyön suunnitelman vaatimukset. Jaetaan myös opetusmonisteissa. Tavoite: kuvata yksiselitteisesti kaikki suunnitelman osat. Esimerkkisuunnitelma Yhteenveto: Tämä dokumentti PDF-muotoisena. Jaetaan myös opetusmonisteissa. Palautusohjeet Yhteenveto: Palautusohjeet harjoitustyön eri osille. PDF-ohjeet Yhteenveto: ohjeet dokumenttien saattamiseksi PDF-muotoon. Linkkejä ohjelmistoihin. Ohjeet 2. osaan Yhteenveto: Harjoitustyön demo-osan vaatimukset.
4.8 Uusimmat kurssisivut 7 Ohjeet 3. osaan Yhteenveto: Harjoitustyön toteutusosan vaatimukset ja dokumentaatio. Esimerkkidokumentaatio Yhteenveto: Esimerkkidokumentaatio kurssisivujen toteutuksesta. Huono esimerkki Yhteenveto: Esimerkki erittäin huonosta HTML-sivusta. Sivulle rakennetaan sisällöllisesti huonoa ja epäselvää materiaalia, joka vielä toteutetaan mahdollisimman huonosti. Tavoite: olla esimerkki maailman huonoimmasta WWW-sivusta! Tehtävät Harjoitustyön eri vaiheiden yhteydessä palautettavat tehtävät, jotka liittyvät kurssin aihepiireihin. 4.8.6 Hype-palvelin Yhteenveto: Ohjeet ja kuvaus kurssin omasta palvelinkoneesta. Lupahakemuslomake Yhteenevto: lomake käyttäjätunnuksen hakemista varten kurssin palvelinkoneeseen PDF-muodossa. 4.8.7 Aikataulu Yhteenveto: Kurssin tärkeät päivämäärät havainnollistettunajavascript-laskurilla. 4.8.8 Arvostelu Yhteenveto: Arvosteluperiaatteet ja tavallisimmat kompastuskivet aiemmilta vuosilta. Tulokset Yhteenveto: harjoitustyön eri osien arvostelu ja tulokset. 4.8.9 Arviointi Yhteenveto: interaktiivinen arviointimoottori, jolla opiskelijat voivat arvioida kurssia. Opiskelijat voivat arvioida kurssia eri vaiheissa ja myös muuttaa arviointiaan. Arvioinnin yhteistulokset lasketaan lennossa. Tulokset ovat alkuun nähtävissävain opiskelijoille ja myöhemmin kaikille. Luonnollinen toteutustapa on tekstitietokantapohjainen CGI-sovellus.
8 5 Materiaalin tuotantoprosessit Tuotantoprosessi ja sivujen aikataulu on esitetty kaaviossa (kuva 3). 6 Aktiivinen osa Hyvin sisältöön sopiva interaktiivinen palvelu on kurssiarviointi. Tarkoitus on, että opiskelija voi kurssin edetessä arvioida eri asioita kurssista ja halutessaan myös muuttaa arviointia. Luonnollisin toteutustapa on CGI/tietokantaratkaisu, jossa indeksinä toimii opiskelijanumero. Arvioinnin tunnusluvut lasketaan on-line kaikista saaduista vastauksista. Kurssin kuluessa vain ilmoittautuneilla opiskelijoilla on mahdollisuus seurata tuloksia, kurssin päätyttyä tulokset asetetaan kaikkien näkyville. 7 Palautemekanismi Palautemekanismia hyödynnetään välittömänä yhteydenotto- ja kyselykanavana kurssin asioista. Se on suunnattu erityisesti sellaisille käyttäjille, jotka ovat kiinnostuneita kurssista, mutta eivät välttämättä ole TKK:lta. Palautemekanismi on käytössämyös ilmoittautumislomakkeessa, joka on tarkoitettu sellaisille henkilöille, jotka syystä tai toisesta eivät voi ilmoittautua kurssille TOPIlla. 8 Ajankäyttö Arvioitu työmäärä kurssisivujen osalta on 1) suunnittelu 40 h, toteutus + testaus 80 h. 9 Tyylisivut Koska kaikki sivut ovat ulkoasultaan varsin yhtenevät, käytetään kaikilla sivuilla samaa tyylisivua. 10 Selainriippuvuus Sivuilla maksimoimaan yhteensopivuus eri selainten välillä noudattamalla tiukasti HTML 4.0 Transitional spesifikaatiota, mikä lienee tämän hetken joustavin HTML-spesifikaatio. Se on myös suhteellisen hyvin tuettu uudemmissa selaimissa, sillä spesifikaatio sisältäämyös aiemmin selainkohtaisia HTML-laajennuksia. Näiden käyttöä pyritään luonnollisesti välttämään. Kurssisivuilla on kuitenkin kaksi selainriippuvaa osiota: 1) Uusimpien kurssisivujen pääsivulla oleva Java-appletti vaatii java 1.0.2 tai uudemman tuen selaimelta sekä 2) Aikataulu-sivulla oleva JavaScript-laskuri toimii vain uudemmilla Netscape-selaimilla. Java-appletin osalta muiden selainohjelmien käyttäjät huomioidaan normaalimenettelyllä eli vastaava informaatio kirjataan applet-tagien väliin.
Kuva 3: Kurssisivujen tuotantoprosessi ja aikataulu Tik-111.361 Hypermediadokumentin laatiminen (K-99) Sivu Kohderyhmä Kriittisyys Kesto Ajankohta Kieli Indeksointi Toteutustapa Yllpitää kotisivu 1,2,4 kyllä v 1999-1 kyllä vast.opettaja esite 1,2,4 kyllä v 1999-1 suomi/ruotsi/englanti kyllä vast.opettaja arkisto 1,2,4 1999-1 vast.opettaja palaute 1,2,4 kyllä 1999-1 vast.opettaja FAQ 1,2,4 kyllä 1999-1 kyllä kurssi-hk K-99 1,4 kyllä k-99 1999-1 kyllä HTML+JAVA kurssi-hk ilmoittautuminen 1, kyllä 2 kk 1999-1 kurssi-hk luennot 1,4 kyllä k-99 1999-1 kyllä kurssi-hk lhteet 1,4 kyllä k-99 1999-1 kyllä kurssi-hk harjoitustyö 1, kyllä k-99 1999-1 kurssi-hk aiheet 1, kyllä k-99 1999-1 kurssi-hk tehtvt 1, kyllä k-99 1999-2/3/4 vast.opettaja ohjeet 1.osaan 1, kyllä k-99 1999-2 LaTeX2HTML vast.opettaja esimerkki 1. osaan 1, kyllä k-99 1999-2 PDF vast.opettaja palautusohjeet 1, kyllä k-99 1999-2 kurssi-hk PDF-ohjeet 1, kyllä k-99 1999-2 kurssi-hk ohjeet 2. osaan 1, kyllä k-99 1999-3 LaTeX2HTML vast.opettaja ohjeet 3. osaan 1, kyllä k-99 1999-4 LaTeX2HTML vast.opettaja esimerkki 3. osaan 1, kyllä k-99 1999-4 PDF vast.opettaja "huono esimerkki" 1, k-99 1999-4 kurssi-hk palvelin 1, kyllä k-99 1999-3 kurssi-hk lupahakemus 1, kyllä k-99 1999-1 PDF kurssi-hk aikataulu 1, kyllä k-99 1999-1 HTML+JS kurssi-hk arvostelu 1, kyllä k-99 1999-3 kurssi-hk tulokset 1,4 kyllä 6 kk 1999-6 kurssi-hk arviointi 1,4 kyllä 6 kk 1999-3 kyllä CGI vast.opettaja kartta 1, k-99 1999-1 kurssi-hk 10 Selainriippuvuus 9
10 Aikataulu-sivulla käytetty JavaScript-laskuri toimii varmuudella vain Netscape 3 tai uudemmissa selaimissa. Tämän takia sivulle rakennetaan selaintunnistus, niin ikään JavaScriptillä, siten, että laskuri ei esiinny muilla selaimilla lainkaan. Informaation kannalta laskuri ei ole välttämätön, vaan sen tarkoitus on havainnollistaa harjoitustyön aikataulua. 11 Työkalut Ainakin seuraavia työkaluja tullaan tarvitsemaan: hyvä tekstieditori, sekävektorigrafiikka- että kuvankäsittelyohjelmisto, validaattori, imagemap-editori, Adobe Acrobat PDF-tiedostojen tuottamiseen ja LaTeX2HTML-konvertteri.