Oppimateriaalin copyright © 2007 Arto Wikla. Tämän oppimateriaalin käyttö on sallittu vain yksityishenkilöille opiskelutarkoituksissa. Materiaalin käyttö muihin tarkoituksiin, kuten kaupallisilla tai muilla kursseilla, on kielletty.

581362 Ohjelmointikielten periaatteet keväällä 2007: ohjeita pikaoppaan laadintaan

(Muutettu viimeksi 21.2.2007)

Sisällöstä

Ohjelmointikielten periaatteet -kurssin osasuorituksena kirjoitetaan pikaopas jonkin ohjelmointikielen tyylin ja ideoiden nopeaan opetteluun. Oppaan paino kurssin pisteistä on 10/60.

Oppaan ei ole tarkoitus olla mikään yleinen ohjelmoinnin oppijakso. Opas on suunnattu henkilöille, jotka jo osaavat ohjelmoida ainakin siinä laajuudessa kuin laitoksen syventäviä opintoja suorittavan sopii olettaa osaavan.

Tämän kurssin käsitteitä saa ja on syytäkin käyttää kirjoittamisessa: staattinen/dynaaminen sidonta, vahva/heikko tyypitys, jne., jne. ovat käsitteitä, joilla opas asiat esittää. Esimerkit ovat välttämättömiä. On syytä olettaa, että lukija osaa Javaa. Siksi erityisesti vertailut Javaan saattavat olla käyttökelpoisia.

Opas toteutetaan www-sivuina, teknisiä ohjeita ja määräyksiä on alempana. Oppaan tulee olla suppea ja tiivis. Kaikkia esiteltävän kielen piirteitä ei siihen voi sisällyttää; mukaan kannattaa valita kielen mielenkiintoiset ja tyypilliset ominaisuudet. Ja on syytä muistaa tuo painoarvo 10/60 - työmäärän ei ole syytä nousta suuremmaksi kuin kurssin alkupuolen harjoitusten, ei toki jäädä pienemmäksikään. Laajuudesta kannattaa keskustella kurssin opettajien kanssa!

Pikaopas julkistetaan kurssin www-sivuilla. Jos joku ryhmä haluaa, opas voidaan laittaa laitoksen intranettiin, mutta olkaamme avoimia ja valistakaamme koko maailmaa! :-)

Tekniikasta

Pikaoppaiden (www-sivujen/-sivustojen) on sisällettävä ainakin seuraavat tunnistetiedot: kurssi ja lukukausi, tekijöiden nimet, sivun laadintapäivä (so. milloin valmistui)

Sivut voi laatia mallisivupohjaan perustuen. Myös omia formaatteja voi käyttää, kunhan kaikki tarpeellinen tieto helposti löytyy sivulta.

Opas toimitetaan Arto Wiklalle yhtenä pakattuna zip-tiedostona viimeistään 26.4. Tämän jälkeen toimitettuja oppaita ei enää oteta kurssiarvostelussa huomioon.

Zip-tiedostosta on purkauduttava unzip-komennon suoritushakemistoon, nykyhakemistoon, yksi alihakemisto, jonka nimi on sama kuin esiteltävän kielen nimi englantilaisin aakkosin. Tämän hakemiston on sisällettävä index.html-tiedosto, josta opas löytyy. Jos opas muodostuu useammasta html-sivusta tai sisältää esimerkiksi erillisiä kooditiedostoja, kaikki sivujen keskinäiset viittaukset on toteutettava suhteellisina! Viitaukset muualle on tietenkin toteutettava täydellisinä linkkeinä.

Jos sivuilla käytetään jotain muuta kuin yliopiston virallista ISO-8859-1-merkkikoodausta, zip-tiedostosta on purkauduttava myös .htaccess-tiedosto, joka säätää merkkikoodin oikeaksi. Jos esimerkiksi halutaan käyttää utf-8-koodia, .htaccess-tiedoston pitää sisältää rivi:

AddCharset UTF-8 .html

Kannattaa suosia yksinkertaista sivujen toteutusta ja keskittyä antoisaan sisältöön! ;-)


Takaisin kurssin pääsivulle.