Apresentando o editor de índice visual para Categorias de Docs do Discourse

As categorias de documentos agora podem criar seu índice na barra lateral diretamente na interface administrativa. O editor de índice é uma mudança futura para o plugin Categorias de Documentos, que elimina a necessidade de manter um tópico de índice separado.

Duas formas de criar um índice

Ao editar uma categoria, agora há uma aba Índice de Docs com um seletor de modo:

  • Editor cria o índice no local, como seções contendo links.
  • Tópico de índice é o comportamento atual, onde os cabeçalhos e listas de um tópico se tornam o índice.
  • Desativado desativa o índice da barra lateral para essa categoria.

As categorias que já apontam para um tópico de índice continuarão funcionando exatamente como hoje.

Criando um índice

Uma seção contém links, e um link aponta para um tópico ou para qualquer URL que você digitar. Cada link pode ter seu próprio ícone, e o editor avisa quando dois links resolvem para o mesmo destino ou quando duas seções compartilham o mesmo título.

Você também é informado quando os tópicos na categoria não aparecem no índice, e pode adicionar esses tópicos em massa:

Uma seção de Auto-índice se preenche automaticamente a partir dos tópicos da categoria, permitindo que você liste manualmente as páginas importantes e deixe todo o resto agrupado em um só lugar. Ela pode ser ressincronizada a cada salvamento.

Seções e links podem ser reordenados por arrastar e soltar. Cada alça de arrastar também é um ponto de parada de tabulação comum que abre um menu de movimento, permitindo que todo o índice seja reorganizado pelo teclado. Um modo de lote lida com a seleção múltipla, para excluir várias linhas de uma vez ou arrastar uma seleção inteira em conjunto.

Ative em seu site

O editor de índice é uma mudança futura experimental. Ative Editor de índice de categorias de documentos em /admin/config/upcoming-changes. Isso afeta apenas as categorias de documentos e apenas o que os administradores veem ao editar uma.

Adoraríamos ouvir seu feedback

Diga-nos como ele se compara a um índice real: se criar um aqui é melhor do que manter um tópico, o que está faltando antes que você migre uma categoria e qualquer coisa que pareça imperfeita.

14 Curtiram

O PR inicial FEATURE: Add visual doc category index editor - Pull Request #87 - discourse/discourse-doc-categories - GitHub acabou de ser incorporado sob uma alteração experimental futura; a funcionalidade provavelmente passará por mais ajustes na próxima semana ou duas antes de ser movida para a versão Alpha.

1 Curtiu