# DiscoTOC - índice automático
**URL:** https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143
**Category:** Theme component
**Tags:** official, disco-toc
**Created:** [Março 9, 2019, 5:36am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143 "2019-03-09T05:36:22Z")
**Posts on this page:** 20
**Page:** 6
### Author:  [@leopedrini](https://meta.discourse.org/u/leopedrini)
#### Post date: [Julho 9, 2024, 9:49am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/440 "2024-07-09T09:49:28Z")
Olá…
Tenho um problema com o uso do DiscoTOC, talvez alguém tenha uma ideia.
Imagine o DiscoToc, funcionando perfeitamente, para um tópico, como exemplo:
- link a → adiciona “link-a-1” ao final
- link b → adiciona “link-b-2” ao final
Suponha que eu compartilhei o link a com alguém: (“…link-a-1”)
Agora, imagine que eu reordenei os tópicos (coloquei “link b” antes).
Usando o DiscoToc, fica assim:
- link b → adiciona “link-b-1” ao final
- link a → adiciona “link-a-2” ao final
E a partir de agora, o link que eu tinha compartilhado não funciona mais.
Eu compartilhei (“…link-a-1”), mas agora o correto é (“…link-a-2”)
Eu realmente apreciaria se alguém tivesse alguma ideia.
---
### Author:  [@hazenbiz](https://meta.discourse.org/u/hazenbiz)
#### Post date: [Agosto 22, 2024, 9:52pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/441 "2024-08-22T21:52:39Z")
RELATÓRIO DE BUG!
Travessões e hífens gerados automaticamente por agrupamentos de 2 ou 3 hífens não funcionam mais quando o DiscoTOC está ativo. Em vez de – ou —, eles voltam a ser `--` ou `---`.
---
### Author:  [@qianping\_chen](https://meta.discourse.org/u/qianping_chen)
#### Post date: [Setembro 21, 2024, 8:22am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/442 "2024-09-21T08:22:42Z")
Espero adicionar uma opção para suportar a função de abrir o diretório para todas as postagens com um clique!
---
### Author:  [@qianping\_chen](https://meta.discourse.org/u/qianping_chen)
#### Post date: [Novembro 3, 2024, 6:28pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/443 "2024-11-03T18:28:11Z")
2024-11-02T22:00:00Z
Relatório de erro: Ao clicar em um diretório, a posição do conteúdo exibido não corresponde à localização do diretório
Basicamente, a página atual “[DiscoTOC - automatic table of contents](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143)” também está localizada incorretamente.
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [Novembro 4, 2024, 2:59pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/444 "2024-11-04T14:59:38Z")
Você pode ser mais específico e fornecer um exemplo. O TOC está carregando e funcionando como esperado para mim em todas as minhas instâncias do fórum Discourse.
A página que você vinculou carrega corretamente e o TOC está funcionando.
> [@qianping\_chen](#):
>
> Basicamente, a página atual “[DiscoTOC - índice automático](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143)” também está localizada incorretamente.
---
### Author:  [@qianping\_chen](https://meta.discourse.org/u/qianping_chen)
#### Post date: [Novembro 8, 2024, 12:26pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/445 "2024-11-08T12:26:57Z")
Obrigado pela sua resposta. Não encontrei o problema agora, mas realmente houve um problema naquela época.
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [Novembro 8, 2024, 3:41pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/446 "2024-11-08T15:41:50Z")
Uma postagem foi dividida em um novo tópico: [Adicionar botão ao componente de tema TOC](https://meta.discourse.org/t/add-button-to-toc-theme-component/335200)
---
### Author:  [@StefanoCecere](https://meta.discourse.org/u/StefanoCecere)
#### Post date: [Janeiro 28, 2025, 5:52am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/448 "2025-01-28T05:52:34Z")
Modo Leitor entra em conflito com Disco TOC
Parece que não podemos ter o Índice (do [DiscoTOC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143), obrigatório para documentos grandes) e o [Modo Leitor](https://meta.discourse.org/t/reader-mode/307916/14) (também obrigatório para documentos grandes)
A lista do Índice se sobrepõe e esconde o ícone do Modo Leitor (e o ícone do menu de operações da postagem)
---
### Author:  [@agemo](https://meta.discourse.org/u/agemo)
#### Post date: [Fevereiro 5, 2025, 12:29pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/449 "2025-02-05T12:29:24Z")
Pergunta sobre o tópico - Existe alguma função ou plugin que possa gerar automaticamente uma lista de todos os tópicos de categorias, para ajudar a gerar um índice ou até mesmo conteúdo de postagens do tipo Wiki?
Esta é uma solução para economizar esforço manual.
Um pouco de script, mas seria interessante ter talvez uma tag que fizesse isso, então, sendo nativo do Discourse, algo que imprima todos os tópicos (títulos) em uma categoria de discussão (e os vincule).
No entanto, suponho que seria melhor implementado dentro do recurso do botão LINK, quando você clica, pode inserir/pesquisar o tópico que está procurando, mas agora você tem uma nova opção de nível superior como
> `Botão "Imprimir-links: todos os títulos de tópicos da categoria X"` 🙂
Eu presumiria que a ordenação por data do tópico, com alternância novo/antigo, seria útil.
Este é provavelmente um pedido de recurso, mas pensei em perguntar aqui, pois é mais relevante, já que estava pensando em um caso de uso com o DiscoTOC, para fazer isso manualmente.
Talvez a IA faça isso, mas não usamos os recursos de IA, talvez esteja mais alinhado como uma ramificação do recurso do botão LINK, talvez mais do que o DiscoTOS, e pode haver uma base de uso de aplicação mais ampla do que até mesmo eu estou imaginando.
---
### Author:  [@Drew-ART](https://meta.discourse.org/u/Drew-ART)
#### Post date: [Março 6, 2025, 3:41pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/450 "2025-03-06T15:41:53Z")
Imagino que seja bastante óbvio, mas este componente não funciona com o componente Blog Post Styling, pois ele oculta a barra lateral.
Sugiro ter uma opção de ‘TOC inline’, como era o plugin, se houver interesse em fazê-los funcionar juntos.
O inline é útil como uma opção, então poder alternar seria maravilhoso. É ótimo para alguns casos de uso porque é muito óbvio para os usuários, enquanto o novo é mais inteligente, mas um pouco escondido e pode ser perdido.
Quando sua intenção principal é que todos os usuários saltem diretamente para a seção de seu interesse, a versão inline seria uma escolha melhor.
---
### Author:  [@serkhelesheyi](https://meta.discourse.org/u/serkhelesheyi)
#### Post date: [Abril 25, 2025, 7:44pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/451 "2025-04-25T19:44:02Z")
Gostaria de compartilhar um feedback sobre o plugin DiscoTOC. Na maioria dos temas do Discourse, a barra lateral do TOC é exibida com uma largura apropriada, garantindo que títulos longos sejam tratados de forma elegante. No entanto, ao usar o tema Horizon, a largura da barra lateral é notavelmente estreita, o que faz com que títulos longos sejam divididos em várias linhas. Isso limita a legibilidade e afeta a consistência visual geral da interface.
Você poderia considerar investigar esse problema especificamente para o tema Horizon e explorar opções para ajustar a largura da barra lateral para uma melhor apresentação de títulos mais longos? Acredito que resolver isso melhoraria a experiência do usuário para muitos no tema Horizon.
Obrigado pelo seu trabalho árduo e por considerar esta sugestão.
---
### Author:  [@serkhelesheyi](https://meta.discourse.org/u/serkhelesheyi)
#### Post date: [Maio 3, 2025, 6:35pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/453 "2025-05-03T18:35:07Z")
**Assunto:** Mau funcionamento do componente discoTOC no **local Persa**
**Ambiente:** Fórum com **Local Padrão** definido como **"Persa"**.
**Componente Afetado:** discoTOC
**Descrição:** Quando o local padrão do fórum é configurado como "Persa", o componente discotoc falha em funcionar corretamente.
**Sintomas Específicos:**
1. Os elementos da interface do usuário para os botões " **Linha do Tempo**" e " **Conteúdo**" não são exibidos.
2. Após um usuário enviar uma resposta a um tópico, a visualização da tabela de conteúdo é automaticamente ocultada, a visualização da linha do tempo é exibida e não há nenhum elemento interativo fornecido para restaurar a visualização da tabela de conteúdo.
---
### Author:  [@serkhelesheyi](https://meta.discourse.org/u/serkhelesheyi)
#### Post date: [Maio 3, 2025, 6:47pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/454 "2025-05-03T18:47:14Z")
> [@Discourse](#):
>
> ### Como crio um índice?
>
> 1. Escreva um tópico com cabeçalhos sintaticamente corretos
> 2. Clique no botão de índice no menu de engrenagem (só aparece ao criar um tópico regular - respostas e MPs são ignorados)
> 3. Lucro.
Em relação às instruções acima sobre o uso do componente discoTOC, tenho algumas perguntas técnicas para esclarecimento:
1. O Passo 1 menciona a escrita de um tópico com cabeçalhos e o Passo 2 menciona o uso de um botão específico. Se eu seguir o Passo 1 estruturando meu tópico com cabeçalhos markdown (por exemplo, `##`, `###`) mas **omitir clicar no "botão de índice" no menu de engrenagem (Passo 2)**, o componente discoTOC ainda **gerará ou exibirá automaticamente o índice com base apenas nos cabeçalhos**? Em essência, clicar no botão é **obrigatório para que o componente funcione corretamente** , ou é apenas um **gatilho para inserir um elemento específico**?
2. Qual é o **propósito ou funcionalidade exata do "botão de índice"** localizado no menu de engrenagem? **Como este botão deve ser usado** no fluxo de trabalho do editor de tópicos?
3. Separadamente, encontrei o trecho **` data-theme-toc="true">
`**. Você poderia explicar seu **papel exato em conjunto com o discoTOC**? O que este elemento `div` **controla** e **como ele deve ser implementado ou configurado** dentro do conteúdo do tópico para afetar a geração ou exibição do índice?
Obrigado pela sua explicação detalhada.
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [Maio 6, 2025, 9:37am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/455 "2025-05-06T09:37:39Z")
Não tenho certeza se isso é técnico o suficiente, mas o componente precisa tanto do ` data-theme-toc="true">
` quanto de alguns títulos na postagem para poder gerar um índice adequado.
Sem a inserção do ` data-theme-toc="true">
`, a postagem será simplesmente uma postagem com títulos, e adicionar isso sem incluir nenhum título não gerará um índice (há também uma configuração de `Mínimo de títulos para o TOC` no componente, que por padrão é 3. Portanto, você precisaria de pelo menos 3 títulos em sua postagem para gerar um índice visível).
O botão ‘inserir índice’ insere o ` data-theme-toc="true">
` na postagem, embora você possa copiar isso ou digitar manualmente para o mesmo efeito.
Espero que isso ajude. 🤞
* * *
**ETA:** Acabei de receber um lembrete gentil de que, se você estiver usando as configurações de componente `Categorias automáticas de TOC` e `Tags automáticas de TOC`, a inserção do ` data-theme-toc="true">
` não será necessária nesses casos. 👍
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [Maio 6, 2025, 2:54pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/456 "2025-05-06T14:54:36Z")
> [@Discourse](#):
>
> Clique no botão toc no menu de engrenagem (só aparece ao criar um tópico regular - respostas e MPs são ignorados
Além disso… agora existe uma configuração para isso (`Habilitar TOC para respostas`), então você pode ter um toc em uma resposta. 🥳
---
### Author:  [@fbpbdmin](https://meta.discourse.org/u/fbpbdmin)
#### Post date: [Maio 16, 2025, 12:58am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/457 "2025-05-16T00:58:51Z")
> [@JammyDodger](#):
>
> já existe uma configuração para isso (`Ativar TOC para respostas`)
será que é possível torná-lo um TOC padrão para respostas se uma resposta tiver diferentes níveis de estrutura…
ou há alguma preocupação com isso?
---
### Author:  [@nathank](https://meta.discourse.org/u/nathank)
#### Post date: [Maio 16, 2025, 4:24am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/458 "2025-05-16T04:24:44Z")
Depois de usar o reply ToC por um tempo, acho que isso faz muito sentido.
Apenas usuários avançados (ou seja, eu mesmo nos nossos sites) se dão ao trabalho de adicionar um ToC manualmente. Ter isso de forma automática seria extremamente útil.
---
### Author:  [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [Julho 9, 2025, 5:10pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/459 "2025-07-09T17:10:24Z")
Estou enfrentando alguns problemas:
1. Se eu tento criar o TOC em um tópico que foi criado sem o TOC, ele não funciona. Isso é normal? Parece que só funciona se eu criar o tópico com o TOC. Editar um tópico, não funciona.
2. No tópico que criei com sucesso com o TOC, quando clico nos títulos no TOC, ele não rola para o título.
3. Parece que ele só cria o TOC para os títulos `##`. Eu tenho títulos `###`, mas eles não são mostrados.
---
### Author:  [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Julho 9, 2025, 5:14pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/460 "2025-07-09T17:14:27Z")
> [@alltiagocom](#):
>
> Se eu tentar adicionar o TOC a um tópico que foi inicialmente criado sem o TOC, ele não funciona. Isso é normal? Parece funcionar apenas se eu criar o tópico com o TOC. Editar um tópico não funciona.
Eu fiz isso recentemente aqui no Meta no [meu tópico de componente de tema](https://meta.discourse.org/t/share-theme-component-translations/371975) e funcionou
---
### Author:  [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [Julho 9, 2025, 5:24pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/461 "2025-07-09T17:24:19Z")
Estranho… quando salvei, não estava aparecendo, então talvez eu precisasse atualizar a página? Eu esperava que aparecesse imediatamente.
Bom saber que agora está aparecendo.
(Para esclarecer, eu consegui adicionar o texto que você adicionou na sua imagem, mas o TOC não estava aparecendo no lado direito).
Em relação aos outros problemas, agora também está funcionando. Eu não entendo… vai entender…
Você sabe se é possível desabilitar o comportamento onde os subtítulos ficam ocultos quando o título pai não está “em foco”?
Eu gostaria que todos os títulos ficassem visíveis o tempo todo, caso contrário, parece que há menos conteúdo do que realmente existe.
Já estou feliz em saber que está funcionando como esperado, então este é apenas um detalhe que seria a cereja do bolo, se for possível alcançar.
[Página anterior](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=5)
[Próxima página](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=7)