Typy souborů
-
.MD
-
.MARKDOWN
-
.MDX
Možnosti importu
-
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.
-
Analyzuje pouze základní strukturu Markdownu (nadpisy, odstavce, seznamy, základní zvýraznění).
-
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ů.
-
Analyzuje pomocí specifikace GitHub Flavored Markdown (GFM), která přidává podporu pro tabulky, seznamy úkolů, přeškrtnutí a automatické odkazy.
-
Analyzuje soubor jako MDX: Markdown plus komponenty JSX, výrazy JSX (
{...}) a příkazy ESMimport/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 , 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.
-
-
Při každém vynuceném zalomení řádku začíná nový segment.
-
Zachovává v cílovém dokumentu stejnou strukturu bílých znaků (např. mezery, zalomení řádků atd.).
-
Zpracovává YAML front matter v horní části souboru. Je-li tato možnost vybrána, použije se nastavení importu .YAML.
-
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>). -
Pokud je tato volba vybrána, elementy kódu se naimportují jako tagy Phrase TMS.
-
Zpřístupňuje adresy URL pro překlad.
-
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.
-
Definujte elementy v souboru, které mají být převedeny na tagy.
-
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 ラリーの初日にリタイアしました。
-
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 vybráno MDX.
-
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í filtru HTML. NapříkladFigure/titlepřeloží atributtitlepouze u komponentyFigure, zatímcotitle(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. -
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í vztahují také standardní výchozí pravidla pro přeložitelné atributy HTML (například
altu<img>atitleu<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 .Při vypnutí jsou přeložitelné pouze atributy uvedené v , a to i u tagů s názvy psanými malými písmeny.
-
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 . -
Při vypnutí: Text uvnitř komponent není přeložitelný, pokud komponenta není uvedena v .
-
-
Čárkami oddělený seznam názvů komponent, u kterých se použije opačné chování, než určuje nastavení .
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í , 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í 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
importaexportjsou vždy vyloučeny z překladu, ať se v souboru objeví kdekoli.