Impostazioni per l'importazione del file

.MD / .MDX - Markdown e MDX (TMS)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Tipi di file

  • .MD

  • .MARKDOWN

  • .MDX

Importa opzioni

  • Filtro 

    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.

    • Normale

      Analizza solo la struttura Markdown di base (titoli, paragrafi, elenchi e formattazione di base per l'enfasi).

    • PHP/Python Markdown Extra

      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.

    • GitHub Flavored Markdown

      Analizza utilizzando la specifica GitHub Flavored Markdown (GFM), aggiungendo il supporto per tabelle, elenchi di attività, barrato e collegamenti automatici.

    • MDX

      Analizza il file come MDX: Markdown più componenti JSX, espressioni JSX ({...}) e istruzioni import/export ESM. 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 Filtro, 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.

  • Interruzione di riga crea nuovo segmento 

    Avvia un nuovo segmento a ogni interruzione di riga forzata.

  • Conserva gli spazi 

    Mantiene la stessa struttura degli spazi nel documento di arrivo (ad esempio spaziatura, interruzioni di riga, ecc.).

  • Intestazione di processo YAML 

    Elabora il front matter YAML all'inizio del file. Quando selezionato, vengono applicate le impostazioni di importazione .YAML.

  • Importa blocchi di codice 

    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>).

  • Escludi elementi codice 

    Quando questa opzione è selezionata, gli elementi codice vengono importati come singoli tag di Phrase TMS.

  • Rendi traducibili gli URL

    Rende gli URL disponibili per la traduzione.

  • Converti in tag di Phrase TMS 

    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à.

  • Elementi personalizzati (convertiti in tag Phrase) 

    Definisci gli elementi nel file da convertire in tag.

  • Blocchi non traducibili 

    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 ラリーの初日にリタイアしました。

  • Non usare caratteri di escape 

    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 Filtro.

  • Attributi traducibili

    Definisci coppie tag/attributo JSX aggiuntive per renderle traducibili, utilizzando lo stesso formato tag/attribute dell'impostazione Attributi traducibili del filtro HTML. Ad esempio, Figure/title traduce l'attributo title solo sul componente Figure, mentre title (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.

  • Importa attributi traducibili predefiniti

    Abilitato per impostazione predefinita.

    Applica gli attributi traducibili standard predefiniti di HTML (ad esempio, alt su <img>, title su <a>) ai tag con nomi in minuscolo o in stile HTML, oltre a quelli elencati in Attributi traducibili. I componenti personalizzati non ricevono mai queste impostazioni predefinite, indipendentemente da questa impostazione. I loro attributi sono traducibili solo se vengono aggiunti a Attributi traducibili.

    Quando l'impostazione è disabilitata, solo gli attributi elencati in Attributi traducibili sono traducibili, anche nei tag con nomi in minuscolo.

  • Rendi gli elementi traducibili per impostazione predefinita

    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 Elementi che modificano la traducibilità predefinita.

    • Quando l'impostazione è disabilitata: Il testo all'interno dei componenti non è traducibile, a meno che il componente non sia elencato in Elementi che modificano la traducibilità predefinita.

  • Elementi che sovrascrivono la traducibilità predefinita

    Un elenco di nomi di componenti separati da virgole ai quali si applica il comportamento opposto a quello definito dall'impostazione Rendi gli elementi traducibili per impostazione predefinita.

    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 Rendi gli elementi traducibili per impostazione predefinita è 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 Filtro.

  • 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 import e export sono sempre escluse dalla traduzione, ovunque appaiano nel file.

Questo articolo ti è stato utile?
★ ★ ★ ★ ★

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.