Timantti-sovellusprojektin 12. palaveri

Paikka: AgC226.1 (Agora, Mattilanniemi 2, Jyväskylä).

Aika: 21.6.2017 klo 16.00 - 18.15

Projektiryhmä

• Porvali Tuomas (puheenjohtaja)
• Latva-Salo Topi
• Kujala Miika
• Similä Marja (sihteeri)

Tilaaja

• Lappalainen Vesa

Ohjaajat

• Lehtinen Mika (tekninen ohjaaja)
• Santanen Jukka-Pekka (vastaava ohjaaja)

Pöytäkirja

Laadittu 21.6.2017

Muokattu 26.7.2017

1 Palaverin avaus (ml. puheenjohtajan ja sihteerin valinta)

Porvali ehdotti itseään puheenjohtajaksi ja Similää sihteeriksi. Ehdotukset hyväksyttiin. Puheenjohtaja avasi palaverin.

2 Laillisuus ja päätösvaltaisuus

Palaveri todettiin lailliseksi ja päätösvaltaiseksi ensimmäisessä palaverissa määrättyjen käytänteiden perusteella.

3 Esityslistan hyväksyminen

Esityslistaan lisättiin kohta "Sovelluksen läpikäynti". Lisäyksen jälkeen esityslista hyväksyttiin.

4 Edellisen palaverin pöytäkirjan hyväksyminen

Käytiin läpi edellisen palaverin pöytäkirjan päätökset ja sovitut toimenpiteet.

Projektiryhmälle sovittujen toimenpiteiden tilat todettiin seuraaviksi:

• Päivittävät työnkulkukaavion ajan tasalle. (Kesken)
• Lisäävät vaatimus tilan, joka kuvaa: ominaisuus on tehty, mutta ei ole testattu. (Kesken)
• Lisäävät TIM-järjestelmään mahdollisuuden lisätä sisältöä, joka näkyy vain tulosteessa (ei näy HTML-sivulla, mutta näkyy tulosteessa). (Kesken)
• Lähettää tekniselle ohjaajalle esimerkin expanded_markdown_metodin virheestä. (Kesken)
• Ilmoittavat sovelluksen valmistumispäivän. (Kesken)

Pöytäkirjasta uupui olennaisia palaverissa keskusteltuja asioita. Niiden lisääminen todettiin kuitenkin lähes mahdottomaksi koska edellisestä palaverista on jo aikaa.

Päätökset

• Pöytäkirja hyväksyttiin puutteista huolimatta.

5 Tilakatsauksen läpikäynti

Tilakatsaus käytiin läpi.

Tilakatsauksen läpikäynnissä nousi esille huomio CSS-tulostuksen sivunvaihdosta. Arealle määritettävä sivunvaihdon esto siirretään jatkokehitykseen, ellei ole olemassa jo valmista toiminnallisuutta, jolla arean tyylin voi määritellä. Olemassa olevaa koodia ei tule kuitenkaan kokonaan poistaa vaan se tulee jättää koodiin kommenttina.

Päätökset:

• Arean sivunvaihdon esto jatkokehitykseen, ellei ole olemassa valmista tapaa määritellä arealle tyylejä.

6 Sovelluksen läpikäynti

Sovelluksen toimintaa käytiin läpi Timg-kehityskoneella.

TIMin sivupalkissa olevan Help-painikkeen voisi poistaa. Painikkeessa olevan kysymysmerkin voisi siirtää sivupalkin Print document-otsikon perään. Kysymysmerkistä avautuisi tulostuksen käyttöohje.

Sovelluksessa käytetty tulostusdialogi ei ole TIMin ns. draggable-dialogi. Kuitenkin todettiin, että vastaavaa dialogia on käytetty muuallakin eikä sitä tässä vaiheessa ole tarvetta muuttaa.

Tulostusdialogissa olevaan template-listaan voisi templatet listata ainoastaan niiden otsikolla. Listassa käytettäisiin template-tiedoston otsikkoa, ei sen URLia. Käyttäjän omasta hakemistosta listatut templatet olisivat muodossa users/'käyttäjänimi'/'templaten_nimi'.

Nykyisessä template-listassa templatet ovat linkkeinä. Tätä voisi muokata siten, että templaten nimi on tavallisena tekstinä. Templaten nimen perässä olisi kynä symboli jota klikkaamalla pääsee template-tiedostoon.

Nykyisestä template-listasta voisi oletuksena olla yksi valittuna. Jatkokehitykseen vietiin idea, jossa dialogi muistaa käyttäjän edellisen valinnan ja se näytetään seuraavan kerran kun dialogi avataan.

Dialogin otsikon Printing-sana tulisi erottaa jollain tavalla dokumentin otsikosta. Sanalla voisi käyttää esimerkiksi erilaista tyyliä. Välttämättä dialogissa ei tarvitsisi edes näyttää dokumentin otsikkoa, sillä tulostus dialogin voi avata kyseisellä dokumentilla ainoastaan dokumentin kautta. Tällöin käyttäjälle on selvää mitä dokumenttia ollaan tulostamassa, vaikkei sitä dialogissa lukisi.

Dialogin Create LaTeX - ja Create PDF -painikkeet voisi korvata yhdellä Create-painikkeella. Valinta PDF:n ja LaTeXin välillä tehtäisiin radiobuttoneilla. Oletuksen olisi valittuna PDF.

Create-painikkeen painamisesta pitäisi ilmaista käyttäjälle tieto, että painaminen onnistui. Tämän voisi toteuttaa vähintään muuttamalla painikkeen harmaaksi painamisen jälkeen. Väri palautuisi normaaliksi, kun dokumentti on muodostettu. Ilmaisemiseen voisi käyttää myös jonkinlaista pyörivää rinkulaa latausikonina.

Nykyisellään painikkeen painaminen avaa muodostetun dokumentin ponnahdusikkunaan. Kuitenkin lähes kaikissa selaimissa ponnahdusikkunat on estetty, jolloin käyttäjä ei välttämättä huomaa, että dokumentti on valmistunut. Tulostusdialogiin voisikin tämän takia dokumentin valmistuttua lisätä linkin joka vie dokumenttiin.

Nykyisellään sovelluksella ei onnistu kuvien saaminen dokumentteihin. Tämä on välttämätön toiminto, joka tulee saada valmiiseen sovellukseen. Kuvien saaminen tulosteeseen onnistuu todennäköisesti pandocin filtterillä. TIMin sisäisissä lähteissä olevat kuvat tulevat todennäköisesti toimimaan ongelmitta. Ulkoisista lähteistä otetut kuvat aiheuttavat enemmän ongelmia. Yksinkertaisimmillaan ulkopuolelta otetusta kuvasta tulostuisi ainoastaan sen URL. Tällöin vältytään mahdollisilta tekijänoikeusrikkomuksilta, kun kuvaa ei tarvitse tallentaa mihinkään TIMin palvelimelle. Ulkoisista kuvista voisi myös ilmoittaa tulostusdialogissa dokumentin valmistuttua.

Nykyinen tulostusdialogi ei toimi mobiilikäytössä. Dialogi on puhelimen näytölle liian iso eikä sitä pysty näytöllä siirtelemään. Jos dialogista saa helposti tehtyä skaalautuvan, se kannattaa tehdä.

Nykyisellään LaTeXin verbatim-ympäristö ei tee automaattisesti rivinvaihtoja. Tämän korjaaminen päätettiin siirtää jatkokehitykseen.

CSS-tulostuksen tilan todettiin olevan hyvällä mallilla. Kokeilussa havaittiin, etteivät linkit tule oikein CSS-tulostuksen kautta tehtyyn PDF:ään. Ongelman todettiin kuitenkin olevat niin pieni, ettei sitä lähdetä muuttamaan tässä vaiheessa.

Päätökset:

