Tampereen teknillinen yliopisto Ohjelmistotekniikan laitos OHJ-3500 Ohjelmistotuotannon projektityö LOGO:) Ryhmä XXX: Projektiryhmän nimi Projektin nimi Dokumentin nimi Jakelu: (Ryhmä) (Kurssihenkilökunta) (Asiakas) Ryhmä 123456 Teemu Teekkari 654321 Tiina Teekkari 123123 Ahto Simakuutio 321321 Alfred J. Nussi Vastuuhenkilö: Teemu Teekkari Tila: Dokumenttipohja Versio: 1.2 Muokattu: 23.09.2008
Versiohistoria Versio: Pvm: Tekijä: Kuvaus (muutokset, korjaukset): 0.9 01.09.2003 R1 Dokumenttipohja luotu 1.0 24.03.2004 R1 Muokattu pohja yleiseen jakeluun 1.1 20.08.2004 P. Koivuniemi Muutoksia pohjaan ja jokunen lisäys R13 pohjan perusteella 1.2 23.09.2008 T. Lainio Viittaustyyli muutettu ja pohja muokattu käyttämään monen sivun taulukoita sekä Latin9-koodausta. Muokattu: 23.09.2008 2/9
Sisältö 1 Johdanto 4 1.1 Tarkoitus ja kattavuus........................ 4 1.2 Määritelmät, termit ja lyhenteet................... 4 1.3 Viittaukset.............................. 5 1.4 Yleiskatsaus dokumenttiin...................... 5 2 Kuvat 6 2.1 Esimerkkikuva............................. 6 2.2 Esimerkkitaulukko.......................... 6 3 Viittaaminen 7 3.1 Kuinka viitataan........................... 7 3.2 Erikoisemmat viittaukset....................... 7 4 Otsikko 1 8 4.1 Otsikko 2............................... 8 4.1.1 Otsikko 3........................... 8 4.1.1.1 Otsikko 4...................... 8 4.1.1.1.1 Otsikko 5................. 8 Liitteet 9 Liite A: Esimerkki Liite B: Puulistaus Muokattu: 23.09.2008 3/9
Luku 1 Johdanto 1.1 Tarkoitus ja kattavuus Tämä L A TEX-dokumenttipohja on tarkoitettu kaikille, jotka tuntevat tarvetta sen käyttöön. Dokumenttipohjaa saa muokata ja levittää vapaasti. Tätä dokumenttipohjaa käyttivät vuoden 2003 2004 projektityökurssilla Vesa Poikajärvi, Tuukka Rouvinen, Janne Sikiö, Jouni Sonninen sekä Ari Takku. Pohja on muokattu vuoden 1999 pohjan avulla. Lisäksi kiitokset Pekka Virtaselle ja Mikko Matilaiselle, joilta on myös saatu apuja pohjan luomiseen. Tämän jälkeen pohjaa on muokannut kesällä 2004 projektityökurssin puolesta Pasi Koivuniemi. Tätä dokumenttipohjaa käyttivät ja muokkasivat vuoden 2008 2009 projektityökurssilla Teppo Lainio, Juhani Lauteala, Risto Oikarinen, Jarno Mannelin ja Iiro Vidberg. 1.2 Määritelmät, termit ja lyhenteet Taulukko 1.1: Dokumentissa käytettävät termit ja määritelmät Lyhenne: Selitys: HTML Hypertext Markup Language, versio 4.01 http://www.w3.org/markup/ HTTP Hypertext Transfer Protocol 1.1, RFC 2616 Jatkuu seuraavalla sivulla... Muokattu: 23.09.2008 4/9
Termi: Java JRE Taulukko 1.1 Jatkoa Selitys: Sun Microsystemsin alustariippumaton ohjelmointikieli http://java.sun.com Java Runtime Environment, Javan ajoympäristö http://java.sun.com 1.3 Viittaukset [Code 00] Code Conventions for the Java TM Programming Language. Sun Microsystems, Inc., 2000. http://java.sun.com/docs/codeconv/html/ CodeConvTOC.doc.html. Sivuilla käyty viimeksi: 05.11.2003. [W3C 99] W3C. HTML 4.01 Specification. Internet, 1999. http://www. w3.org/tr/1999/rec-html401-19991224/. Sivuilla käyty viimeksi: 22.10.2003. 1.4 Yleiskatsaus dokumenttiin Tässä dokumentissa on vain malli, miten dokumentin rungon voisi tehdä. Muokattu: 23.09.2008 5/9
Luku 2 Kuvat 2.1 Esimerkkikuva LOGO:) Kuva 2.1: Projektiryhmän logo. Kuten kuvasta 2.1 näkee, on ryhmällä ollut hyvä mielikuvitus logoa tehdessä. Kyseinen kuva on selkeyden vuoksi rajattu kehyksin. 2.2 Esimerkkitaulukko Taulukko 2.1: Tieteellisiä yksiköitä Mitattava suure: Yksikön nimi: Yksikön tunnus: Lämpötila Perunankeittoyksikkö Likviditeetti My precious e (op) Vuosikurssi n C Projektin edetessä ryhmä saattaa tarvita taulukossa 2.1 esiteltyjä poikkitieteellisiä yksiköitä. Muokattu: 23.09.2008 6/9
Luku 3 Viittaaminen 3.1 Kuinka viitataan Voi olla, että dokumenttia tehdessä pitää viitata johonkin julkaisuun tai vaikkapa Internet-sivustoon. Tämä onnistuu lisäämällä tarvittavat tiedot viittaukset/viittaukset.bib-tiedostoon. Tämä dokumentti käyttää viittaustyylinä tiedostosta wmaainf.bst löytyvää tyyliä wmaainf. HTML [W3C 99] on hyvin suosittu merkkauskieli. Kuitenkin Javalla koodatessa on syytä muistaa tyyliohjeet [Code 00]. 3.2 Erikoisemmat viittaukset Eri dokumenttien väliset ristiviittaukset onnistuvat esimerkiksi L A TEX-paketin xr avulla. Viittaukset saa käyttöön komennon \externaldocument{} avulla. Tarkemmat ohjeet selviävät kyseisen paketin manuaalista. Muokattu: 23.09.2008 7/9
Luku 4 Otsikko 1 Tässä luvussa esitellään L A TEX:n eri otsikkotasoja. 4.1 Otsikko 2 4.1.1 Otsikko 3 4.1.1.1 Otsikko 4 4.1.1.1.1 Otsikko 5 Muokattu: 23.09.2008 8/9
Liitteet Liite: Kuvaus: Sivuja: Liite A Esimerkki 1 Liite B Puulistaus 1 Muokattu: 23.09.2008 9/9
Ryhmä XXX. Projektin nimi Esimerkki Liite A Esimerkki 1/1
Ryhmä XXX. Projektin nimi Puulistaus Liite B Puulistaus Joskus on tarpeen esittää listoja puumaisessa rakenteessa. Se onnistuu seuraavasti. Puun eri tasojen väliin jäävää väliä saa säädettyä tämän liitteen lähdekoodista. B.1 Listaus Juuri1 Juuri2 Lehti1 Lehti2 Juuri3 Lehti3 Kommentti 1/1