Categorias de Documentos do Discourse

Você não precisa apontar o plugin Docs para a categoria - este plugin substitui o plugin Docs. Isso pode ser o que está afetando as coisas para você, pois causaria um conflito com um substituindo o outro.

Tudo o que você precisa fazer é garantir que doc categories enabled esteja marcado e, em seguida, criar o tópico do índice na categoria, adicionando-o às configurações da categoria no campo Tópico do Índice. Se você ainda tiver a categoria definida nas configurações antigas do plugin Docs, deverá removê-la de lá.

Olá Hugh, obrigado pela rápida resposta! Se eu mencionei os plugins de Documentos, peço desculpas. Eu só tenho o plugin Categorias de Documentos instalado aqui.

Então, aqui está o relatório útil para encontrar Tópicos não indexados. Eu só tenho 2 tópicos de teste até agora.

Então, aqui está a tela de configurações. Eu sei que estou perto, mas estou perdendo um ou dois passos em algum lugar! Obrigado!

Você definiu a configuração de categoria?

Além disso, como está o seu índice? Ele está estruturado dessa forma?

Olá Marc! Sim, a Categoria está definida (obviamente) via o relatório acima, certo? Mas aqui está.

A página da Categoria se parece com isto:

Eu sei que estou perdendo algo. O que você quis dizer com esta página: Está estruturada assim?

Isso se refere a um índice para a Documentation no Meta. Seu tópico designado precisa se parecer com isso para que o índice seja gerado. Pelas suas capturas de tela, acho que você entendeu mal/leu algo errado. Leia a partir de aqui.

Além disso, meio que fora do tópico – mas talvez à noite. Preciso do plugin de tema da barra lateral para mostrar o índice à direita também? ou isso também é automático? Obrigado!

Não tenho certeza do que você quer dizer, pelo que entendi a barra lateral é padrão/central e não um plugin.

Entendi, você quis dizer pelas seções de título/subtítulo? Eu estava procurando por isso no editor, mas não estava aparente (para mim, pelo menos) se eu precisava de títulos como HTML

e coisas do tipo. Agradeço novamente as respostas rápidas!

Títulos são h1, links são por marcadores. Você pode literalmente copiar e colar o índice de metadados, ele deve lhe dar um exemplo para começar se você estiver com dificuldades.

Desta forma:

## algo útil
* isto é aquilo: https://forum.example.tld/t/777
* aquilo é outro: https://forum.example.tld/t/666

Etc.

Estou com preguiça, então não fiz isso manualmente, mas usei a IA do fórum.

1 curtida

Obrigado. Então, copiei uma parte do índice da documentação acima, conforme fornecido por @MarcP, apenas não vejo o índice da barra lateral, o que é estranho, a menos que eu esteja perdendo alguma coisa…

Essa captura de tela não mostra a estrutura. Você tem certeza absoluta de que está usando o formulário
* description: url
e que está informando o nome, a URL ou o ID desse tópico nas configurações dessa categoria?

Assim?

1 curtida

Sim. Se você vir algo semelhante a isto no composer (não se importe com a linguagem muito estranha, a ideia deve ficar clara, no entanto):

Isso é usado no menu de hambúrguer para apresentar as 20 principais postagens com mais reações em uma categoria #dogworld. Uma espécie de vitrine, então.

## Top 20 postagens com mais reações

* O que diabos está acontecendo na veterinária 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Anúncios de ração seca: Casos engraçados e reais: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479

Essas descrições não aparecem na barra lateral.

1 curtida

Bem, como você pode ver, nada no lado direito :frowning:

Se ajudar alguém, aqui está a lista de plugins que instalei também…

    cmd:
      - git clone https://github.com/discourse/docker_manager.git
      - git clone https://github.com/discourse/discourse-solved.git
      - git clone https://github.com/discourse/discourse-user-notes.git
      - git clone https://github.com/discourse/discourse-openid-connect.git
      - git clone https://github.com/discourse/discourse-ai.git
      - git clone https://github.com/discourse/discourse-yearly-review.git
      - git clone https://github.com/paviliondev/discourse-custom-wizard.git
      - git clone https://github.com/discourse/discourse-doc-categories.git
      - git clone https://github.com/discourse/discourse-reactions.git
      - git clone https://github.com/discourse/discourse-akismet.git
      - git clone https://github.com/discourse/discourse-data-explorer.git
      - git clone https://github.com/discourse/discourse-oauth2-basic.git
      - git clone https://github.com/discourse/discourse-assign.git
      - git clone https://github.com/discourse/discourse-templates.git
      - git clone https://github.com/discourse/discourse-policy.git
      - git clone https://github.com/discourse/discourse-gamification.git
      - git clone https://github.com/discourse/discourse-category-experts.git
      - git clone https://github.com/merefield/discourse-ai-topic-summary.git
      - git clone https://github.com/MonDiscourse/discourse-formatting-toolbar.git
      - git clone https://github.com/discourse/discourse-custom-topic-lists.git
      - git clone https://github.com/thoka/discourse-send-pdf-inline.git
      - git clone https://github.com/discourse/discourse-prometheus.git
      - git clone https://github.com/communiteq/discourse-user-response-times.git
      - git clone https://github.com/discourse/discourse-fingerprint.git
      - git clone https://github.com/discourse/discourse-bcc.git
      - git clone https://github.com/featheredtoast/discourse-pushover-notifications.git
      - git clone https://github.com/discourse/discourse-saved-searches.git

Normalmente, a barra lateral fica à esquerda (vermelho). A barra lateral de documentação apenas substitui o conteúdo padrão. À direita (roxo), você vê um índice que é adicionado pelo componente de tema DiscoTOC - automatic table of contents.

Sim, DiscoTOC é um componente de tema instalado também. Não consigo fazer funcionar também. Algo está errado…

Não tenho certeza, mas suas capturas de tela não estão claras. Você está tirando a captura de tela e não está mostrando nenhuma barra lateral? É a barra lateral do documento que não está aparecendo? Ou a barra lateral não está aparecendo de forma alguma (ela não está apenas oculta, tente pressionar =)?

Editar; pensando nisso, você deve ser claro se está tendo problemas com o discoTOC (sumário para o OP) ou com as categorias de documentos (barra lateral do índice do documento).

1 curtida

Olá Marc–
Então o DiscoTOC funciona. Voltei para verificar e ele realmente cria um índice na barra lateral depois que vou em engrenagens e insiro o índice conforme as instruções dizem.

Todas as minhas capturas de tela incluem a barra lateral, então estou mostrando a paisagem aberta sem nenhuma barra lateral visível.

Tenho a estranha sensação de que será uma correção muito simples, mas ainda não cheguei lá :frowning:

Não vejo nenhuma barra lateral em suas capturas de tela - todas elas mostram apenas o conteúdo da postagem. Você poderia postar uma captura de tela da tela completa do Discourse quando estiver em uma categoria que deveria ter um índice visível?

3 curtidas