• Help-painike siirettään ikoniksi Print document -otsikon perään.
• Tulostusdialogia ei muuteta raahattavaksi dialogiksi.
• Templatet listataan niiden otsikolla, ilman turhaa tarkennusta.
• Templaten muokkaus kynä-ikonin kautta.
• Oletuksena yksi template valittuna.
• Jatkokehitykseen idea template-valinnan tallentamisesta.
• Tulostus dialogin otsikkoa pitää muuttaa.
• Tulostus dialogiin vain yksi Create-painike.
• PDF vai LaTeX valinta radiobuttoneilla.
• Käyttäjälle täytyy välittyä tieto painikkeen painamisen onnistumisesta.
• Tulostusdialogiin linkki valmiiseen dokumenttiin.
• Kuvien tulostaminen täytyy saada toimimaan.

7 Pluginify

Pluginit viedään kaikki kerralla eteenpäin käsiteltäväksi. Erityyppiset pluginit laitetaan omiin listoihinsa ja nämä listat menevät kaikki samalla kutsulla eteenpäin. Jokaisen pluginin LaTeX-muodon pyytäminen yksitellen olisi hyvin hidasta.

Tekninen ohjaaja lähettää sähköpostilla ohjeen, miten TIMissä oleva pluginify-funktio toimii. Koodia voi myös katsella läpi debuggerin avulla.

Pluginien käsittelyssä tulee ottaa huomioon myös print-lohko. Tämän käsittely kuitenkin onnistuu yksinkertaisella if-lauseella.

Päätökset:

• Projektiryhmä toteuttaa print-lohkon käsittelyn.

8 Muut esille tulevat asiat

Jatkokehitykseen kirjataan idea dokumentin kasaamisesta eri tiedostoista. Tällöin kansilehti, sisällysluettelo ja runko voisivat sijaita eri tiedostoissa.

Vastaava ohjaaja esitti, että projektin dokumentit tulisi julkistaa mahdollisimman pian jotta ne ehtivät tarkistukseen ennen heinäkuuta.

Sovelluksen koodia ei enää katselmoida erillisessä katselmointitilaisuudessa.

Sovellus olisi tavoite saada valmiiksi 19.7. mennessä, jolloin tekninen ohjaaja jää kesälomalle.

Päätökset:

• Ei järjestetä kolmatta katselmointi tilaisuutta.
• Sovellus on tavoite saada valmiiksi viimeistään 19.7.

9 Läsnäolijoille sovitut toimenpiteet

Projektiryhmälle sovittiin tehtäväksi seuraavat toimenpiteet:

• Päivittävät työnkulkukaavion ajan tasalle.
• Lisäävät vaatimus tilan, joka kuvaa: ominaisuus on tehty, mutta ei ole testattu.
• Lisäävät TIM-järjestelmään mahdollisuuden lisätä sisältöä, joka näkyy vain tulosteessa (ei näy HTML-sivulla, mutta näkyy tulosteessa).
• Lähettää tekniselle ohjaajalle esimerkin expanded_markdown_metodin virheestä.
• Ilmoittavat sovelluksen valmistumispäivän.
• Jatkokehitykseen sovittujen toimenpiteiden kirjaaminen vaatimuksiin tai sovellusraporttiin.
• Projektiryhmä toteuttaa sovellukselle sovitut muutokset.

Tekniselle ohjaajalle sovittiin tehtäväksi seuraavat toimenpiteet:

• Lähettää projektiryhmälle ohjeen pluginifyn toiminnasta.

Vastaavalle ohjaajalle sovittiin tehtäväksi seuraavat toimenpiteet:

• Projektiryhmän jäsenten kulkuoikeuksien jatkaminen.

10 Seuraavan palaverin aika ja paikka

Seuraava palaveri pidetään tiistaina 22.8.2017 kello 16.00 tilassa AgC226.1.

11 Kokouksen päättäminen

Puheenjohtaja päätti kokouksen.

12 Jaetut ja käsitellyt materiaalit

1. Edellisen palaverin pöytäkirja
2. Tilakatsaus
3. Sovellus