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.

Isenção de responsabilidade: Este artigo foi gerado usando tradução automática.

As of 22 Nov 2025, the Markdown editor has been upgraded from v1.4.10 to v3.2.2. The toolbar, layout, icons, and editor structure remain unchanged.

Como alterar o texto do nome da linguagem em blocos de código

  • Atualizado em Jun 22, 2026
  • Publicado em Sep 9, 2024
  • 2 minuto(s) lido(s)
Prev Next

Blocos de código no Document360 exibem o nome da linguagem de programação como um rótulo por padrão, por exemplo, css, javascript, ou xml. Para bases de conhecimento que documentam sistemas proprietários, ferramentas internas ou formatos não padronizados, esses rótulos genéricos de linguagem podem ser confusos ou irrelevantes para os leitores. Substituí-los por uma etiqueta personalizada consistente como "Exemplo" ou "Código de exemplo" deixa os blocos de código mais claros e dá à sua documentação uma aparência mais polida e marcada.

Quando usar isso

Use essa personalização quando quiser:

  • Substituir os nomes das linguagens técnicas por etiquetas amigáveis para o leitor (por exemplo, "Exemplo de código" em vez de "javascript").
  • Aplique um rótulo de bloco de código consistente em toda a sua base de conhecimento para um visual uniforme.
  • Documente linguagens de script proprietárias ou formatos de configuração onde o rótulo padrão não corresponde ao seu conteúdo.

NOTA

Essa mudança de CSS se aplica a todos os blocos de código de toda a sua base de conhecimento — não a artigos individuais ou blocos específicos.

Antes de começar

Você precisa de acesso às Configurações > site da base de conhecimento > Personalização do site > CSS & JavaScript personalizados no portal da base de conhecimento.

Como alterar o rótulo da linguagem em blocos de código

  1. Navegar até Configurações (

    ) > site da base de conhecimento > personalização do site > CSS & JavaScript personalizados no portal da base de conhecimento.

    Custom CSS and JavaScript settings panel in the Document360 Knowledge base portal

  2. No painel de navegação à esquerda, selecione a aba CSS e cole o seguinte trecho de CSS:

div.code-toolbar>.toolbar .toolbar-item:first-child {
    visibility: hidden;
}
div.code-toolbar>.toolbar .toolbar-item:first-child span:before {
    visibility: visible;
    content: "Example" !important;
}

  1. Substitua "Example" pelo texto da etiqueta desejada, por exemplo, "Sample code", "Command", ou pelo nome do seu produto.

  2. Clique em Salvar.

    CSS tab showing the custom label snippet saved in the Custom CSS and JavaScript panel

Melhores práticas

  • Escolha um rótulo que reflita seu público. Leitores que não são desenvolvedores podem achar rótulos como "Exemplo" ou "Comando" mais intuitivos do que "bash" ou "python". Associe o rótulo ao que seus leitores chamam desse tipo de conteúdo.
  • Mantenha o rótulo curto. Etiquetas de blocos de código têm espaço de exibição limitado. Rótulos acima de 20 caracteres podem ser truncados dependendo do tamanho da tela do leitor.
  • Teste após salvar. Abra um artigo no seu site de base de conhecimento e confirme que o novo rótulo aparece corretamente em diferentes tipos de blocos de código antes de publicar para os leitores.
  • Considere rótulos por bloco para públicos técnicos. Se seus leitores são desenvolvedores que precisam ver exatamente a linguagem, use o recurso de etiqueta personalizada embutido do Document360 em blocos de código individuais em vez desse CSS que cobre todo o site. Navegue até o bloco de código no editor, selecione Personalizado no menu suspenso do idioma, clique no ícone Editar e insira um título apenas para esse bloco.
Artigos relacionados