Clique em uma tag na barra lateral e a lista de tópicos será filtrada automaticamente por essa tag. Você pode selecionar quantas tags desejar, e a lista de tags mostrará apenas as tags adicionadas aos tópicos filtrados, facilitando a navegação em grandes volumes de documentação.
Quer pesquisar? Basta digitar um termo no campo. Os resultados da pesquisa também são restritos a qualquer tag que você tenha selecionado.
Considerações
As seguintes configurações do site são obrigatórias para que este componente funcione: tagging enabled (tagging habilitado) e show filter by tag (mostrar filtro por tag).
Este componente de tema atualmente não possui uma visualização para dispositivos móveis.
Dito isso, estamos trabalhando para construir uma versão mais avançada disso. Garantiremos que você seja avisado aqui no Meta quando estiver pronta!
Usamos o Discourse como nossa Base de Conhecimento há mais de 4 anos e temos cerca de 350 posts específicos para a Base de Conhecimento, então isso é muito emocionante!
Não tenho certeza se isso é possível por meio de um componente de tema, mas existe alguma maneira de essa “visualização” ser a padrão quando alguém abre uma categoria? Assim, em vez de acessar: /c/knowledge-base, ele carregaria automaticamente como /c/knowledge-base?kb=active?
Ativamos o componente de tema da Base de Conhecimento e gostamos muito dele, mas temos receio de que as pessoas não estejam vendo a visualização da Base de Conhecimento porque estão usando o link /c/knowledge-base que já tinham salvo nos favoritos.
Muito obrigado por isso! Temos uma categoria em nossa comunidade que seria perfeita para aplicar este componente, mas estamos enfrentando um problema: as categorias não aparecem no menu suspenso “kb categories”, então não conseguimos selecionar a categoria para aplicar o componente. Alguma sugestão?
Você pode simplesmente digitar o slug da categoria e criá-la. Não é extremamente intuitivo. Não consegui descobrir como obter subcategorias, mas se sua categoria estiver no primeiro nível, é bem fácil.
Não há sintaxe especial — basta inserir o slug da categoria (seja subcategoria ou não) na configuração do tema kb categories, atualizar o navegador e deverá funcionar.
Isso é uma limitação das configurações do tema no momento — você terá que digitar o slug, como sugerido por @Sean_R.
Conseguiu resolver isso, @TowerBR? Você atualizou a página após adicionar a categoria à configuração? Clicou no botão KB? Peço desculpas pelas perguntas óbvias, mas estou tentando entender o que está acontecendo.
Você tem a opção “padrão para visualização da Base de Conhecimento” ativada? Acabei de testar isso em um site meu e pareceu funcionar com subcategorias.
Estranho, ok. Se você conseguir reproduzir isso consistentemente, me avise e eu darei uma olhada. Não consegui fazer esse comportamento ocorrer usando o menu suspenso de subcategoria.
Removi o componente “Links de navegação superior personalizados”. Agora é uma instalação completamente “limpa”:
Sim, e também limpei o cache.
Sim. Quando seleciono a categoria pelo menu suspenso principal, a página da categoria já carrega com /c/diy?kb=active no final da URL. Ao passar o mouse sobre o botão KB, ele mostra a URL “normal” sem esse “acréscimo”, mas quando clico nele, nada acontece.
Isso é incrível! Acabei de instalar para dar uma olhada e já posso ver que é muito útil.
Este componente do tema parece entrar em conflito com https://meta.discourse.org/t/knowledge-base-plugin/115288 de @angus. Posso confirmar que o plugin precisa ser desinstalado antes de ativar este componente do tema; caso contrário, o que segue acontece quando você visualiza uma categoria da base de conhecimento. Note a linha horizontal estranha ao lado do menu e o círculo girando.
Gostaria muito de saber mais sobre a versão avançada e o que você tem planejado. Alguns feedbacks:
bug? Quando você seleciona uma tag no menu lateral para filtrar por essa tag e, em seguida, clica em outra categoria ou em “mais recentes” etc., ao clicar novamente em “kb” para retornar à base de conhecimento, você verá que ainda está filtrando por aquela tag.
Ao clicar na tag abaixo de um título, você é levado à página da tag correspondente, não a uma visão filtrada da base de conhecimento, como acontece quando clica na tag no menu lateral.
Ao clicar no título da categoria de tags no menu lateral, você é levado à visão “mais recentes” da categoria. Sugerimos que isso não tenha link para nenhum lugar. O título da categoria também provavelmente não deve conter #, pois isso é uma distração.
Seria útil ver o número de tópicos com cada tag no menu lateral.
Seria útil poder ordenar os tópicos da base de conhecimento alfabeticamente ou até mesmo em ordem personalizada.
A funcionalidade deste componente de tema foi substituída pelo plugin Discourse Docs
Link do Repositório
