DiscoTOC - índice automático

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.

2 curtidas

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 ---.

2 curtidas

Espero adicionar uma opção para suportar a função de abrir o diretório para todas as postagens com um clique!

1 curtida

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” também está localizada incorretamente.

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.

2 curtidas

Obrigado pela sua resposta. Não encontrei o problema agora, mas realmente houve um problema naquela época.

Uma postagem foi dividida em um novo tópico: Adicionar botão ao componente de tema TOC

Modo Leitor entra em conflito com Disco TOC
Parece que não podemos ter o Índice (do DiscoTOC, obrigatório para documentos grandes) e o Modo Leitor (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)

4 curtidas

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" :slight_smile:

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.

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.

1 curtida

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.

2 curtidas

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.

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 <div> data-theme-toc="true"> </div>. 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.

Não tenho certeza se isso é técnico o suficiente, mas o componente precisa tanto do <div> data-theme-toc="true"> </div> quanto de alguns títulos na postagem para poder gerar um índice adequado.

Sem a inserção do <div> data-theme-toc="true"> </div>, 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 <div> data-theme-toc="true"> </div> na postagem, embora você possa copiar isso ou digitar manualmente para o mesmo efeito.

Espero que isso ajude. :crossed_fingers:


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 <div> data-theme-toc="true"> </div> não será necessária nesses casos. :+1:

7 curtidas

Além disso… agora existe uma configuração para isso (Habilitar TOC para respostas), então você pode ter um toc em uma resposta. :partying_face:

4 curtidas

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?

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.

3 curtidas

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.

Eu fiz isso recentemente aqui no Meta no meu tópico de componente de tema e funcionou

1 curtida

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.