Markdoc

Překládejte text v Markdocu a vybrané řetězcové atributy se zachováním anotací, proměnných a kódu.

Anotace v Markdocu propojují text dokumentu s vlastními komponentami a proměnnými. Modul pro zpracování souborů markdoc překládá podporovaný text a vybrané atributy tagů s řetězcovými hodnotami. Přitom zachovává anotace, které váš renderer potřebuje.

Vyberte viditelné vlastnosti tagů #

Dokument může kombinovat viditelná metadata, pevný identifikátor rozvržení a zvýrazněný blok:

markdown
---
title: Delivery options
description: Understand the available delivery methods.
layout: article
---

{% callout title="Delivery deadline" type="warning" %}
Confirm your address before checkout.
{% /callout %}

Odstavec i položky title a description v metadatech frontmatter, které jsou ve výchozím nastavení vybrané, tvoří textový obsah. Atribut title tagu se zařadí k překladu, pokud jej vybere pravidlo pro vlastnosti. type="warning" a layout: article jsou strukturní identifikátory; nevybírejte je, pokud kód, který je zpracovává, výslovně neočekává přeložené hodnoty.

Pravidla mohou vybírat vlastnost daného názvu u všech tagů nebo výběr omezit na konkrétní tagy. Pokud různé tagy používají stejný atribut k různým účelům, dejte přednost omezenému výběru. Číselné a logické atributy, atributy odvozené z proměnných ani jiné neřetězcové atributy se nepovažují za jednotky přímo zapsaného textu.

Co zůstává chráněno #

Ohraničené bloky kódu ani kód vložený do textu se nepřekládají. Cíle odkazů zůstávají zachovány, zatímco jejich popisky se mohou měnit. Vložené anotace a obrázky jsou v okolním textu chráněnými konstrukcemi. Názvy tagů a nevybrané atributy zůstávají v dokumentu. Modul escapuje přeložené řetězcové atributy podle pravidel Markdocu pro zápis v uvozovkách, nenahrazuje tím ale schéma vlastních tagů vašeho rendereru.

Položky title a description v metadatech frontmatter jsou ve výchozím nastavení vybrané. Prázdný výběr položek frontmatter je ponechá beze změny. Výběr mapy nebo sekvence zahrnuje i její skalární potomky. Pokud musí sousední pole pro směrování nebo ID obsahu zůstat beze změny, volte přesné cesty, například seo.title.

Zachovejte soulad zdroje a překladu #

Při rekonstrukci se nahrazují textové úseky v aktuálním zdroji a lze znovu použít formulace z předchozího zdroje a odpovídajícího překladu. Pokud jejich chráněné vložené struktury nelze bezpečně spárovat, opětovné použití může selhat. Uchovávejte revizi zdroje, ke které patřil přijatý překlad, zejména po přesunutí tagů nebo změně odkazů.

Nepředpokládejte, že se pro dokument .md obsahující anotace Markdoc automaticky vybere tento modul. CLI pro .md rozpozná formát Markdown; pokud jazyk dokumentu vyžaduje zpracování podle pravidel Markdocu, vyberte formát explicitně.

Nastavte překlad Markdocu #

CLI z .mdoc automaticky odvodí formát markdoc; omezení rozsahu podle klíčů není k dispozici. K nastavení metadat frontmatter, výběru vlastností tagů a cílového rozvržení použijte konfiguraci CLI, pro workflow repozitáře pak GitHub.

Ověřte výsledek podle schématu webu #

Modul pro zpracování souborů nenastavuje směrování ve frameworku, načítání obsahu ani transformace Markdocu ve vaší aplikaci. Po stažení cílový dokument parsujte a vykreslete se stejnými schématy jako zdroj. Spolu s přeloženými odstavci zkontrolujte také viditelné atributy, cíle odkazů, proměnné a vybraná metadata frontmatter.