Artefakty obsahu v Payload
Překládejte vybraná pole v Payload CMS a podporovaný text ve formátu Lexical se zachováním struktury potřebné pro zpětný zápis na straně poskytovatele.
Stránka v Payload spojuje čitelný obsah s ID, vztahy, nahranými soubory a strukturou editoru. Integrace nejprve vybere lokalizovaná pole a sestaví z nich artefakt k překladu. Obslužná komponenta payload pak v tomto artefaktu přeloží podporované prosté hodnoty a text ve formátu Lexical.
K výběru obsahu a jeho zpětnému zápisu použijte integraci Payload. Přímým odesláním nefiltrovaného záznamu z CMS obejdete výběr polí na straně poskytovatele a můžete zahrnout i data, která nikdy nebyla určena k překladu.
Vybraná pole a formátovaný text #
Artefakt sestavený z vybraných polí může obsahovat název a strom Lexical:
{
"title": "Delivery options",
"body": {
"root": {
"type": "root",
"children": [
{
"type": "paragraph",
"children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
}
]
}
}
}Název a podporovaný textový obsah jsou určeny k překladu. Typy uzlů Lexical, údaje o formátování a podporovaná struktura vložených prvků slouží jako vodítko při rekonstrukci. Cíle odkazů, nahrané soubory, vztahy ani strukturální pole bloků se nestávají textem k překladu jen proto, že obsahují řetězce. Vybraný lokalizovaný text v podporovaných polích bloků však lze překládat i po filtrování na straně poskytovatele.
Podporované textové úseky ve formátu Lexical si zachovávají formátování i strukturu vložených prvků. U vlastních uzlů je nutné ověřit soulad s podporovanou reprezentací; podpora formátu Lexical se nevztahuje na strom dokumentu libovolného editoru.
Párování zdroje a cíle #
Cesty ke zdrojovým a cílovým polím určují, které hodnoty si odpovídají. Pokud je existující cíl dodán bez předchozího zdroje, obslužná komponenta převezme odpovídající hodnoty, které už jsou v cíli, a přeloží chybějící části. Nepřepíše všechna existující lokalizovaná pole jen proto, že jde o první zaznamenanou synchronizaci.
Pokud je k dispozici předchozí zdroj, je třeba zpracovat změněné zdrojové jednotky a chybějící cílové hodnoty. Existující dokument v CMS může být přeložen jen částečně, takže samotná jeho existence nezaručuje úplnost překladu. Rekonstrukce vychází z vybraného zdrojového artefaktu a vkládá do něj podporované přeložené nebo zachované hodnoty; výsledkem je serializovaný JSON, nikoli zachování původních bajtů zdroje.
Po úpravách je třeba zkontrolovat vzájemné přiřazení zdrojového a cílového formátovaného textu. Změna struktury odstavců nebo vlastní uzel mohou toto přiřazení ovlivnit, i když některá slova zůstanou stejná. Ověřte výsledné pole v CMS i vykreslený obsah, nejen platnost artefaktu.
Propojení výběru se zpětným zápisem #
Integrace Payload zajišťuje výběr schématu, načítání jazykových verzí, nastavení připojení a zpětný zápis. Dokumentace balíčku Payload CMS popisuje exporty pluginu. Zachovejte tyto kroky na straně poskytovatele před zpracováním artefaktu i po něm, aby se vybraná pole zapsala zpět do správného dokumentu a jazyka.
Po zpětném zápisu otevřete lokalizovaný dokument v CMS a zkontrolujte pole s prostým textem i formátovaný text. Ověřte cíle odkazů, zkontrolujte vložené vztahy a porovnejte, zda pole v cíli pokrývají výběr ze zdroje. Rekonstrukce artefaktu neuděluje oprávnění k zápisu na straně poskytovatele ani nerozhoduje o tom, zda je obsah připraven k publikování.