Tipi di file
-
.MD
-
.MARKDOWN
-
.MDX
Importa opzioni
-
Scegli quale dialetto Markdown utilizza il parser durante l'importazione del file. Ciò influisce anche sui caratteri per i quali viene aggiunto o rimosso automaticamente l'escape durante l'importazione e l'esportazione.
-
Analizza solo la struttura Markdown di base (titoli, paragrafi, elenchi e formattazione di base per l'enfasi).
-
Analizza utilizzando il dialetto PHP Markdown Extra / Python-Markdown "Extra", aggiungendo il supporto per tabelle, elenchi di definizioni, note a piè di pagina, abbreviazioni ed elenchi di attributi.
-
Analizza utilizzando la specifica GitHub Flavored Markdown (GFM), aggiungendo il supporto per tabelle, elenchi di attività, barrato e collegamenti automatici.
-
Analizza il file come MDX: Markdown più componenti JSX, espressioni JSX (
{...}) e istruzioniimport/exportESM. Tabelle, elenchi di attività, barrato e collegamenti automatici funzionano come in GitHub Flavored Markdown. I blocchi di codice rientrati e i collegamenti automatici tra parentesi angolari (<url>) non sono supportati, poiché MDX utilizza il rientro per annidare i componenti e non analizza tali costrutti.MDX è Markdown esteso con JSX, quindi il contenuto può incorporare componenti ed espressioni JavaScript (ad esempio, nella documentazione creata con Docusaurus o Next.js). Il filtro MDX non viene mai selezionato automaticamente: deve essere selezionato nelle impostazioni di importazione del file, sia per i file .MDX che per i file .MD che contengono sintassi MDX. Il filtro non viene rilevato in base all'estensione o al contenuto del file.
Nota
Il supporto MDX deve essere abilitato per la tua organizzazione. Se MDX non è disponibile nell'elenco , contatta il tuo Customer Success Manager o il supporto Phrase.
Importante
Il passaggio di un progetto esistente da un altro filtro Markdown a MDX modifica il modo in cui il contenuto viene segmentato. Dopo il passaggio, aspettati una riduzione una tantum del riutilizzo delle traduzioni dalla memoria di traduzione.
-
-
Avvia un nuovo segmento a ogni interruzione di riga forzata.
-
Mantiene la stessa struttura degli spazi nel documento di arrivo (ad esempio spaziatura, interruzioni di riga, ecc.).
-
Elabora il front matter YAML all'inizio del file. Quando selezionato, vengono applicate le impostazioni di importazione .YAML.
-
Estrae il contenuto dei blocchi di codice per la traduzione. Con il filtro MDX, questo vale anche per i blocchi di codice delimitati annidati nei componenti JSX (ad esempio, all'interno di
<CodeGroup>). -
Quando questa opzione è selezionata, gli elementi codice vengono importati come singoli tag di Phrase TMS.
-
Rende gli URL disponibili per la traduzione.
-
Applica espressioni regolari per convertire il testo specificato in tag.
Importante
I problemi con i tag sono una causa comune di errori di esportazione. Assicurati sempre che i tag e la formattazione siano corretti prima di esportare i file eseguendo controlli di qualità.
-
Definisci gli elementi nel file da convertire in tag.
-
Definisci le sezioni nel file che non devono essere importate.
Esempio:
Nome elemento:
notrans.Codice:
<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.Risultato: Chrysler は、1985年に工場で準備された3台の Dodge Shadows に参加しました。3台の車両はすべて3日間の Olympus ラリーの初日にリタイアしました。
-
Un elenco di caratteri che non dovrebbero essere preceduti da escape nel file completato (ad esempio,
#,-,[,<,\,`,.Con il filtro MDX, sia
<che{vengono preceduti da escape per impostazione predefinita nel testo tradotto, poiché un<o{senza escape nel testo di destinazione interromperebbe altrimenti la sintassi MDX. Aggiungili qui solo se nell'output è necessario usare il carattere originale senza escape.
Opzioni specifiche per MDX
Le seguenti quattro opzioni sono disponibili solo quando MDX è selezionato in .
-
Definisci coppie tag/attributo JSX aggiuntive per renderle traducibili, utilizzando lo stesso formato
tag/attributedell'impostazione del filtro HTML. Ad esempio,Figure/titletraduce l'attributotitlesolo sul componenteFigure, mentretitle(senza ambito) lo traduce su ogni tag.I componenti personalizzati (nomi di tag che iniziano con una lettera maiuscola, come
<Figure>) non hanno attributi traducibili per impostazione predefinita, quindi elencali qui esplicitamente. I tag con nomi in minuscolo/in stile HTML (<img>,<a>, ecc.) hanno già attributi predefiniti standard. -
Abilitato per impostazione predefinita.
Applica gli attributi traducibili standard predefiniti di HTML (ad esempio,
altsu<img>,titlesu<a>) ai tag con nomi in minuscolo o in stile HTML, oltre a quelli elencati in . I componenti personalizzati non ricevono mai queste impostazioni predefinite, indipendentemente da questa impostazione. I loro attributi sono traducibili solo se vengono aggiunti a .Quando l'impostazione è disabilitata, solo gli attributi elencati in sono traducibili, anche nei tag con nomi in minuscolo.
-
Abilitato per impostazione predefinita.
Imposta se il testo all'interno di un componente JSX è traducibile per impostazione predefinita.
-
Quando l'impostazione è abilitata: Il testo all'interno di qualsiasi componente (ad esempio,
<Tabs>,<Note>) è traducibile, a meno che il componente non sia elencato in . -
Quando l'impostazione è disabilitata: Il testo all'interno dei componenti non è traducibile, a meno che il componente non sia elencato in .
-
-
Un elenco di nomi di componenti separati da virgole ai quali si applica il comportamento opposto a quello definito dall'impostazione .
Per i componenti elencati qui, la modifica si applica all'intero componente: tutto il contenuto, compresi i componenti annidati, segue questa regola senza essere valutato singolarmente. Quando l'eccezione rende un componente non traducibile, il suo contenuto viene mantenuto esattamente come è stato scritto. Usa questo elenco per:
-
escludere alcuni componenti non discorsivi (ad esempio,
CodeGroup,Mermaid) quando è abilitato, oppure -
consentire la traduzione di alcuni componenti che contengono testo discorsivo quando l'impostazione è disabilitata.
-
Come viene gestito il contenuto JSX
Questo si applica quando MDX è selezionato in .
-
I tag JSX (
<Component>,<Component attr="value" />) e i nomi di tag e attributi non sono mai traducibili. Solo il contenuto dell'elemento e i valori degli attributi configurati esplicitamente sono traducibili. -
Le espressioni tra parentesi graffe (
{...}), le espressioni JavaScript, gli attributi spread ({...props}) e i commenti ({/* comment */}) non sono mai traducibili. Vengono conservati esattamente come sono scritti, ovunque compaiano: negli attributi, all'interno del testo o su una riga a sé. -
Le istruzioni
importeexportsono sempre escluse dalla traduzione, ovunque appaiano nel file.