Kokelaan käyttöympäristön ohje, joka näytetään YTL:n digitaalisen ylioppilaskokeen kokelaalle Firefox-selaimella.
Kokeissa käytettävä versio ohjeesta löytyy osoitteesta https://cheat.abitti.fi/ (release haara). Nykyinen versio löytyy testiympäristöstä (master haara) https://cheat.test.abitti.fi.
Projektin kehitystä varten tarvitset Node.js version 18 https://nodejs.org/en/ (tarkempi versio löytyy .nvmrc
tiedostosta)
- Asenna projektin riippuvuudet komennolla
npm install
- Jos käsittelet ohjelmointivälilehteä, aja myös
make update-pyodide
- Generoi HTML tiedostot komennolla
npm run build:internet
(varsinaisen koetilanteen versio käyttäänpm run build
) - Tämän jälkeen voit ajaa projektia lokaalisti komennolla
npm run start
. Lokaalin koe-ohjeen löydät osoitteesta http://localhost:8080 - Testien ajamiseksi pysäytä yllä mainittu paikallinen kehityspalvelin, jonka käynnistit
npm run start
-komennolla. Käynnistä testitnpm run test
. Jos haluat nähdä selaimen, aja testitnpm run test -- --ui
.
TypeScript muutokset näkyvät selaimessa automaattisesti kun projekti on käynnissä. Jotta HTML tiedostojen muutokset tulevat näkyviin, pitää ne generoida uudelleen npm run build:internet
komennolla.
YTL ottaa vastaan muutosehdotuksia. Ennen isompaa muutosta kannattaa ensin keskustella aiheesta GitHub issuen kautta https://github.com/digabi/koe-ohje/issues.
- Tee tästä koodihakemistosta oma kopiosi (fork): (https://help.github.com/articles/fork-a-repo/)
- Tee muutokset omaan koodihakemistoosi (clone, commit, push): esim. https://guides.github.com/activities/hello-world/
- Lähetä muutosehdotus (pull request): (https://help.github.com/articles/creating-a-pull-request/)
- Ohje on kaksikielinen (käännöksiin saa tarvittaessa apua muutosehdotuksen yhteydessä tai GitHub issuen kautta)
HTML-struktuuri on selostettu tarkemmin tässä dokumentissa. Tutustu tähän ennen muutosten tekemistä, jotta lähdekoodin yleinen rakenne pysyisi yhtenäisenä ja muiden olisi helppo lisätä kaavoja myös tulevaisuudessa.
- Rakenna testisivulle esimerkiksi uusi kaava, jonka haluaisit lisätä kokoelmaan
- Kopioi ja liitä se oikeaan taulukkoon paikassa
content/tab-*<aineen_nimi>.html
- Älä vie versiohallintaan testisivua
- Tarkista, että rakenne on oikein ja että ääkköset toimivat (käytössä oltava UTF-8 enkoodaus). Ongelma voi syntyä, jos tiedostot tallennetaan Windowsin oletus enkoodauksella. Esimerkiksi Unix-ympäristössä UTF-8 muutos tapahtuu seuraavalla tavalla
file tab-<aine>.html // antaa nykyisen enkoodauksen
iconv -f ISO-8859-1 -t UTF-8 tab-<aine>.html > tab-math.html // korvaa nykyisen ISO-enkoodauksen UTF-8
- Varsinainen aputiedosto löytyy
content/index.html
. Välilehdet löytyvätcontent/tab-*.html
. - Testisivu kaavojen luomiselle löytyy
content/test/testpage.html
. - Lopulliset näytettävät tiedostot löytyvät
content/build
-kansion alta ja sen alaisia tiedostoja ei pidä muokata käsin (nämä generoidaan automaattisesti ja eivät ole versionhallinnassa). - Voit katsoa rakentamatonta sivua lataamalla selaimeen
content/index.html
-tiedoston (lokaalin tiedoston avaavat oikein Firefox/Safari). Ruotsinkielisen tiedoston voit ladata lisäämällä URL:iin?sv
eli näin:file:///polku-omalla-levyllasi/content/index.html?sv
Tutki ensin uuden videotiedoston äänenvoimakkuus:
$ ffmpeg -i videotiedosto.mov -af "volumedetect" -f null /dev/null
[Parsed_volumedetect_0 @ 0xb4cd900] mean_volume: -30.1 dB
[Parsed_volumedetect_0 @ 0xb4cd900] max_volume: -9.8 dB
Nyt haluat lisätä äänenvoimakkuutta 9.8 dB (ks. edellinen max_volume
ja skaalata videon 640px leveyteen:
ffmpeg -i "/home/user/input_video.mpg" -codec:v libvpx -quality good -cpu-used 0 -b:v 600k -qmin 10 -qmax 42 -maxrate 500k -bufsize 1000k -threads 2 -vf scale=640:-1 -af "volume=9.8dB" -an -pass 1 -f webm /dev/null`
ffmpeg -i "/home/user/input_video.mpg" -codec:v libvpx -quality good -cpu-used 0 -b:v 600k -qmin 10 -qmax 42 -maxrate 500k -bufsize 1000k -threads 2 -vf scale=640:-1 -af "volume=9.8dB" -codec:a libvorbis -b:a 128k -pass 2 -f webm output.webm
Tuloksena on output.webm
- Videot: Peter Ahlroos
- Matematiikka: Lotta Oinonen
- Fysiikka: Riitta Salmenoja, Ville Havu, Kristian Meinander
- Kemia: Katariina Tammi
- FontAwesome 5