https://github.com/davidhozic/cloggen

Student council habitation report generator (Generator študenstkih mnenj za Študenstki svet FE)
https://github.com/davidhozic/cloggen

generator latex rust

Last synced: 3 months ago
JSON representation

Student council habitation report generator (Generator študenstkih mnenj za Študenstki svet FE)

• Host: GitHub
• URL: https://github.com/davidhozic/cloggen
• Owner: davidhozic
• License: mit
• Created: 2024-10-19T19:47:16.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-01-12T13:20:52.000Z (5 months ago)
• Last Synced: 2025-01-22T20:51:49.948Z (5 months ago)
• Topics: generator, latex, rust
• Language: Rust
• Homepage:
• Size: 1.15 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CLOGGEN

Generator študentskih mnenj (za habilitacijo).

## Namestitev pisave (font)

Generiran dokument uporablja pisavo *Roboto*. V primeru, da pisava na sistemu ni nameščena, se dokument ne bo generiral.

Za namestitev uporabi datoteke v mapi ``data/fonts/Roboto``. Namesti vse datoteke.

## Generiranje dokumentov

Za generiranje dokumenta uporabi ukaz:

    cloggen create    -f  -o 

- ```` predstavlja izvoženo CSV datoteko z ocenami kandidata za posamezno vprašanje STUDIS anket

- ```` predstavlja JSON datoteko, ki definira odgovore za posamezno mejo ocene v formatu:

    ```json

        {

        "Vprašanje": {

            "Gledano v celoti, je delo izvajalca/ke kakovostno.": {

                "1": ["Odziv 1", "Odziv 2", ...],

                "1.5": ["Odziv 1", "Odziv 2", ...],

                ...

                "4": ["Odziv 1", "Odziv 2", ...],

                "4.5": ["Kandidat ima super ocene (povprečje {MEAN} $\\pm$ {STD}).", "Odziv 2", ...],

            }

        }

    }

    ```

    Odzivi so razporejeni po večih številkah. Številke so minimalna meja povprečne ocene pri posameznem vprašanju, ki

    jo mora kandidat imeti, zato da dobi enega izmed pripadajočih odzivov.

    

    Odziv bo izbran iz možnih odzivov, ki pripadajo prvi manjši oceni od povprečne ocene kandidata. Na primer, če ima

    kandidat pri vprašanju *Gledano v celoti, je delo izvajalca/ke kakovostno.* povprečno oceno 4.3, bo ob uporabi

    zgornjega JSON primera odziv izbran iz odzivov, ki pripadajo oceni 4.0 (``"4": ["Odziv 1", "Odziv 2", ...]``)

    V odziv se lahko dinamično vključi tudi **povprečje** in **standardni odklon**, kot prikazuje zgornjni JSON primer:

    ``"4.5": ["Kandidat ima super ocene (povprečje {MEAN} $\\pm$ {STD}).", ...]``. Tu bo ``{MEAN}`` z povprečno oceno za 

    pripadajoče vprašanje, ``{STD}`` pa s standardnim odklonom za pripadajoče vprašanje.

- ```` predstavlja glavni LaTeX dokument (datoteko),

    ki bo uporabljen za generacijo izhodnega mnenja v PDF obliki.

    Dokument mora vsebovati ``{AUTO_GEN}`` tekst, ki predstavlja lokacijo

    vstavitve odzivov/odgovorov, generiranih iz zgornje JSON datoteke odzivov.

- ```` predstavlja izhodni format. Privzeta vrednost je ``pdf`` (izhod bo .pdf datoteka),

    lahko pa se izbere tudi ``latex`` (izhod bo .tex latex datoteka).

- ```` predstavlja pot, kamor bo shranjen generiran dokument.

    Privzeto je ta vrednost enaka ``output_.``.

## Združevanje STUDIS anket

Cloggen omogoča združevanje večih STUDIS CSV datotek v eno skupno datoteko.

Združijo se le povprečne ocene posameznih datotekek, tako, da se povprečijo.

Standardni odklon je na novo izračunan iz povprečij datotek.

Na primer, če imamo dve datoteki s povprečji ocen 3.2 in 5.0, potem bo novo povprečje enako 4.1, standarndi odklon pa

bo enak 0.90.

### Uporaba

    cloggen merge   ...

Izhodna pot združene datoteke je privzeto ``./merged.csv``. Za lastno pot uporabi ``-o ``