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:

json
{
  "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í.