Překlady
Naposledy aktualizováno 2. srpna 2026poststranslationsi18nmultilingual
Vícejazyčný obsah je prvotřídní funkcí modulu Příspěvky.Každá organizace si nakonfiguruje, ve kterých jazykových verzích publikuje, aplatforma udržuje překlad každého článku v každé nakonfigurovanéjazykové verzi — automaticky vytvořený z primárního jazykového zdroje,udržovaný v synchronizaci, když je zdroj upravován, a zobrazený v administraci, abyoperátor mohl na první pohled vidět, které články jsou aktuální, kterézastarály a které zcela chybí.Tento článek pokrývá celý rozsah překladů: jak modelrozhoduje, co je třeba přeložit, jak funguje automatický překlad, jakje detekována a opravena zastaralost, analytický panel na kartěPřeklady a nástroje založené na terminálu pro hromadnéoperace.
The mental model
Jádrem je jednoduchá neměnná zásada: primární jazyková verze jezdrojem pravdy, každá jiná jazyková verze je odvozená. Kdyžpíšete nebo upravujete článek, píšete v primární jazykové verzi. Kdyžuložíte, platforma zaznamená snímek této verze v primární jazykové verzi.Každý překlad v každé jiné jazykové verzi je označen odkazemna přesný snímek zdroje, ze kterého byl vygenerován.Později, když je zdroj znovu upraven, je zaznamenán nový snímek.Starý odkaz na každý překlad nyní ukazuje na zastaralýsnímek — platforma to rozpozná a označí překlad jakozastaralý, což znamená "stále existuje, ale zdroj se posunul dál."Opětovné vygenerování z aktuálního zdroje obnoví překlad aaktualizuje jeho odkaz na nový snímek.To je celý model. Všechno níže je důsledkem.The three per-locale states
Každý překlad každého článku je v jednom ze tří stavů vzhledemk dané jazykové verzi:- Aktuální (Fresh) — existuje řádek překladu a jeho odkaz odpovídáaktuálnímu snímku zdroje. Je synchronizovaný.- Zastaralý (Stale) — existuje řádek překladu, ale jeho odkaz ukazuje nastarší snímek zdroje, nebo odkaz zcela chybí (starý řádek z doby předtím, než platforma sledovala odkazy). Zastaralý;zdroj byl upraven od posledního překladu.- Chybějící (Missing) — v této jazykové verzi neexistuje žádný řádek překladu.Článek do ní nikdy nebyl přeložen.Mřížka článků zobrazuje tyto tři stavy jako barevné odznaky vedlekaždého názvu článku:- Zelená — aktuální- Jantarová — zastaralý- Šedá — chybějícíPřejetím myší nad odznakem se dozvíte, jaký je jeho stav a (pro zastaralé) proč.Automatic translation
Kdykoli má článek alespoň jednu chybějící nebo zastaralou cílovou jazykovou verzi,objeví se tlačítko automatického překladu v postranním panelu detailu článku (vsekci Jazyky) a v kontextové nabídce řádku mřížky článků.Kliknutí na tlačítko spustí překladovou pipeline pro danýčlánek:1. Platforma načte aktuální název a tělo článku v primární jazykové verzi.2. Pro každou povolenou jazykovou verzi, která buď chybí, nebo je zastaralá:- Odešle text v primární jazykové verzi a kód cílové jazykové verzepřekladovému modelu.- Obdrží zpět přeložený název a tělo.- Ověří odpověď — neprázdný obsah, pokud zdroj obsah měl,věrohodný poměr délky oproti zdroji a to, žemodel jednoduše nezopakoval zdroj doslovně.- V případě selhání jakéhokoli ověření se pokusí znovu s dalším modelemv řetězci záložních modelů (celkem tři modely, pokrývající dva poskytovatele).Selhání jednoho modelu nepřeruší běh — pouze selhání všech modelů.- Při úspěchu vloží překlad do řádku jazykové verze článkua označí aktuální referenci snímku zdroje.3. Kanonické URL adresy článku jsou zajištěny pro každou jazykovou verzi,která obdržela překlad.Celá operace je atomická pro každou jazykovou verzi: buď je překlad prodanou jazykovou verzi plně uložen a označen jako aktuální, nebo se nicpro tuto jazykovou verzi neuloží a řádek si ponechá svůj předchozí stav (chybějícínebo starý-zastaralý), takže další spuštění jej může zkusit znovu. Částečné zápisy jsounemožné.Length ratio and language safety
Krok ověřování odpovědi odmítá dva běžné režimy selhání, kteréby jinak vedly k tichým špatným datům:- Prázdný překlad — model vrátil název, ale žádný obsahpro zdroj, který měl podstatný obsah. Historicky to bylapříčina překladů "pouze názvů" v korpusu anejškodlivější režim selhání, protože vypadá úspěšně.- Extrémní nesoulad délky — přeložený obsah je buďméně než 30 % nebo více než 300 % zdroje (měřeno vbajtech UTF-8, takže cíle CJK jsou porovnávány spravedlivě). Obvyklenaznačuje zkrácení, halucinaci nebo odmítnutí překladu.Oba spustí odmítnutí, běh se přesune na další model, a pokudvšechny modely selžou, cílová jazyková verze zůstane nedotčena.Source-echo detection
Pokud model vrátí text, který je bajtově identický se zdrojem,platforma odmítne odpověď jako případ "odmítl přeložit". Tose týká hlavně jazyků, které sdílejí abecedu zdroje —slovenský překlad, který je náhodou identický s českým zdrojem,protože model ve skutečnosti nepřeložil.Pod velmi krátkými zdroji (asi jeden odstavec) se kontrola přeskočí— triviálně krátký obsah může být legitimně identický (názvy produktů,těla pouze s<img>, jednoslovné názvy).Editing behaviour and staleness
V okamžiku, kdy uložíte jakoukoli změnu článku v primární jazykové verzi,platforma zaznamená nový snímek zdroje a každý stávajícípřeklad se stane zastaralým. Sekce Překlady v postranním panelu článkuzobrazuje jantarové odznaky pro každou dotčenou jazykovou verzi a tlačítkoautomatického překladu se znovu objeví.Vy určujete, kdy se má překlad znovu vygenerovat. Zastaralé odznaky jsou signálem,nikoli spouštěčem — nic se neděje automaticky. Dva důvody pro to:- Kontrola nákladů — každý překladový hovor využívá AI kredity. Můžetaupravit článek pětkrát v jedné editační relaci a chcetevygenerovat překlad jednou na konci, ne pětkrát.- Redakční uvážení — některé úpravy jsou drobné (opravy překlepů) astávající překlady jsou stále v pořádku, aby zůstaly tak, jak jsou, dokuddojde k další velké aktualizaci.Nicméně doporučený výchozí pracovní postup je: upravit, uložit, kliknoutna automatický překlad na konci relace. Pro hromadné případy napříč mnohačlánky použijte nástroje na kartě Překlady (viz níže).The Translations tab
Karta Překlady na/post je operátorským panelem prozraví vícejazyčného obsahu v celé organizaci. Otevírá ses přehledovou kartou, třemi souhrnnými počítadly, tabulkou pokrytídle jazykové verze a diagnostickým panelem.Header
Zobrazuje primární jazykovou verzi organizace (označenou hvězdičkou),úplný seznam povolených jazykových verzí jako barevné odznaky a celkovýpočet živých příspěvků. Toto je váš kontext na první pohled — nežse podíváte na čísla, víte, co by znamenalo "100 %".Aggregate cards
Tři barevné karty shrnují, kolik článků je v každém stavu,s procentem z celkového počtu:- Plně přeloženo (zelená) — každá jiná než zdrojová jazyková verze je aktuální.- Částečně přeloženo (jantarová) — alespoň jedna jazyková verze je aktuálnía alespoň jedna chybí, je zastaralá nebo podezřele krátká.- Nepřeloženo (růžová) — v žádné jiné než zdrojovéjazykové verzi neexistuje překlad.Pro organizaci s jednou jazykovou verzí se každý článek počítá jako plněpřeložený (není co překládat).Per-locale coverage table
Jeden řádek pro každou povolenou jazykovou verzi, zobrazující:| Column | What it counts |
|---|---|
| Jazyková verze | Kód jazykové verze, s hvězdičkou pro zdrojovou jazykovou verzi. |
| Aktuální (Fresh) | Překlady synchronizované s aktuálním snímkem zdroje. |
| Zastaralý (Stale) | Překlady, které existují, ale odkazují na starší snímek zdroje. |
| Chybějící (Missing) | Články bez překladu v této jazykové verzi. |
| Krátký (Short) | Diagnostika: překlady, jejichž obsah je pod 30 % délky zdroje (pravděpodobné zkrácení). Překrývá se s aktuálními/zastaralými — nepočítá se dvakrát. |
| S | Celkový počet článků, které mají řádek v této jazykové verzi (aktuální + zastaralé + krátké). |
| Trasy | Kanonické URL adresy článků směřující na tuto jazykovou verzi. |
| Osiřelé trasy | Kanonické trasy, jejichž odkazovaný překlad byl smazán — trasa přežila, ale obsah zmizel. |
Tooling bar
Horizontální panel akcí na jedno kliknutí, z nichž každá otevřeadministrační terminál a streamuje výstup příkazu živě:- Zobrazit přehled — vypíše každý článek se stavem podle jazykav tabulkovém zobrazení. Žádné zápisy.- Zobrazit chybějící — vypíše články, kterým zcela chybíkaždá jiná než zdrojová jazyková verze.- Zobrazit poškozené — vypíše články s jakoukoli jazykovou verzí, která není vaktuálním stavu (chybí, je zastaralá nebo krátká). Širší než "chybějící".- Přeložit chybějící — regeneruje překlady pouze prozcela chybějící jazykové verze. Přeskočí zastaralé a krátké řádky. Nejrychlejší,nejlevnější.- Přeložit všechny poškozené — regeneruje překlady pro každouchybějící, zastaralou nebo krátkou jazykovou verzi u každého článku. Delší a dražší;použijte pro úplnou aktualizaci.- Opravit trasy — vytváří kanonické URL adresy pro existující překlady,které ji ještě nemají. Žádné volání AI, levné.- Obnovit statistiky — zneplatní cache panelu aznovu načte čísla.Každá akce se provádí jako streamovací příkaz v panelu administračního terminálu— vidíte průběh v reálném čase, počítadla pro jednotlivé články a jazykové verzeseskupují, jak probíhá práce, chyby se okamžitě zobrazují apanel můžete nechat otevřený ke sledování nebo jej zavřít a nechatpříkaz běžet na pozadí.Diagnostics section
Rozbalitelný panel pod tabulkou zobrazuje podrobnější metriky:- Příspěvky s historií verzí vs bez (staré) — kolikčlánků má alespoň jeden zaznamenaný snímek. Staré článkybez jakéhokoli snímku nemohou mít své překlady označeny jako zastaralé(není s čím srovnávat). Spuštění jakékoli překladovéakce jednou na takovém článku vytvoří snímek a umožní detekci zastaralostido budoucna.- Průměrný počet verzí na příspěvek — ukazatel stavu editačníaktivity.- Celkový počet osiřelých kanonických tras — je bezpečné je ponechat, alezabírají URL slugy, které nové články nemohou znovu použít. Odstraňtepřeklady, které již nechcete, a poté trasu buď znovu vytvořte, neboponechte pro přesměrování.- Podezřele krátké překlady — součet z "Krátkého"sloupce napříč všemi jazykovými verzemi. Nenulová hodnota obvykle znamená, žeřada hromadných překladů selhala v polovině; "Translate all broken"to vyřeší.Terminal tooling
Vše, co dělá karta Překlady, lze také ovládat ručněz administračního terminálu. Terminálový příkaz jepost sněkolika podřízenými příkazy:post list [filter]
Vypíše tabulku každého článku s glyfy stavu podle jazykové verze:- ★ — zdrojová jazyková verze (původní jazyk tohoto článku)- ✓ — aktuální překlad- ↻ — zastaralý (zdroj upraven od překladu)- ◐ — částečný (pouze název nebo obsah dramaticky kratší nežzdroj)- ✗ — chybějící (žádný řádek překladu)Volitelný filtr zužuje výstup:- all (výchozí) — každý článek.- missing — články, kterým chybí každá jiná než zdrojová jazyková verze.- partial — články s jakoukoli částečnou jazykovou verzí (dle délky).- stale — články s jakoukoli zastaralou jazykovou verzí.- broken — sjednocení chybějících + částečných + zastaralých (cokoli, co není plněpřeloženo).- ok nebo translated — pouze plně přeloženo.V horní části výstupu je souhrnný řádek: 📊 X posts — ✓ Ntranslated · ◐ N partial · ✗ N missing. Níže je tabulka článkůa na konci legenda a nápověda, když je třeba něcoudělat.post translate [postId] [--missing]
Spustí překladovou pipeline. Bez argumentů zpracuje každouneaktuální jazykovou verzi u každého článku, který potřebuje práci — chybějící,částečné a zastaralé. S --missing se překládají pouzezcela chybějící jazykové verze (nejrychlejší, nejlevnější).S argumentem postId je zpracován pouze tento konkrétní článek.Užitečné pro cílení na jeden článek pro jednorázovou aktualizaci.Příkaz streamuje průběh živě. Pro každý článek a každoucílovou jazykovou verzi uvidíte:- Plán (který režim: nový překlad, aktualizace, oprava pouze obsahu,oprava pouze názvu).- Náznak velikosti datové zátěže a očekávané trvání.- Tlukot srdce každých pět sekund, zatímco AI generuje,takže pomalá odezva nevypadá jako zamrzlá.- Potvrzení úspěchu s konečným názvem, délkou obsahua uplynulým časem.- V případě selhání chybovou zprávu a který model v řetězci bylzodpovědný.Souhrnná tabulka na konci uvádí každý dotčený článek, zda bylvýsledek v pořádku nebo částečný a které jazykové verze uspěly nebo selhaly.post fix-routes [postId]
Vytváří kanonické trasy pro existující překlady, které ji ještě nemají.Idempotentní — existující trasy jsou ponechány beze změny. Žádné volání AI, takžeoperace je téměř zdarma.Použijte, když:- Importovali jste překlady z externího systému a byly vytvořeny pouzěřádky obsahu, nikoli trasy.- Předchozí překladový běh havaroval po uložení obsahu, alepřed vytvořením trasy.- Trasa byla omylem smazána.Bez argumentů zpracovává každý článek. S postId jsou vytvořeny pouzechybějící trasy tohoto článku.Combining commands
Typická relace hromadné aktualizace vypadá takto:bash post list broken # zobrazit, co je třeba opravit post translate --missing # levný první průchod post list broken # zobrazit, co zbývá post translate # pokrýt částečné a zastaralé post fix-routes # zajistit, aby každý překlad měl URLVšechny tyto akce lze také ovládat z tlačítek na kartě Překladybez psaní.