--- title: "Uso e tradução de trechos" slug: "use-and-translate-snippets" updated: 2026-06-17T07:39:23Z published: 2026-06-17T07:39:23Z canonical: "docs.document360.com/use-and-translate-snippets" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Uso e tradução de trechos Uma vez criado um trecho, você pode inseri-lo em qualquer página de artigo ou categoria usando três métodos: a sintaxe do código de mescagem (editor Markdown), a barra de ferramentas (editor Markdown) ou o comando barra (editor WYSIWYG avançado). Trechos também podem ser traduzidos para que, quando seus artigos forem lidos em outro idioma, o conteúdo do trecho coincida. --- ## Insira um trecho em um artigo Escolha o método que combine com seu editor. Uso da sintaxe do código de merge Digite o código de mescagem diretamente no editor Markdown. É melhor quando você já sabe o valor do código de merge do snippet. [Saiba mais →](/docs/pt/use-and-translate-snippets#using-merge-code-syntax-markdown-editor) Usando a barra de ferramentas Navegue ou pesquise por trechos no ícone de ferramentas de conteúdo na barra de ferramentas. Funciona no editor Markdown. [Saiba mais →](/docs/pt/use-and-translate-snippets#using-the-toolbar-markdown-editor) Usando o comando de barra Digite /snippets no editor Advanced WYSIWYG para abrir o seletor de trechos em linha sem sair do teclado. [Saiba mais →](/docs/pt/use-and-translate-snippets#using-the-slash-command-advanced-wysiwyg-editor) ### Usando a sintaxe do código de mescagem (editor Markdown) No editor Markdown, digite o valor do código de fusão do trecho entre dois parênteses curvos diretamente no conteúdo. **Exemplo:** `{{snippet.snippet name}}` O código de fusão deve corresponder exatamente, incluindo capitalização e ortografia. Uma diferença de um único caractere impedirá que o trecho seja renderizado. NOTA A sintaxe do código de merge só funciona no editor Markdown. Se você estiver usando o editor Advanced WYSIWYG, insira trechos usando a barra de ferramentas ou o comando de barra. ### Usando a barra de ferramentas (editor Markdown) 1. No editor de artigos, clique no ícone **de ferramentas de conteúdo** () na barra de ferramentas. 2. Selecione o trecho ou use a barra **de Busca** para restringir o nome. 3. Selecione o trecho para inseri-lo. ![Markdown editor toolbar showing the Content tools icon and snippet selection panel](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768559949127.png) NOTA Se a opção **Inserir como cópia local** estiver ativada, o conteúdo do trecho adicionado ao artigo permanecerá inalterado mesmo que o trecho fonte seja modificado ou removido no futuro. ### Usando o comando barra (editor WYSIWYG avançado) 1. No editor avançado WYSIWYG, digite `/snippets` para abrir a ferramenta Snippets no menu com barras. 2. Use a barra **de trechos de Busca** para encontrar o trecho que você quer inserir. 3. Passe o mouse sobre o nome de um trecho para pré-visualizar seu conteúdo completo. ![Slash command menu in the Advanced WYSIWYG editor showing snippet search and preview](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Snippet%20-%20Slash%20command.png) 1. Clique no trecho para inseri-lo. O conteúdo é inserido dentro de um bloco destacado com um contorno pontilhado, distinguindo-o do restante do artigo. 2. Clique dentro do bloco de trechos para abrir o menu de bolhas. | Opção | Descrição | | --- | --- | | **Menu suspenso** | Troque para outro trecho. | | **Inserir como texto** | Converte o trecho em conteúdo estático. A tag do trecho é substituída pelo texto atual e futuras atualizações do trecho não se aplicam mais. | | **Excluir** | Remove o bloco de trechos do artigo. | ![Snippet bubble menu showing Switch, Insert as text, and Delete options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Snippet%20-%20Edit%20options.png) --- ## Traduzir trechos Você pode criar trechos em vários idiomas para que, quando seus artigos forem lidos em um idioma específico, o conteúdo correspondente do trecho traduzido seja exibido. NOTA Trechos globais não podem ser traduzidos. Apenas trechos criados com um escopo específico de idioma suportam tradução. ### Traduzir um novo trecho 1. Navegue para **ferramentas de conteúdo** () > **Recursos de conteúdo** > **Trechos**. 2. Clique **em Criar**. 3. No **diálogo Criar novo trecho** , insira o nome do trecho, selecione o idioma e escolha seu editor. Clique **em Criar**. 4. No menu **suspenso Idioma** no topo do editor, selecione o idioma do trecho. 5. Insira o conteúdo nesse idioma. 6. Clique no menu **suspenso Traduzir para outros idiomas** , selecione os idiomas para os quais você quer traduzir e clique **em Traduzir**. NOTA O idioma padrão é marcado como **Principal**. As línguas traduzidas mostram um visto verde quando a tradução está concluída. Você pode mudar manualmente para idiomas não traduzidos e adicionar traduções conforme necessário. 1. Clique em **Salvar** para salvar com todas as traduções. ![Snippet translation panel showing language tabs and translation status indicators](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Snippet%20-%20Translation.png) ### Traduzir um trecho existente 1. Na página **de Snippets** clica no nome do trecho que você quer traduzir. 2. Navegue para **Traduzir para outros idiomas**, selecione o idioma e clique **em Traduzir**. 3. Para traduzir para outros idiomas, selecione cada um e clique **em Traduzir**. 4. Para sobrescrever uma tradução existente, clique **em Traduzir novamente**. 5. Para remover uma tradução para um idioma específico, clique no ícone **Mais** () e selecione **Limpar conteúdo desse idioma**. 6. **Clique em Atualizar** para salvar. ![Snippet translation panel showing the More menu with Clear content from this language option](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Snippet%20-%20Remove%20translation.png) --- ## Melhores práticas - Pré-visualize antes de inserir. No editor avançado WYSIWYG, passe o mouse sobre o nome de um trecho no menu com barras para pré-visualizar o conteúdo completo antes de inserir. - Use Inserir como texto com cuidado. Converter um trecho em texto estático quebra o link para o trecho de origem. Futuras atualizações do trecho não se aplicarão mais a essa instância. - Traduza antes de publicar. Se sua base de conhecimento for multilíngue, adicione traduções para novos trechos antes de publicar artigos que as utilizem. Uma tradução ausente pode apresentar conteúdo inconsistente ou de remédio aos leitores. - Use o comando de corte para inserir mais rápido. No editor avançado WYSIWYG, `/snippets` geralmente é mais rápido do que navegar pela barra de ferramentas, especialmente quando você conhece parte do nome do trecho. --- ## FAQ **Posso usar variáveis dentro de trechos?** Não. O uso de variáveis dentro de snippets não é suportado. Se você inserir uma variável dentro de um trecho, ela não será renderizada corretamente na prévia do editor ou em saídas exportadas, como PDF. **Por que um trecho é sempre inserido em uma nova linha?** Trechos são projetados como blocos de conteúdo que podem conter múltiplas linhas. Eles sempre começam uma nova linha para manter a estrutura e a clareza do artigo. **Existe um limite de caracteres para conteúdo de trechos?** Não. Não há limite de caracteres para o conteúdo do corpo dos trechos. Você pode incluir tanto texto, formatação, imagens, tabelas ou outros elementos suportados quanto necessário. O único limite de caracteres é o campo **Nome** , que tem no máximo 50 caracteres. **Posso mudar o nome de um trecho depois que ele foi criado?** Não. O nome do trecho não pode ser alterado após a criação. Você pode editar o conteúdo de um trecho a qualquer momento. **Quantos trechos posso criar em um projeto?** Você pode criar até 200 trechos por projeto. Trechos adicionais podem ser adquiridos como complemento.