verze 2023-12-07

Kontakt/garant: Jirka ([email protected])

Související manuály: ‣

Obecně k psaní textů

  1. ❗Každý obsáhlejší text by měl před publikováním projít korekturou – assignujte Jirku.

  2. Texty se snažíme psát faktograficky a věcně, nikoliv aktivisticko-buřičsky – nejsme aktivisti, poskytujeme data.

  3. Vyhýbáme se nepodloženým tvrzením, dohadům, soukromým názorům a domněnkám.

  4. Většina infografik používá v doprovodných textech stejné znění jako jiná infografika – pokud tedy upravíte na jednom místě, je třeba ověřit, zda není třeba upravit i jinde. crysman doporučuje hledat to strojově:

    grep --exclude-dir=_site --exclude-dir=.cache -iRIH "*zatímco emise z letu Amsterdam*"

  5. Používáme základní formátovací značky – viz podkapitola Formátování a formátovací značky.

  6. Kurzívu používáme v těchto případech:

    1. Cizojazyčný (typicky anglický/latinský) pojem vložený do českého textu, např. existence rodu *Homo sapiens* nebo při scénáři *business-as-usual*. Naopak zkratky kurzívou psát nemusíme, i když se jedná o anglickou zkratku, např. emisní scénáře (RCP).
    2. V případě že jde o terminus technicus, který chceme odlišit/zvýraznit v okolním textu.

  7. Tučný text používáme téměř výhradně v těchto případech:

    1. Na zdůraznění důležité věty nebo části věty:

    2. Pro titulek odstavce:

    3. Obecně s tučností šetříme, méně je lépe.

  8. „Uvozovky“ používáme primárně pokud doslovně citujeme jiný text, např. text článku, vládní zprávy, apod. V případě doslovné citace je vhodné použít i kurzívu. Pro souvislejší blok textu využít blockquoting.

  9. Odkazujeme do našeho slovníku (glossary.yaml), kde se dá. Pokud se jeden pojem opakuje na stránce vícekrát, tak není nutné odkázat do slovníku pokaždé. Pokud jde o výskyty v jednom odstavci nebo sekci, tak do slovníku odkážeme jen u prvního výskytu. Pokud se pojem znovu objevuje po dlouhé době, můžeme odkaz do slovníku zopakovat. Např. k dosažení tohoto

    je zdroják: množství 12,4 Gt <glossary id="co2eq">CO<sub>2</sub>eq</glossary>.

  10. Vyhýbáme se spojením „v minulém roce“, „letošní“ apod. Slovo „aktuální“ je taky relativně brzy neaktuální. Raději uvádíme data, roky, měsíce atp.

  11. Používáme dlouhou škálu jednotek – čili pokud v anglickém zdroji vidíte např. „billion“, je třeba v našem českém textu uvést „miliarda“.

Formátování a formátovací značky

Používáme primárně formátovací jazyk Markdown, a velmi zřídka HTML – jen tam, kde to nejde jinak. Bez základní znalosti Markdownu se neobejdeš – ale nezoufej, je to velmi jednoduché – vlastně jen přidáváš hvězdičky, podtržítka, křížky atp. A protože nemá smysl dělat Cut'n'paste dokumentace, tak: