Nastavení importu souborů

.MD / .MDX – Markdown a MDX (TMS)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Typy souborů

  • .MD

  • .MARKDOWN

  • .MDX

Možnosti importu

  • Filtrovat 

    Vyberte, který dialekt Markdownu má parser při importu souboru použít. To také ovlivňuje, které znaky se při importu a exportu automaticky escapují a u kterých se escapování odstraňuje.

    • Prostý

      Analyzuje pouze základní strukturu Markdownu (nadpisy, odstavce, seznamy, základní zvýraznění).

    • PHP/Python Markdown Extra

      Analyzuje pomocí dialektu PHP Markdown Extra / Python-Markdown „Extra“, který přidává podporu pro tabulky, definiční seznamy, poznámky pod čarou, zkratky a seznamy atributů.

    • GitHub Flavored Markdown

      Analyzuje pomocí specifikace GitHub Flavored Markdown (GFM), která přidává podporu pro tabulky, seznamy úkolů, přeškrtnutí a automatické odkazy.

    • MDX

      Analyzuje soubor jako MDX: Markdown plus komponenty JSX, výrazy JSX ({...}) a příkazy ESM import/export. Tabulky, seznamy úkolů, přeškrtnutí a automatické odkazy fungují stejně jako v GitHub Flavored Markdown. Odsazené bloky kódu a automatické odkazy v lomených závorkách (<url>) nejsou podporovány, protože MDX používá odsazení k vnoření komponent a tyto konstrukce neanalyzuje.

      MDX je Markdown rozšířený o JSX, takže do obsahu lze vkládat komponenty a výrazy JavaScriptu (například v dokumentaci vytvořené pomocí Docusaurus nebo Next.js). Filtr MDX není nikdy vybrán automaticky: musí být vybrán v nastavení importu souboru, a to jak pro soubory .MDX, tak pro soubory .MD, které obsahují syntaxi MDX. K detekci podle přípony souboru nebo obsahu nedochází.

      Poznámka

      Podpora MDX musí být pro vaši organizaci povolena. Pokud MDX není k dispozici v seznamu Filtr, obraťte se na svého Customer Success Managera nebo na podporu Phrase.

      Důležité

      Přepnutí stávajícího projektu z jiného filtru Markdown na MDX změní způsob segmentace obsahu. Po přepnutí očekávejte jednorázový pokles využití překladové paměti.

  • Rozdělit segment na místě znaku pro konec řádku 

    Při každém vynuceném zalomení řádku začíná nový segment.

  • Zachovat bílé znaky 

    Zachovává v cílovém dokumentu stejnou strukturu bílých znaků (např. mezery, zalomení řádků atd.).

  • Zpracovat hlavičku YAML 

    Zpracovává YAML front matter v horní části souboru. Je-li tato možnost vybrána, použije se nastavení importu .YAML.

  • Importovat bloky kódu 

    Extrahuje obsah bloků kódu pro překlad. S filtrem MDX se toto vztahuje také na ohraničené bloky kódu vnořené do komponent JSX (například uvnitř <CodeGroup>).

  • Vyloučit elementy kódu 

    Pokud je tato volba vybrána, elementy kódu se naimportují jako tagy Phrase TMS.

  • Povolit překlad URL

    Zpřístupňuje adresy URL pro překlad.

  • Převést na tagy Phrase TMS 

    Použijte regulární výrazy a převeďte zadaný text na tagy.

    Důležité

    Problémy s tagy jsou častou příčinou chyb při exportu. Před exportem souborů vždy zajistěte správnost tagů a formátování spuštěním kontrol zajištění kvality.

  • Vlastní elementy (převedené na tagy Phrase) 

    Definujte elementy v souboru, které mají být převedeny na tagy.

  • Bloky nepřekládaného textu 

    Definujte sekce v souboru, které by neměly být importovány.

    Příklad:

    Název elementu: notrans.

    Kód: <notrans>Chrysler</notrans> entered three factory-prepared <notrans>Dodge Shadows</notrans> to the event in 1985. All three vehicles retired in the first day of the three-day <notrans>Olympus</notrans> rally.

    Výsledek: Chrysler は、1985年に工場で準備された3台の Dodge Shadows に参加しました。3台の車両はすべて3日間の Olympus ラリーの初日にリタイアしました。

  • Nepřidávat zpětné lomítko před znaky 

    Seznam znaků, které by neměly být v dokončeném souboru escapovány (například #, -, [, <, \, `, ![, ](, :).

    S filtrem MDX jsou ve výchozím nastavení v přeloženém textu escapovány jak <, tak {, protože neescapovaný znak < nebo { v cílovém textu by jinak narušil syntaxi MDX. Přidejte je sem pouze v případě, že je ve výstupu výslovně vyžadován nezpracovaný, neescapovaný znak.

Možnosti specifické pro MDX

Následující čtyři možnosti jsou dostupné pouze tehdy, je-li v Filtr vybráno MDX.

  • Přeložitelné atributy

    Definujte další páry tagů a atributů JSX, které mají být přeložitelné, ve stejném formátu tag/attribute, jaký používá nastavení Translatable attributes filtru HTML. Například Figure/title přeloží atribut title pouze u komponenty Figure, zatímco title (bez určení rozsahu) jej přeloží u každého tagu.

    Vlastní komponenty (názvy tagů začínající velkým písmenem, jako např. <Figure>) nemají ve výchozím nastavení žádné přeložitelné atributy, proto je zde explicitně uveďte. Tagy s názvy psanými malými písmeny / ve stylu HTML (<img>, <a> atd.) již mají standardně nastavené přeložitelné atributy.

  • Importovat výchozí přeložitelné atributy

    Ve výchozím nastavení povoleno.

    Na tagy s názvy psanými malými písmeny / ve stylu HTML se kromě atributů uvedených v nastavení Translatable attributes vztahují také standardní výchozí pravidla pro přeložitelné atributy HTML (například alt u <img> a title u <a>). Na vlastní komponenty se tato výchozí pravidla nikdy nevztahují bez ohledu na toto nastavení. Jejich atributy jsou přeložitelné pouze tehdy, jsou-li přidány do Translatable attributes.

    Při vypnutí jsou přeložitelné pouze atributy uvedené v Translatable attributes, a to i u tagů s názvy psanými malými písmeny.

  • Nastavit prvky jako přeložitelné ve výchozím nastavení

    Ve výchozím nastavení povoleno.

    Nastavuje, zda je text uvnitř komponenty JSX ve výchozím nastavení přeložitelný.

    • Při zapnutí: Text uvnitř jakékoli komponenty (například <Tabs>, <Note>) je přeložitelný, pokud komponenta není uvedena v Elements overriding default translatability.

    • Při vypnutí: Text uvnitř komponent není přeložitelný, pokud komponenta není uvedena v Elements overriding default translatability.

  • Prvky s odlišným nastavením přeložitelnosti

    Čárkami oddělený seznam názvů komponent, u kterých se použije opačné chování, než určuje nastavení Make elements translatable by default.

    Komponenta uvedená zde se přepne jako celek: na veškerý její obsah, včetně všech komponent v ní vnořených, se vztahuje toto přepsání a jednotlivé části se nevyhodnocují samostatně. Pokud se komponenta v důsledku přepsání stane nepřeložitelnou, její obsah se zachová přesně tak, jak je napsán. Tento seznam použijte k tomu, abyste:

    • vyloučili několik komponent, které neobsahují souvislý text (například CodeGroup, Mermaid), když je zapnuté nastavení Make elements translatable by default, nebo

    • pokud je toto nastavení vypnuté, přidejte na seznam povolených položek několik komponent obsahujících souvislý text.

Jak se zachází s obsahem JSX

Toto platí, když je v nastavení Filter vybráno MDX.

  • Značky JSX (<Component>, <Component attr="value" />) a názvy značek a atributů nejsou nikdy přeložitelné. Přeložitelný je pouze obsah elementů a explicitně nakonfigurované hodnoty atributů.

  • Výrazy ve složených závorkách ({...}), výrazy JavaScriptu, atributy s operátorem rozbalení ({...props}) a komentáře ({/* comment */}) nejsou nikdy přeložitelné. Jsou zachovány přesně tak, jak jsou napsány, kdekoli se objeví: v atributech, vložené v textu nebo na vlastním řádku.

  • Příkazy import a export jsou vždy vyloučeny z překladu, ať se v souboru objeví kdekoli.

Byl pro vás tento článek užitečný?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.