Tipos de arquivo
-
.MD
-
.MARKDOWN
-
.MDX
Opções de importar
-
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.
-
Analisa apenas a estrutura básica do Markdown (títulos, parágrafos, listas, ênfase básica).
-
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.
-
Analisa usando a especificação GitHub Flavored Markdown (GFM), adicionando suporte para tabelas, listas de tarefas, tachado e links automáticos.
-
Analisa o arquivo como MDX: Markdown mais componentes JSX, expressões JSX (
{...}) e declarações ESMimport/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 , 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.
-
-
Inicia um novo segmento a cada quebra de linha forçada.
-
Preserva a mesma estrutura de espaços em branco no documento de destino (por exemplo, espaçamento, quebras de linha etc.).
-
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.
-
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>). -
Quando esta opção é selecionada, elementos de código são importados como códigos únicos do Phrase TMS.
-
Torna URLs disponíveis para tradução.
-
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.
-
Defina os elementos no arquivo a serem convertidos em tags.
-
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 ラリーの初日にリタイアしました。
-
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 .
-
Defina pares adicionais de tag/atributo JSX para torná-los traduzíveis, usando o mesmo formato
tag/attributeda configuração do filtro HTML. Por exemplo,Figure/titletraduz o atributotitleapenas no componenteFigure, enquantotitle(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. -
Ativado por padrão.
Aplica os atributos traduzíveis padrão do HTML (por exemplo,
altem<img>,titleem<a>) a tags minúsculas/estilo HTML, além dos atributos listados em . Componentes personalizados nunca recebem esses padrões, independentemente desta configuração. Seus atributos são traduzíveis apenas quando adicionados a .Quando desativado, apenas os atributos listados em são traduzíveis, mesmo em tags minúsculas.
-
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 . -
Quando desativado: O texto dentro de componentes não é traduzível, a menos que o componente esteja listado em .
-
-
Uma lista de nomes de componentes, separados por vírgulas, que têm um comportamento oposto ao definido pela configuraçã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 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 .
-
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
importeexportsão sempre excluídas da tradução, onde quer que apareçam no arquivo.