---
title: Traduza um site MkDocs com IA | Smartcat
description: Traduza seu site MkDocs com IA e faça a análise no contexto. Instale por meio de uma substituição de tema (theme override) para o bloco head.
canonical: https://pt.smartcat.com/integrations/mkdocs/
language: pt
updated: 2026-11-16
---

# Traduza um site MkDocs com IA | Smartcat

## Traduza seu site MkDocs com IA

Basta adicionar o snippet de site da Smartcat ao seu projeto MkDocs uma vez, implantá-lo por meio do seu pipeline normal e revisar as traduções no Smartcat antes de publicar um idioma.

- [Iniciar teste grátis](https://smartcat.com/sign-up)

- [Agende uma demonstração](https://www.smartcat.com/book-a-demo/?mkdocs)

## Como adicionar Smartcat ao MkDocs

Crie um projeto de site da Smartcat a partir da URL do seu MkDocs publicado e escolha os idiomas de destino.

Instale o snippet gerado da Smartcat por meio de uma substituição de tema para o bloco head (extra_javascript carrega apenas recursos).

Implante a alteração e abra o site publicado para confirmar se o snippet está presente.

Revise as traduções no editor visual da Smartcat e publique os idiomas que estiverem prontos.

## Traduzir um site MkDocs sem editar o HTML gerado

Mantenha a integração na configuração de origem do seu MkDocs. extra_javascript carrega recursos JavaScript, enquanto uma substituição de tema pode ser necessária quando a instalação fornecida exigir marcação de cabeçalho. Com o Material for MkDocs, use a extensão de modelo com suporte em vez de modificar o pacote de tema instalado.

Reconstrua e implemente, depois faça uma análise de um guia com navegação, avisos e exemplos de código. Um aviso traduzido deve preservar sua gravidade, e um exemplo de comando deve permanecer executável. A tradução do site não produz um segundo conjunto de origens Markdown.

## O que muda para os visitantes e o que permanece no MkDocs

A tradução de sites traz alterações à experiência de leitura publicada. Ele não cria arquivos de origem traduzidos, catálogos de mensagens ou compilações de localidade no seu repositório do MkDocs.

## Análise antes de um idioma entrar no ar

A tradução automática oferece um primeiro rascunho rápido. No editor visual da Smartcat, você vê cada série traduzida na página, encurta títulos que ficam longos no celular e mantém os nomes de produtos e marcas consistentes com um glossário. Atribua um analista quando uma página precisar de aprovação e publique apenas os idiomas que estiverem prontos.

## Perguntas frequentes

### Posso colar tags de script HTML em extra_javascript?

extra_javascript é uma configuração de recurso, não um campo livre do cabeçalho HTML. Siga sua estrutura com suporte e use uma sobreposição de tema quando a marcação real for necessária.

### Posso editar traduções antes de publicar?

Sim. Refine e confirme o texto no editor visual da Smartcat e, em seguida, publique os idiomas que estiverem prontos.

### O que acontece quando eu adiciono uma nova página no MkDocs?

O novo texto segue o modo de tradução selecionado do projeto da Smartcat. Escolha traduções revisadas quando cada nova página exigir aprovação; os modos automáticos podem traduzir textos recém-encontrados. Nenhum dos modos faz alterações no seu conteúdo de origem no MkDocs.

Publique seu site MkDocs em mais idiomas

Instale o snippet uma vez, revise as traduções no contexto e publique os idiomas de que seu público precisa. Veja todas as [integrações de sites](https://www.smartcat.com/integrations/category/website-translation/) ou leia como o [Tradutor de Sites](https://www.smartcat.com/website-translator/) funciona.

- [Iniciar teste grátis](https://smartcat.com/sign-up)
