Crowdin jako zdroj pro měření
Shromažďujte v Radaru údaje o překladatelské aktivitě v Crowdin a pomocí definovaných měření zkoumejte text i proces jeho úprav.
Dál vytvářejte a kontrolujte překlady v Crowdin a jejich kvalitu zkoumejte pomocí Lingo.dev. Připojení ke Crowdin přijímá podporované události na úrovni řetězců a zpřístupňuje jejich text jako podklady pro měření v Radaru. Vaše překlady i publikační workflow zůstávají v Crowdin.
V navigaci Studio 2.5 přejděte do Studio 2.5 → Integrace místo Nastavení → Integrace. Stávající odkazy na připojení a nastavení fungují i nadále.
Změna zdrojového textu, nový návrh, schválení a aktualizace exportovaného cílového textu zachycují různé části práce. Připojení mezi nimi zachovává rozdíly, aby každé měření mohlo zkoumat právě ten text nebo tu změnu, které potřebuje. Překlady nevytváří ani neposílá opravené znění zpět do Crowdin.
Připojte zdroj #
- V příslušné organizaci Lingo.dev otevřete Nastavení → Integrace a u Crowdin vyberte Připojit. Pokud tato možnost není dostupná, ověřte, zda má organizace k funkci přístup.
- Zadejte Název připojení. Pro crowdin.com ponechte pole Doména Enterprise prázdné. Pro Crowdin Enterprise zadejte část před
.crowdin.com, napříkladacme, a poté vyberte Připojit. - Zkopírujte poskytnutou URL webhooku. V každém projektu Crowdin, který chcete měřit, otevřete Nástroje → Webhooky a přidejte webhook s touto URL, metodou POST a daty ve formátu JSON. Vyberte níže uvedené podporované události na úrovni řetězců.
S URL webhooku zacházejte jako s přihlašovacím údajem: příjemce používá tajný údaj v URL k autorizaci příchozích událostí. Nevkládejte ji do tiketů ani do souborů v repozitáři. Jedno připojení organizace může přijímat události z více projektů; každá událost nese identifikaci svého projektu. Poznamenejte si, které projekty jste nakonfigurovali, abyste věděli, co pozdější přehled zahrnuje.
Vyberte potřebné události na úrovni řetězců #
V Crowdin nastavte odběr podporovaných událostí na úrovni řetězců:
| Události Crowdin | Poskytované podklady |
|---|---|
string.added, string.updated, string.deleted | Aktivita související se zdrojovým řetězcem. |
suggestion.added, suggestion.updated, suggestion.deleted | Aktivita související s navrženým překladem. |
suggestion.approved, suggestion.disapproved | Akce při kontrole návrhu. |
translation.updated | Změna mezi původním a novým exportovaným cílovým textem. |
U exportovaného překladu znamená prázdná původní hodnota a vyplněná nová hodnota vytvoření. Dvě vyplněné hodnoty znamenají aktualizaci; vyplněná původní hodnota a prázdná nová hodnota znamenají odstranění. Schválení návrhu je samostatná událost, odlišná od změny exportovaného cílového textu.
Události na úrovni souborů, například file.approved a file.translated, tento adaptér nepřevádí na podklady na úrovni řetězců. Nepodporované typy událostí a události bez identifikace projektu nebo řetězce mohou být přeskočeny. Pro první ověření použijte podporovanou událost na úrovni řetězce. Samotné úspěšné doručení webhooku ještě nedokazuje, že vznikly použitelné podklady.
Sledujte jednu změnu překladu až k měření #
Pro první test použijte vestavěné měření editační vzdálenosti. Spouští se při vytvoření a aktualizaci cílového textu a porovnává nový cílový text s předchozím překladem řetězce. Než provedete testovací aktivitu, zapněte měření v Radaru.
- Vyberte známý projekt, řetězec a cílový jazyk, ve kterém už překlad existuje. Poznamenejte si tento překlad i text, který budete schvalovat.
- Schvalte upravený návrh v běžném workflow kontroly v Crowdin a zkontrolujte doručení události
translation.updatedna nakonfigurovaný webhook. - V Lingo.dev najděte odpovídající událost cílového textu. Porovnejte její projekt, čitelný klíč, jazyk a cílový text s poznamenanou dvojicí textů. Pokud měření používá jiný předchozí překlad, než se kterým jste chtěli porovnávat, zkontrolujte dřívější události řetězce, než začnete hodnotu vzdálenosti interpretovat.
- Otevřete výsledek měření editační vzdálenosti. Ověřte definici, porovnávané texty a výslednou číselnou odpověď dokončeného měření. Referenční dokumentace vestavěných měření vysvětluje jmenovatel výpočtu i omezení týkající se znakových jednotek.
Tento test propojí jednu akci u poskytovatele s odpovědí, kterou budete později interpretovat. První překlad řetězce nemá předchozí verzi, takže pro něj měření editační vzdálenosti vrátí 0. Samotné schválení se zaznamená jako suggestion.approved a nespouští žádné měření úprav. Vestavěné kontroly glosáře a pravidel zpracovávají události dokončené lokalizace, nikoli úpravy nebo schválení v Crowdin. Chcete-li měřit jiný typ události, nakonfigurujte vlastní měření přímo pro tuto událost a její dostupné podklady; spouštěče vestavěných měření nelze změnit.
Časová razítka událostí a údaje o identitě pomáhají přiřadit záznam k jeho zdroji, jejich význam ale závisí na dané aktivitě. Události související s překlady a návrhy, včetně schválení, používají createdAt překladu; schválení přijaté dnes se tak může zobrazit pod starším datem vytvoření. Čas přijetí rozlišuje opakovaná zamítnutí téhož návrhu a nahrazuje chybějící nebo neplatná časová razítka; schválení se zaznamenává u každého návrhu pouze jednou. Při filtrování Událostí nebo výběru historického období měření zkontrolujte zaznamenanou hodnotu eventAt. Při pozdější extrakci textu nelze bez časového razítka spolehlivě znovu přiřadit každou událost. Ani chybějící údaj o autorství není důvodem k tomu, aby byla událost bez důkazů připsána člověku nebo modelu.
Posuzujte výsledky s ohledem na jejich pokrytí #
Webhooky shromažďují nakonfigurovanou aktivitu od okamžiku jejího doručení. Nedokládají všechny dřívější překlady, revize zdrojového textu ani historii projektu. Chybějící text v datech události, nepodporované události i nenakonfigurované projekty mohou omezit rozsah podkladů dostupných pro měření. Opakované doručení akcí kontroly může vytvářet samostatné záznamy podkladů, takže počet událostí nemusí odpovídat počtu jedinečných zkontrolovaných překladů.
Oddělujte záznamy, na které se kritérium nevztahuje, od těch, na které se vztahuje, ale chybí jim potřebný text. U vyhodnocení rozlišujte dokončené odpovědi, dokončené odpovědi s neurčitým výsledkem a práci bez dokončené odpovědi. Odpověď s neurčitým výsledkem dokládá dokončené vyhodnocení, ale nepotvrzuje ani splnění, ani nesplnění kritéria.
Při vykazování míry úspěšnosti použijte jako jmenovatel počet odpovědí s jednoznačným výsledkem a uveďte, jaká část obsahu splňujícího podmínky pro vyhodnocení takovou odpověď získala. Chybějící vyhodnocení nedokládá nízkou kvalitu překladu. Schválení v Crowdin vypovídá o procesu kontroly v daném projektu, samo o sobě však není nezávislým důkazem významové správnosti. Výpočet a interpretaci podrobněji rozebírá dokument Návrh měření kvality překladu.
Opravte doručování nebo vyřaďte zdroj #
Pokud se podklady přestanou objevovat, zkontrolujte odběry událostí webhooku v projektu, typ události, chyby doručení a cílovou URL. Ověřte, že webhook odesílá požadavky POST s daty ve formátu JSON na aktuální URL webhooku připojení. Připojení zmeškané události automaticky nedoplňuje. K vyhodnocení událostí, které už jsou shromážděné v Lingo.dev, použijte workflow historického měření.
Pokud dojde k vyzrazení URL webhooku nebo ji potřebujete nahradit, otevřete připojení v Nastavení → Integrace, vyberte Obměnit a potvrďte volbou Obměnit URL. Původní URL okamžitě přestane fungovat. Zkopírujte novou URL do každého nakonfigurovaného projektu Crowdin a poté ověřte doručení podporované události i jejích podkladů v Radaru.
Odpojení zastaví příjem nových podkladů z připojení; zaznamenaná měření zůstanou zachována. Webhooky v projektech Crowdin odstraňte samostatně. Překlady ani akce kontroly v Crowdin se nezmění. U přehledů zahrnujících okamžik odpojení zohledněte období bez sběru dat a nevykládejte ho jako období bez překladatelské práce.