DeepL: překlad s glosářem

U svých komentovaných paraglidingových přeletů mám české titulky. Ty se přímo na YouTube dají přeložit do angličtiny, ale funguje to dost žalostně. Jednak Google Translate asi dnes není ten úplně nejlepší překladač a jednak v paraglidingu používáme celkem velký žargon – určitě přes sto pojmů, které buď normální smrtelník vůbec nezná nebo mají v běžné řeči jiný význam. Pár ukázek:

stoupák: stoupavý termický proud
prostor: letecký prostor
vyhnít: neplánovaně ukončit termický přelet

Zkusil jsem na překlad použít DeepL, což trochu pomohlo, ale hlavní problém se žargonem zůstal. Nicméně DeepL umožňuje definovat vlastní slovník pojmů (glosář), kterým by mělo jít tento problém vyřešit.

Nejprve jsem si své titulky stáhl. YouTube API vytrvale vrací 404, tak posloužil starý dobrý yt-dlp s volbami --skip-download --write-subs.

Pak je potřeba na DeepL zapnout nějaký plán (např. API free) a vygenerovat API klíč. S tímto klíčem už se dá povídat s DeepL API pro PHP. Můžeme si vytvořit a použít vlastní glosář:

<?php
$deeplClient = new \DeepL\DeepLClient($authKey);
$entries = \DeepL\GlossaryEntries::fromTsv(file_get_contents("glossary.tsv"));
$glossaryId = $deeplClient->createGlossary('Paragliding', 'cs', 'en', $entries)->glossaryId;
echo $deeplClient->translateText($text, 'cs', 'en-US', ['glossary' => $glossaryId]);
?>

Funguje to skvěle. Zatímco původní překlady byly prakticky nečitelné, nové překlady mapují český žargon na anglický žargon a anglicky mluvící paraglidista jim bude rozumět. Pár ukázek:

CS	Celkem rychle po startu se mi daří chytit čtyřkový integrovaný stoupák.
EN	I manage to catch the quad integrated climb quite quickly after take-off.
EN-g	Quite quickly after the takeoff I manage to catch the four m/s integrated thermal.

CS	Vytočím pod mrak, vyhlídnu si další, letím k němu a takhle pořád dokola.
EN	I dial under a cloud, look for another one, fly towards it, and keep going like that.
EN-g	I thermal under a cloud, look for another one, fly towards it, and keep going like that.

CS	Jsem už mimo prostor, tak to jde zase dobře.
EN	I'm out of space now, so it's going well again.
EN-g	I'm out of airspace now, so it's going well again.