DiscoTOC - sommario automatico

Ciao…

Ho un problema con l’uso di DiscoTOC, forse qualcuno ha un’idea.

Immagina DiscoToc, che funziona perfettamente, per un argomento, come esempio:

  • link a → aggiunge “link-a-1” alla fine
  • link b → aggiunge “link-b-2” alla fine

Supponiamo che abbia condiviso il link a con qualcuno: (“…link-a-1”)

Ora, immagina di aver riordinato gli argomenti (ho messo “link b” prima).
Usando DiscoToc, appare così:

  • link b → aggiunge “link-b-1” alla fine
  • link a → aggiunge “link-a-2” alla fine

E d’ora in poi, il link che avevo condiviso non funziona più.
Ho condiviso (“…link-a-1”), ma ora quello corretto è (“…link-a-2”)

Apprezzerei molto se qualcuno avesse qualche idea.

2 Mi Piace

SEGNALAZIONE BUG!

I trattini lunghi e i trattini lunghissimi generati automaticamente da gruppi di 2 o 3 trattini non funzionano più quando DiscoTOC è attivo. Invece di – o — tornano ad essere -- o ---.

2 Mi Piace

Spero di aggiungere un’opzione per supportare l’apertura della funzione di directory per tutti i post con un clic!

1 Mi Piace

2024-11-02T22:00:00Z
Rapporto di errore: quando si fa clic su una directory, la posizione del contenuto visualizzato non corrisponde alla posizione della directory.

In sostanza, anche la pagina corrente “DiscoTOC - automatic table of contents” si trova in una posizione errata.

Puoi essere più specifico e fornire un esempio. La TOC si sta caricando e funziona come previsto per me su tutte le mie istanze del forum Discourse.

La pagina che hai linkato si carica correttamente e la TOC funziona.

2 Mi Piace

Grazie per la tua risposta. Al momento non ho trovato il problema, ma all’epoca c’era effettivamente un problema.

Un post è stato diviso in un nuovo argomento: Aggiungi pulsante al componente tema TOC

La modalità lettura è in conflitto con Disco TOC

sembra che non possiamo avere sia la Tabella dei contenuti (di DiscoTOC, obbligatoria per documenti di grandi dimensioni) sia la Modalità lettura (anch’essa obbligatoria per documenti di grandi dimensioni)

l’elenco TOC si sovrappone e nasconde l’icona della Modalità lettura (e l’icona del menu delle operazioni del post)

4 Mi Piace

Domanda sull’argomento: esiste una funzione o un plugin che possa generare automaticamente un elenco di tutti gli argomenti delle categorie, per aiutare a generare un indice dei contenuti o persino contenuti di post di tipo Wiki?

Questa è una soluzione per risparmiare fatica manuale.

Un po’ di scripting, ma sarebbe interessante avere magari un tag che lo faccia, quindi essendo nativo di Discourse, qualcosa che stampi tutti gli argomenti (titoli) in una categoria di discussione (e li colleghi in tempo reale).

Tuttavia, suppongo che potrebbe essere implementato meglio all’interno della funzionalità del pulsante LINK, quando fai clic puoi inserire/cercare l’argomento che stai cercando, ma ora hai una nuova opzione di primo livello come

“Stampa-link: tutti i titoli degli argomenti dalla categoria X” pulsante :slight_smile:

Presumo che l’ordinamento per data dell’argomento con opzione di attivazione/disattivazione nuovo/vecchio sarebbe utile.

Questa è probabilmente una richiesta di funzionalità, ma ho pensato di chiedere qui poiché è più pertinente dato che stavo pensando a un caso d’uso con DiscoTOC, per farlo manualmente.

Forse l’IA fa questo ma non utilizziamo le funzionalità AI, forse è più allineato come una diramazione della funzionalità del pulsante LINK, forse più di DiscoTOS e potrebbe esserci una base di utilizzo più ampia di quanto io stesso stia immaginando.

Immagino sia abbastanza ovvio, ma questo componente non funziona con il componente Blog Post Styling poiché nasconde la barra laterale.

Suggerisco di avere un’opzione ‘TOC inline’, come era solita essere la plugin, se c’è interesse a farli funzionare insieme.

Quello inline è utile come opzione, quindi poter passare sarebbe meraviglioso. È ottimo per alcuni casi d’uso perché è molto ovvio per gli utenti, mentre quello nuovo è più intelligente ma un po’ nascosto e può essere perso.

Quando la tua intenzione principale è che tutti gli utenti saltino direttamente alla sezione che interessa loro, la versione inline sarebbe una scelta migliore.

1 Mi Piace

Vorrei condividere un feedback riguardo al plugin DiscoTOC. Nella maggior parte dei temi di Discourse, la barra laterale del TOC viene visualizzata con una larghezza appropriata, garantendo che i titoli lunghi vengano gestiti in modo efficace. Tuttavia, quando si utilizza il tema Horizon, la larghezza della barra laterale è notevolmente stretta, il che fa sì che i titoli lunghi vengano spezzati su più righe. Ciò limita la leggibilità e influisce sulla coerenza visiva generale dell’interfaccia.

Potresti per favore prendere in considerazione l’indagine su questo problema specificamente per il tema Horizon ed esplorare opzioni per regolare la larghezza della barra laterale per una migliore presentazione dei titoli più lunghi? Credo che affrontare questo problema migliorerebbe l’esperienza utente per molti utenti del tema Horizon.

