https://github.com/digabi/koe-ohje
Kokelaan käyttöympäristön ohje, joka näytetään kokelaalle Firefox-selaimella ja https://cheat.abitti.fi
https://github.com/digabi/koe-ohje
Last synced: 5 months ago
JSON representation
Kokelaan käyttöympäristön ohje, joka näytetään kokelaalle Firefox-selaimella ja https://cheat.abitti.fi
- Host: GitHub
- URL: https://github.com/digabi/koe-ohje
- Owner: digabi
- License: other
- Created: 2015-12-17T12:47:28.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2026-01-13T05:16:26.000Z (5 months ago)
- Last Synced: 2026-01-13T08:35:47.561Z (5 months ago)
- Language: HTML
- Homepage: https://cheat.abitti.fi
- Size: 152 MB
- Stars: 3
- Watchers: 27
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/digabi/koe-ohje/actions/workflows/ci.yml)
# koe-ohje
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 käynnistäminen
Projektin kehitystä varten tarvitset Node.js version 18 https://nodejs.org/en/ (tarkempi versio löytyy `.nvmrc` tiedostosta)
1. Asenna projektin riippuvuudet komennolla `npm install`
1. Generoi HTML tiedostot komennolla `npm run build:internet` (varsinaisen koetilanteen versio käyttää `npm run build`)
1. Tämän jälkeen voit ajaa projektia lokaalisti komennolla `npm run watch`. Lokaalin koe-ohjeen löydät osoitteesta http://localhost:8080
1. Käynnistä testit `npm run test`. Jos haluat nähdä selaimen, aja testit `npm 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.
## Ohjeet muutosten ehdottamiseen
YTL ottaa vastaan muutosehdotuksia. Ennen isompaa muutosta kannattaa ensin keskustella aiheesta GitHub issuen kautta https://github.com/digabi/koe-ohje/issues.
1. Tee tästä koodihakemistosta oma kopiosi (fork): (https://help.github.com/articles/fork-a-repo/)
2. Tee muutokset omaan koodihakemistoosi ([clone](https://help.github.com/articles/cloning-a-repository/), [commit](https://github.com/abhikp/git-test/wiki/Committing-changes), [push](https://help.github.com/articles/pushing-to-a-remote/)): esim. [https://guides.github.com/activities/hello-world/](https://guides.github.com/activities/hello-world/)
3. Lähetä muutosehdotus (pull request): (https://help.github.com/articles/creating-a-pull-request/)
### Huomioitavaa muutosehdotuskesta
- Ohje on kaksikielinen (käännöksiin saa tarvittaessa apua muutosehdotuksen yhteydessä tai GitHub issuen kautta)
### HTML-struktuuri
HTML-struktuuri on selostettu tarkemmin [tässä dokumentissa](HTML.md). 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.
### Uusien kaavojen luominen
1. Rakenna [testisivulle](content/test/testpage.html) esimerkiksi uusi kaava, jonka haluaisit lisätä kokoelmaan
2. Kopioi ja liitä se oikeaan taulukkoon paikassa `content/tab-*.html`
3. Älä vie versiohallintaan testisivua
4. 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-.html // antaa nykyisen enkoodauksen
iconv -f ISO-8859-1 -t UTF-8 tab-.html > tab-math.html // korvaa nykyisen ISO-enkoodauksen UTF-8
```
## Vinkkejä
- Varsinainen aputiedosto löytyy `content/index.html`. Välilehdet löytyvät `content/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 `?lang=sv` eli näin: `file:///polku-omalla-levyllasi/content/index.html?lang=sv`
## Videoiden lisääminen
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`
## Kiitämme
- Videot: Peter Ahlroos
- Matematiikka: Lotta Oinonen
- Fysiikka: Riitta Salmenoja, Ville Havu, Kristian Meinander
- Kemia: Katariina Tammi
- [FontAwesome 5](https://github.com/FortAwesome/Font-Awesome)