Co se překládá

Výchozí pravidlo: překládat všechno

V RPG textech jsou kód, komentáře i front matter často herní termíny, proto nový projekt překládá všechno, co ho nevyloučíte. Co vyloučíte, zůstane v dokumentu bajt po bajtu a nikdy se nezmění, ani typografií.

Nastavení najdete v Projekt → Nastavení projektu → Překlad → Co se překládá. Vyloučit lze po druzích:

Druh	Poznámka
ohraničený kód (```)	viz níže
odsazený kód	souvislý běh řádků je jedna věta
front matter	překládají se jen vybrané klíče (výchozí title, subtitle, description, summary)
HTML řádky	jeden blok
HTML komentáře	překládá se text mezi <!-- a -->
odkazové definice	překládá se jen titulek, ne štítek ani URL
inline kód	nastavení je zvlášť

Překládají se jen bloky, které obsahují aspoň jedno písmeno.

Kód a komentáře

Pro každý jazyk bloku kódu lze zadat pravidlo komentářů (řádkový a blokový komentář) s předvolbami (Rust, JavaScript, C; Python, shell, YAML; SQL, Lua; HTML, XML). Pak se překládají jen komentáře a kód kolem zůstává bajt po bajtu. Bez pravidla je celý blok jedna věta, které se nedotkne typografie ani značky formátování.

Program záměrně neobsahuje parsery jazyků – značka komentáře se hledá jako první výskyt na řádku. Příklad se zná chyba: v Pythonu print("#x") se vyhodnotí jako komentář.

Změna nastavení uprostřed práce

Změna nastavení po začátku překladu mění členění vět, proto se provádí s náhledem: aplikace spáruje staré a nové věty stejně jako při aktualizaci zdroje, ukáže, co přibude a co zmizí. Zmizelé věty jdou do archivu (přeložené se vrátí, když druh znovu zapnete), změněné věty dostanou stav Ke kontrole.

Starší projekty bez tohoto nastavení se otevřou se starým chováním (vše vyloučeno), takže se jim členění vět nezmění.