Grazie per il tuo duro lavoro e per aver preso in considerazione questo suggerimento.

2 Mi Piace

Oggetto: Malfunzionamento del componente discoTOC in località persiana

Ambiente: Forum con Località predefinita impostata su “Persiano”.

Componente interessato: discoTOC

Descrizione: Quando la località predefinita del forum è configurata su “Persiano”, il componente discotoc non funziona correttamente.

Sintomi specifici:

  1. Gli elementi dell’interfaccia utente per i pulsanti “Timeline” e “Contents” non vengono visualizzati.
  2. Dopo che un utente invia una risposta a un argomento, la visualizzazione della tabella dei contenuti viene automaticamente nascosta, viene visualizzata la visualizzazione della timeline e non viene fornito alcun elemento interattivo per ripristinare la visualizzazione della tabella dei contenuti.

In merito alle istruzioni di cui sopra sull’utilizzo del componente discoTOC, ho alcune domande tecniche per chiarimenti:

  1. Il passaggio 1 menziona la scrittura di un argomento con intestazioni e il passaggio 2 menziona l’uso di un pulsante specifico. Se seguo il passaggio 1 strutturando il mio argomento con intestazioni markdown (ad es. ##, ###) ma ometto di fare clic sul “pulsante TOC” nel menu a ingranaggio (passaggio 2), il componente discoTOC genererà o visualizzerà comunque automaticamente l’indice basandosi esclusivamente sulle intestazioni? In sostanza, fare clic sul pulsante è obbligatorio affinché il componente funzioni correttamente, o è semplicemente un trigger per inserire un elemento specifico?
  2. Qual è lo scopo o la funzionalità precisa del “pulsante TOC” situato nel menu a ingranaggio? Come è inteso che questo pulsante venga utilizzato nel flusso di lavoro dell’editor di argomenti?
  3. Separatamente, ho incontrato lo snippet <div> data-theme-toc="true"> </div>. Potresti spiegare il suo ruolo esatto in congiunzione con discoTOC? Cosa controlla questo elemento div e come dovrebbe essere implementato o configurato all’interno del contenuto dell’argomento per influenzare la generazione o la visualizzazione dell’indice?

Grazie per la tua spiegazione dettagliata.

Non sono sicuro che sia abbastanza tecnico, ma il componente necessita sia del <div> data-theme-toc="true"> </div> che di alcune intestazioni nel post per poter generare un TOC corretto.

Senza inserire il <div> data-theme-toc="true"> </div>, il post sarà semplicemente un post con intestazioni, e aggiungendo questo senza includere alcuna intestazione non genererà un TOC (c’è anche un’impostazione TOC min heading nel componente, che per impostazione predefinita è 3. Quindi avresti bisogno di almeno 3 intestazioni nel tuo post per generare un TOC visibile)

Il pulsante “insert table of contents” inserisce il <div> data-theme-toc="true"> </div> nel post, anche se puoi copiarlo o digitarlo manualmente allo stesso effetto.

Spero che questo aiuti. :crossed_fingers:


ETA: Ho appena ricevuto un gentile promemoria che se stai usando le impostazioni del componente Auto TOC categories e Auto TOC tags, allora inserire il <div> data-theme-toc="true"> </div> non è necessario in quei casi. :+1:

7 Mi Piace

Inoltre… ora c’è un’impostazione per questo (Abilita TOC per le risposte), quindi puoi avere un TOC in una risposta. :partying_face:

4 Mi Piace

mi chiedo se sia possibile renderlo un TOC predefinito per le risposte se una risposta ha diversi livelli di struttura…
o c’è qualche preoccupazione al riguardo?

Dopo aver usato i ToC di reply per un po’, penso che abbia molto senso.

Solo gli utenti esperti (cioè solo io sui nostri siti) si prendono la briga di aggiungere manualmente un ToC. Avere questa funzione automatica sarebbe estremamente utile.

3 Mi Piace

Sto riscontrando alcuni problemi:

  1. Se provo a creare il TOC su un argomento che è stato creato senza il TOC, non funziona. È normale? Sembra funzionare solo se creo l’argomento con il TOC. Modificare un argomento non funziona.
  2. Sull’argomento che ho creato con successo con il TOC, quando faccio clic sulle intestazioni nel TOC, non scorre fino all’intestazione.
  3. Sembra creare il TOC solo per le intestazioni ##. Ho intestazioni ###, ma quelle non vengono mostrate.

L’ho fatto di recente qui su Meta nel mio argomento del componente tema e ha funzionato

1 Mi Piace

Strano… quando l’ho salvato non veniva visualizzato, quindi forse dovevo aggiornare la pagina? Mi aspettavo che apparisse subito.

Bene sapere che ora viene visualizzato.

(Per chiarire, sono riuscito ad aggiungere il testo che hai aggiunto nella tua immagine, ma il TOC non veniva visualizzato sul lato destro).

Per quanto riguarda gli altri problemi, ora funziona anche quello. Non capisco… vai a capire…

Sai se è possibile disabilitare il comportamento per cui le sottodivisioni vengono nascoste quando la divisione principale non è “a fuoco”?
Vorrei che tutte le divisioni fossero sempre visibili, altrimenti sembra che ci sia meno contenuto di quanto ce ne sia in realtà.

Sono già felice di sapere che funziona come previsto, quindi questo è solo un dettaglio che sarebbe la ciliegina sulla torta, se possibile da realizzare.