Configurações de importação de arquivo

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

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Tipos de arquivo

  • .MD

  • .MARKDOWN

  • .MDX

Opções de importar

  • Filtro 

    Escolha qual dialeto Markdown o analisador usa ao importar o arquivo. Isso também afeta quais caracteres são automaticamente escapados/desescapados na importação e exportação.

    • Simples

      Analisa apenas a estrutura básica do Markdown (títulos, parágrafos, listas, ênfase básica).

    • PHP/Python Markdown Extra

      Analisa usando o dialeto "Extra" do PHP Markdown / Python-Markdown, adicionando suporte para tabelas, listas de definição, notas de rodapé, abreviações e listas de atributos.

    • GitHub Flavored Markdown

      Analisa usando a especificação GitHub Flavored Markdown (GFM), adicionando suporte para tabelas, listas de tarefas, tachado e links automáticos.

    • MDX

      Analisa o arquivo como MDX: Markdown mais componentes JSX, expressões JSX ({...}) e declarações ESM import/export. Tabelas, listas de tarefas, tachado e links automáticos funcionam como no GitHub Flavored Markdown. Blocos de código recuados e links automáticos entre sinais angulares (<url>) não são suportados, já que o MDX usa recuo para aninhar componentes e não analisa essas construções.

      MDX é Markdown estendido com JSX, portanto, o conteúdo pode incorporar componentes e expressões JavaScript (por exemplo, em documentação criada com Docusaurus ou Next.js). O filtro MDX nunca é selecionado automaticamente: ele deve ser selecionado nas configurações de importação de arquivo, tanto para arquivos .MDX quanto para arquivos .MD que contenham sintaxe MDX. Não há detecção por extensão de arquivo ou conteúdo.

      Nota

      O suporte a MDX deve estar habilitado para sua organização. Se o MDX não estiver disponível na lista Filtro, entre em contato com seu Gerente de Sucesso do Cliente ou com o Suporte da Phrase.

      Importante

      Mudar um projeto existente de outro filtro Markdown para MDX altera a forma como o conteúdo é segmentado. Espere uma queda pontual no aproveitamento da memória de tradução após a mudança.

  • Uma quebra de linha rígida cria um novo segmento 

    Inicia um novo segmento a cada quebra de linha forçada.

  • Manter os espaços em branco 

    Preserva a mesma estrutura de espaços em branco no documento de destino (por exemplo, espaçamento, quebras de linha etc.).

  • Processar cabeçalho YAML 

    Processa o front matter YAML no topo do arquivo. Quando essa opção é selecionada, as configurações de importação de .YAML são aplicadas.

  • Importar blocos de código 

    Extrai o conteúdo de blocos de código para tradução. Com o filtro MDX, isso também se aplica a blocos de código delimitados aninhados dentro de componentes JSX (por exemplo, dentro de <CodeGroup>).

  • Excluir elementos de código 

    Quando esta opção é selecionada, elementos de código são importados como códigos únicos do Phrase TMS.

  • Tornar URLs traduzíveis

    Torna URLs disponíveis para tradução.

  • Converter em códigos do Phrase TMS 

    Aplicar expressões regulares para converter texto especificado em tags.

    Importante

    Problemas com tags são uma causa comum de erros de exportação. Sempre garanta que as tags e a formatação estejam corretas antes de exportar arquivos executando verificações de garantia de qualidade.

  • Elementos personalizados (convertidos em tags da Phrase) 

    Defina os elementos no arquivo a serem convertidos em tags.

  • Blocos não traduzíveis 

    Defina seções no arquivo que não devem ser importadas.

    Exemplo:

    Nome do elemento: notrans.

    Código: <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.

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

  • Sem caracteres de escape 

    Uma lista de caracteres que não devem ser escapados no arquivo concluído (por exemplo, #, -, [, <,\,`, ![,](,:).

    Com o filtro MDX, tanto < quanto { são escapados por padrão no texto traduzido, porque um < ou { não escapado no destino quebraria a sintaxe MDX. Adicione-os aqui apenas se o caractere bruto, sem escape, for especificamente necessário na saída.

Opções específicas de MDX

As quatro opções a seguir estão disponíveis apenas quando MDX está selecionado em Filtro.

  • Atributos traduzíveis

    Defina pares adicionais de tag/atributo JSX para torná-los traduzíveis, usando o mesmo formato tag/attribute da configuração Atributos traduzíveis do filtro HTML. Por exemplo, Figure/title traduz o atributo title apenas no componente Figure, enquanto title (sem escopo) o traduz em todas as tags.

    Componentes personalizados (nomes de tag começando com uma letra maiúscula, como <Figure>) não possuem atributos traduzíveis por padrão, portanto, liste-os aqui explicitamente. Tags minúsculas/estilo HTML (<img>, <a>, etc.) já têm atributos padrão predefinidos.

  • Importar atributos traduzíveis por padrão

    Ativado por padrão.

    Aplica os atributos traduzíveis padrão do HTML (por exemplo, alt em <img>, title em <a>) a tags minúsculas/estilo HTML, além dos atributos listados em Atributos traduzíveis. Componentes personalizados nunca recebem esses padrões, independentemente desta configuração. Seus atributos são traduzíveis apenas quando adicionados a Atributos traduzíveis.

    Quando desativado, apenas os atributos listados em Atributos traduzíveis são traduzíveis, mesmo em tags minúsculas.

  • Tornar os elementos traduzíveis por padrão

    Ativado por padrão.

    Define se o texto dentro de um componente JSX é traduzível por padrão.

    • Quando ativado: O texto dentro de qualquer componente (por exemplo, <Tabs>, <Note>) é traduzível, a menos que o componente esteja listado em Elementos que substituem a traduzibilidade padrão.

    • Quando desativado: O texto dentro de componentes não é traduzível, a menos que o componente esteja listado em Elementos que substituem a traduzibilidade padrão.

  • Elementos que substituem a traduzibilidade padrão

    Uma lista de nomes de componentes, separados por vírgulas, que têm um comportamento oposto ao definido pela configuração Tornar elementos traduzíveis por padrão.

    A regra é invertida para o componente listado aqui como um todo: todo o seu conteúdo, incluindo quaisquer componentes aninhados dentro dele, segue essa regra e não é avaliado individualmente. Quando a substituição torna um componente não traduzível, seu conteúdo é preservado exatamente como escrito. Use esta lista para:

    • excluir alguns componentes que não contêm texto em prosa (por exemplo, CodeGroup, Mermaid) quando Tornar elementos traduzíveis por padrão estiver ativado, ou

    • incluir na lista de permissões alguns componentes que contêm texto em prosa quando essa configuração estiver desativada.

Como o conteúdo JSX é tratado

Isso se aplica quando MDX está selecionado em Filtro.

  • As tags JSX (<Component>, <Component attr="value" />) e os nomes de tags e atributos nunca são traduzíveis. Apenas o conteúdo dos elementos e os valores dos atributos explicitamente configurados são traduzíveis.

  • Expressões entre chaves ({...}), expressões JavaScript, atributos spread ({...props}) e comentários ({/* comment */}) nunca são traduzíveis. Esses elementos são preservados exatamente como foram escritos, onde quer que apareçam: em atributos, inseridos no texto ou em uma linha separada.

  • Declarações import e export são sempre excluídas da tradução, onde quer que apareçam no arquivo.

Esse artigo foi útil?
★ ★ ★ ★ ★

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.