Home

Štruktúra

Markdown -> XeLaTeX -> XeLaTeX Jinja2 template -> PDF

Moduly

Rôzne dokumenty sa buildujú podľa rozličných templatov. Zatiaľ by sme mali mať

• semináre (spoločný template pre všetky, líšia sa iba štýlom a kontextom)

  • problems
  • solutions

• Náboj

  • booklet (teda veľká knižka)
  • tearoff (trhacie zadania s čiarovými kódmi)
  • answers (výsledky pre opravovateľov, grupované modulo 5)

• pozvánky

  • potvrdenie o účasti / bezinfekčnosti / whatever
  • čokoľvek ďalšie bude treba

Priečinky

core

Tu sa nachádza jadro DeGeŠa.

• dgs.sty obsahuje required packages a všeobecné defaultné nastavenia (napríklad siunitx).
• dgs-hacks.sty je súbor s dočasnými alebo trvalými hackmi, ktoré opravujú nedostatky LaTeXu. Nepredpokladá sa, že by mohol časom zmiznúť.
• dgs-fonts.sty includuje fonty (z fonts/)
• dgs-custom.sty obsahuje pár nastavení (asi sa to zlúči)

source

Toto je ideálne symlink obsahujúci jednotlivé repozitáre so zadaniami. Chceme prejsť na GitLab.

output

Sem DeGeŠ vypľuje výsledné dokumenty. Vnútorná štruktúra mirroruje source.

input

Sem sa ukladajú všetky znovuvygenerovateľné súbory. make distclean ich zmaže.

Štýly

Semináre

Seminárový modul má targety

• problems
• solutions

Priečinky

Náboj

Náboj má targety

• booklet
• tearoff
• answers

Metadáta

Tu by niekde malo byť určené poradie úloh (spraviť z tohoto osobitný článok)

Spustenie

DeGeŠ by sa mal spúšťať výhradne prostredníctvom svojho Makefile.

Makefile

Pre každý target by mala existovať dvojica targetov aj v rámci Makefile, ktoré popíšu dependencie a spustia Pandoc, prípadne Pandoc+XeLaTeX.

DeGeŠ vie automaticky konvertovať SVG na PDF, PNG a JPG by chceli byť pass-through.