O bloco de categorias da Base de Conhecimento permite que você coloque categorias da sua documentação diretamente na página inicial como cartões visuais. Em vez de esperar que os leitores naveguem pela árvore de categorias para encontrar o que precisam, este bloco traz suas seções mais importantes para o início, oferecendo aos leitores uma visão visual e clicável do que a base de conhecimento contém no momento em que chegam à página inicial.
O bloco de categorias da base de conhecimento suporta apenas categorias - não artigos individuais. Quando uma categoria é selecionada, o primeiro artigo dessa categoria é exibido por padrão. Uma categoria só aparecerá no bloco se ela contiver pelo menos um artigo publicado.
Quando usar o bloco de categorias da Base de Conhecimento
- Grandes bases de conhecimento - Quando sua documentação tem muitas categorias, destacar as mais importantes como cartões da página inicial ajuda os leitores a navegar diretamente sem precisar vasculhar a árvore de categorias.
- Múltiplos tipos de público - Use cartões separados para "Começo", "Referência de API" e "Solução de Problemas" para direcionar diferentes tipos de leitores imediatamente para a seção correta.
- Navegação com permissão - Diferente de links estáticos ou HTML personalizado, este bloco respeita as permissões de acesso do leitor. Os leitores só veem os cartões de categoria que têm permissão para acessar, evitando erros 404 para conteúdo restrito.
- Substituindo uma introdução no estilo índice - Em vez de escrever uma lista de texto com as principais seções, deixe que os cartões de categoria façam o trabalho visualmente.
Como adicionar um bloco de categorias da Base de Conhecimento
- Navegue até Configurações () na barra de navegação da esquerda do portal da Base de Conhecimento.
- No painel de navegação esquerdo, navegue até Site da base de conhecimento > Personalização do site.
- Clique no botão Personalizar site .
- No menu suspenso à esquerda, selecione Página inicial . A seção Corpo exibe a lista de blocos corporais.
- Clique na seção Adicionar e selecione as categorias da Base de Conhecimento. O bloco é adicionado à lista.
- Clique no bloco de categorias da Base de Conhecimento para editar o título da seção e a cor geral do ícone.
- Clique em Adicionar elemento para adicionar cartões de categoria ao bloco.
- Selecione as categorias desejadas na sua base de conhecimento. Use a opção Filtrar para pesquisar por nome.
- Use o ícone Reorder () para reorganizar elementos. Os ícones de Reordenar e Esconder () aparecem quando você passa o mouse sobre qualquer bloco do corpo.
Como configurar elementos de categoria
Clique em qualquer elemento de categoria para editar os seguintes atributos:
| Atributo | O que você pode configurar |
|---|---|
| Ícone | Clique em Alterar para selecionar um ícone Document360 ou Font Awesome na aba Ícones, ou faça o upload/inserir a URL de uma imagem personalizada na aba Imagem |
| Título | Insira um título de exibição para o cartão de categoria |
| Cor do ícone | Escolha uma cor para o ícone |
| Texto do parágrafo | Adicione uma breve descrição usando a sintaxe Markdown |
| Cor do texto | Selecione a cor do texto para o título e o parágrafo |
Use arquivos de imagem em dimensão quadrada (por exemplo, 30×30px ou 50×50px) para ícones personalizados e evitar distorções.
Como salvar e publicar
- Use a opção de pré-visualização à direita para revisar suas alterações.
- Clique em Salvar para salvar suas alterações.
- Clique em Publicar para fazer as alterações ao vivo...
Melhores práticas
- Destaque suas categorias mais visitadas – confira suas análises para identificar quais categorias os leitores acessam mais e destaque essas primeiro.
- Mantenha as descrições das cartas curtas – uma frase por carta é suficiente. Textos de parágrafo mais longos bagunçam o layout do cartão.
- Use estilos de ícones consistentes – misturar tipos de ícones entre cartas no mesmo bloco parece inconsistente. Fique usando ícones do Document360, ícones do Font Awesome ou imagens personalizadas.
- Peça cartões por jornada do leitor - coloque categorias fundamentais (Começando, Instalação) antes das avançadas (Referência de API, Solução de Problemas) para guiar os novos leitores naturalmente.
- Use esse bloco em vez de HTML personalizado para links de categoria – o bloco embutido respeita as permissões do leitor; links estáticos em HTML personalizado não fazem isso.
FAQ
Como faço para remover o bloco de categorias da Base de Conhecimento?
Navegue até {{variable. Configurações}} () > {{variável. Base de conhecimento site}} > Personalização do site e clique em Personalizar site. No menu suspenso à esquerda, selecione Página inicial . Selecione o bloco desejado de categorias da base de conhecimento na seção Corpo. Clique em Excluir () abaixo da barra de navegação, depois clique em Sim no prompt de confirmação Excluir. Para deletar um elemento específico de categoria, selecione o elemento e siga os mesmos passos. Clique em Salvar e depois em Publicar para aplicar as alterações.
Por que não posso editar o título das categorias no bloco de categorias da Base de Conhecimento?
Os cartões de categoria neste bloco estão vinculados diretamente às categorias na seção de Documentação — seus títulos refletem os nomes reais das categorias e não podem ser alterados dentro do bloco. Apenas o campo de texto do Parágrafo pode ser editado aqui.
Para renomear uma categoria, navegue até {{variable. Documentação}} () na barra de navegação esquerda. No painel de Categorias e artigos, localize a categoria, clique no ícone Mais () ao lado e selecione Renomear, ou clique duas vezes no nome da categoria para editá-la no inline. Pressione Enter para salvar.
Existe um limite para o número de blocos de categoria que posso adicionar à página inicial?
Não — não há limite para o número de blocos de categorias da Base de Conhecimento que você pode adicionar à página inicial.
Posso mostrar cartões de categoria apenas para leitores que têm acesso a eles?
Sim. O bloco de categorias da base de conhecimento respeita automaticamente as permissões dos leitores — os leitores só veem os cartões de categoria que estão autorizados a acessar. Por isso, esse bloco é recomendado em vez de links estáticos ou HTML personalizado para mostrar categorias na página inicial. Quando categorias são adicionadas via HTML personalizado ou links codificados, esses links aparecem para todos os leitores independentemente das permissões, o que pode resultar em 404 erros para leitores sem acesso.