Sazba diplomů

Implementace účastnických listů, diplomů úspěšného řešitele a pochvalných uznání (issues #423 (closed) a #212 (closed)).

Základní myšlenky:

• Generování výsledkovky uděluje pochvalná uznání (HM), pokud jsou zapnutá v nastavení kola.
• Ve všech pohledech na výsledkovku (organizátorská pracovní, organizátorská zmražená, účastnická oficiální) se HM ukazují.
• Přibyla stránka s diplomy dostupná (zatím jenom) ze stránky soutěže. Na ní lze diplomy generovat a prohlížet.
• Vždy se generují účastnické listy, pokud má soutěž oficiální výsledkovku, generují se i diplomy úspěšného řešitele a HM.
• Zatím existuje jeden formát diplomů, některé věci se dají parametrizovat (třeba kdo je na diplomech podepsaný). Časem by mohly přibýt další parametry (velikosti některých vertikálních mezer, ať se dá sazba snáz skloubit s uživatelským podkladovým obrázkem), nebo dokonce další formáty diplomů.
• Pro každou kombinaci soutěž + typ diplomů se vygeneruje jedno PDF se všemi účastníky. To si může organizátor stáhnout celé (pro tisk), ale také z něj OSMO umí online vykousnout stránku pro konkrétního účastníka. Tím pádem nemáme pro každého účastníka uloženu kopii potenciálně dost macatého obrázku na pozadí, a přitom jsou všechny pomalé akce odsunuté do jobů.

Zatím je spousta detailů nedořešená, podstatnější problémy jsou tyto (další detaily viz TODO):

• Obrázky na pozadí diplomu, zatím je jenom napevno logo MO na posledním řádku.
• Na stránce diplomů chybí vysvětlující text.
• Ověřovací služba na QR kódy neexistuje.
• Diplomy nejsou propojené se zbytkem organizátorského rozhraní.
• Diplomy se nezobrazují účastníkům.

Nicméně už teď to dává smysl číst a testovat.

mo/util_tex.py

@@ -10,8 +10,10 @@ import mo.util
 
 
 def tex_arg(s: Any) -> str:
-    # Primitivní escapování do TeXu. Nesnaží se ani tak o věrnou intepretaci všech znaků,
-    # jako o zabránění pádu TeXu kvůli divným znakům.
+    """
+        Primitivní escapování do TeXu. Nesnaží se ani tak o věrnou intepretaci všech znaků,
+        jako o zabránění pádu TeXu kvůli divným znakům.
+    """
     if s is None:
         s = ""
     elif type(s) is not str:
@@ -22,18 +24,21 @@ def tex_arg(s: Any) -> str:
     return '{' + s + '}'
 
 
+
 def format_hacks(tex_hacks: str) -> str:
-    # U výsledkových listin a diplomů lze zadat tex_hacks -- speciální
-    # nastavítka pro různé typografické hacky.
-    # Nemůžeme ovšem uživatelům dovolit předávat TeXu libovolné příkazy,
-    # protože bychom jim například zpřístupnili celý filesystem.
+    """
+        U výsledkových listin a diplomů lze zadat tex_hacks -- speciální
+        nastavítka pro různé typografické hacky.
+        Nemůžeme ovšem uživatelům dovolit předávat TeXu libovolné příkazy,
+        protože bychom jim například zpřístupnili celý filesystem.
+    """
     lines = []
-    for k, v in parse_tex_hacks(tex_hacks).items():
+    for k, v in _parse_tex_hacks(tex_hacks).items():
         lines.append('\\hack' + k + tex_arg(v) + '\n')
     return "".join(lines)
 
 
-def parse_tex_hacks(tex_hacks: str) -> Dict[str, str]:
+def _parse_tex_hacks(tex_hacks: str) -> Dict[str, str]:
     hacks = {}
     fields = re.split(r'([A-Za-z]+)={([^}]*)}', tex_hacks)
     for i, f in enumerate(fields):