64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
|
# Kululaskusilppuri
|
||
|
|
|
||
|
|
Kululaskusilppuri pilkkoo ja siistii [kululaskut.fi](https://kululaskut.fi):n
|
||
|
|
tuottamia CSV-tiedostoja OMS:n kirjanpitoon helpommin tuotavaan muotoon. Se
|
||
|
|
poistaa tiedoista käyttämättömät kentät, siistii loput
|
||
|
|
[Kitsaalla](https://kitsas.fi) luettavaan muotoon ja pilkkoo rivit erillisiin
|
||
|
|
tiedostoihin maksupäivien perusteella.
|
||
|
|
|
||
|
|
## Asentaminen
|
||
|
|
|
||
|
|
Lisää tämä git-tietovaranto [Guixin kanavalistaan][guix-channels]
|
||
|
|
seuraavankaltaisella pätkällä:
|
||
|
|
|
||
|
|
[guix-channels]: https://guix.gnu.org/manual/devel/en/guix.html#Specifying-Additional-Channels
|
||
|
|
|
||
|
|
```lisp
|
||
|
|
(channel
|
||
|
|
(name 'kululaskusilppuri)
|
||
|
|
(url "https://git.olarinmaensamoojat.fi/OMS/kululaskusilppuri")
|
||
|
|
(branch "main")
|
||
|
|
(introduction
|
||
|
|
(make-channel-introduction
|
||
|
|
"4a4d0add212aab3554689adb7971bc0b0db32d13"
|
||
|
|
(openpgp-fingerprint
|
||
|
|
"A0C9 1947 734F 076F 5F08 E9FF 257D 284A 2A1D 3A32"))))
|
||
|
|
```
|
||
|
|
|
||
|
|
Tämän jälkeen Kululaskusilppuri on saatavilla `kululaskusilppuri`-nimisenä
|
||
|
|
pakettina kaikkialla Guixissa. Voit esimerkiksi ottaa sen käyttöön
|
||
|
|
komentotulkkisessioosi komennolla `guix shell kululaskusilppuri`.
|
||
|
|
|
||
|
|
## Ajaminen
|
||
|
|
|
||
|
|
Yleensä kululaskusilppurin käyttö etenee seuraavasti:
|
||
|
|
|
||
|
|
1. Lataa uudet kululaskut CSV-tiedostona osoitteesta
|
||
|
|
<https://hallinta.kululaskut.fi>
|
||
|
|
2. Aja `kululaskusilppuri`
|
||
|
|
3. Vie Kululaskusilppurin luomat CSV-tiedostot Kitsaaseen
|
||
|
|
|
||
|
|
Jokaiselle komennolle tarvitsee määrittää oikeat asetukset komentorivillä
|
||
|
|
annettavilla valitsimilla. Mahdolliset valitsimet voi listata kirjoittamalla
|
||
|
|
komennon perään `--help`-valitsimen.
|
||
|
|
|
||
|
|
## Kehittäminen
|
||
|
|
|
||
|
|
Kehitysympäristön saat helposti Guixilla ajamalla komennon [`guix
|
||
|
|
shell`][guix-shell] tässä hakemistossa. Muutoksia, vikailmoituksia ja
|
||
|
|
kehitysideoita voi jättää Giteassa tai sähköpostilla osoitteeseen
|
||
|
|
<saku@laesvuori.fi>. Tarkista, että kululaskusilppuri kääntyy vielä muutostesi
|
||
|
|
jälkeen ajamalla komento `guix time-machine -C channels.scm -- build -f
|
||
|
|
guix.scm`.
|
||
|
|
|
||
|
|
[guix-shell]: https://guix.gnu.org/manual/devel/en/guix.html#Invoking-guix-shell
|
||
|
|
|
||
|
|
## Kopioiminen
|
||
|
|
|
||
|
|
Laskutin on [GNU AGPL lisenssin version kolme](COPYING.md), tai valintasi
|
||
|
|
mukaan minkä tahansa myöhemmän [Free Software Foundationin julkaiseman
|
||
|
|
version][fsf-agpl], alainen vapaa ohjelma, eli se kunniottaa käyttäjiensä
|
||
|
|
vapautta päättää itse omasta tietojenkäsittelystään ja auttaa toisiaan.
|
||
|
|
|
||
|
|
[fsf-agpl]: https://www.gnu.org/licenses/agpl-3.0.html
|