Markdown

Překládejte text dokumentu a vybraná úvodní metadata se zachováním kódu, odkazů a struktury potřebné pro opětovné použití schválených formulací.

Dokument ve formátu Markdown spojuje vysvětlující text se strukturou, která čtenářům usnadňuje orientaci. Modul pro zpracování souborů md překládá text v nadpisech, odstavcích, buňkách tabulek a podporovaných popiscích direktiv. Kód a cíle odkazů přitom chrání před změnami. Výsledek zůstává ve formátu Markdown, takže ho můžete vykreslit stávajícím nástrojem.

Text a chráněná struktura #

Například text odkazu se může změnit, zatímco jeho cíl a název funkce zůstanou beze změny:

markdown
---
title: Delivery options
description: Choose how your order arrives.
slug: delivery
---

## Choose delivery

Read the [delivery policy](/policies/delivery) before calling `confirmOrder()`.

Nadpis, text odstavce a text odkazu tvoří textový obsah. Cíl odkazu a kód na řádku patří do chráněné struktury. V běžném profilu dokumentu se text z bloků kódu ohraničených oddělovači ani ze surového HTML neextrahuje. Pokud je zdrojem dokument HTML, použijte HTML. Pokud jsou součástí jazyka dokumentu vlastní značky Markdoc, použijte Markdoc.

Výběr úvodních metadat #

Ve výchozím nastavení modul pro zpracování souborů vybírá title a description. Ostatní pole zůstávají beze změny, pokud je výslovně nevyberete. Prázdný seznam translateFrontmatterFields překlad úvodních metadat vypne. O výběru polí rozhoduje jejich obsah: titulek určený čtenářům lze přeložit, zatímco slug, identifikátor komponenty nebo směrovací klíč může být nutné ponechat beze změny.

Podporované cesty k polím umožňují vybrat vnořené hodnoty včetně prvků sekvencí. Výběrem mapy nebo sekvence zahrnete i všechny její podřízené skalární hodnoty. Pokud musí sousední směrovací pole zůstat beze změny, zvolte přesnou cestu, například seo.title. Text k překladu vyberte v nastavení úvodních metadat ve zvoleném rozhraní.

Opětovné použití vyžaduje sladěnou strukturu dokumentů #

Modul porovnává textové jednotky s předchozím zdrojem a odpovídajícím překladem a poté vkládá změněné překlady do aktuální struktury zdroje. Stávající formulace lze znovu použít jen tehdy, když je lze jednoznačně přiřadit. Pokud předchozí zdroj a překlad obsahují odlišné chráněné struktury uvnitř textu, může opětovné použití selhat kvůli nesouladu struktur.

Uchovejte revizi zdroje, která odpovídá schválenému znění překladu. Pokud byla struktura překladu upravena nezávisle na zdroji, před vyžádáním přírůstkové aktualizace ji s tímto zdrojem slaďte. Výsledek sestavte pomocí nástroje pro zpracování Markdown na svém webu a ověřte tak konstrukce specifické pro danou variantu Markdown.

Nastavte a vykreslete dokument #

CLI odvodí md z .md. Výběr souborů, pole úvodních metadat a výstupní cesty nastavte v konfiguraci CLI, nebo pro spravovaný překlad repozitáře použijte GitHub. Rozsah klíče CLI není pro Markdown k dispozici.

Výstup vykreslete pomocí nástroje pro zpracování Markdown na svém webu. Přeložená metadata, odkazy, fragmenty nadpisů a příklady kódu zkontrolujte společně. Samotné zachování /policies/delivery danou stránku v jiném jazyce nevytvoří. Průvodce statickým obsahem vysvětluje, jak výstupní cesty propojit s načítáním obsahu webu a cestami pro jednotlivé jazyky.