Categorie Doc Discourse

Non è necessario indicare al plugin Docs la categoria: questo plugin sostituisce il plugin Docs. Potrebbe essere questo il motivo per cui le cose non funzionano, poiché causerebbe un conflitto con uno che prevale sull’altro.

Tutto ciò che devi fare è assicurarti che doc categories enabled sia selezionato, quindi creare l’argomento indice nella categoria, aggiungendolo alle impostazioni della categoria nel campo Argomento indice. Se hai ancora la categoria impostata nelle vecchie impostazioni del plugin Docs, dovresti rimuoverla da lì.

Ehi Hugh, grazie per la rapida risposta! Se ho detto i plugin Docs, mi scuso. Qui ho installato solo il plugin Doc Categories.

Quindi ecco il utile report per trovare argomenti non indicizzati. Finora ho solo 2 argomenti di prova.

Quindi ecco la schermata delle impostazioni. So di essere vicino, ma mi manca qualche passaggio! Grazie!

Hai impostato l’impostazione della categoria?

Inoltre, come si presenta il tuo indice? È strutturato in questo modo?

Ciao Marc! Sì, la Categoria è impostata (ovviamente) tramite il report sopra, giusto? Ma eccola qui.

La pagina Categoria appare così:

So che mi manca qualcosa. Cosa intendevi con questa pagina: È strutturata così?

Questo link porta a un indice per la Documentation su Meta. Il tuo argomento designato deve assomigliare a quello affinché l’indice venga generato. Dagli screenshot, penso che tu abbia frainteso/letto male qualcosa. Leggi da qui.

Inoltre, un po’ fuori tema, ma forse di notte. Ho bisogno del plugin per il tema della barra laterale per mostrare anche l’indice a destra? o anche quello è automatico? Grazie!

Non sono sicuro di cosa intendi, per quanto ne so la barra laterale è predefinita/principale e non un plugin.

Capito, intendevi per sezioni di intestazione/sottotitolo? Stavo cercando questo nel composer, ma non era evidente (almeno per me) se avessi bisogno di intestazioni HTML come <h1> e cose del genere. Apprezzo ancora le risposte rapide!

Le intestazioni sono h1, i link sono puntati. Puoi letteralmente copiare e incollare l’indice dei metadati, dovrebbe darti un esempio per iniziare se sei in difficoltà.

In questo modo:

## qualcosa di utile
* questo è quello: https://forum.example.tld/t/777
* quello è un altro: https://forum.example.tld/t/666

Eccetera

Sono pigro, quindi non l’ho fatto manualmente, ma ho usato l’IA del forum.

1 Mi Piace

Grazie. Quindi ho copiato una parte dell’indice della documentazione sopra come fornito da @MarcP, semplicemente non vedo l’indice della barra laterale che è strano, a meno che ancora non mi stia perdendo qualcosa…

Quello screenshot non mostra la struttura. Sei assolutamente sicuro che stai usando il modulo
* description: url
e che stai specificando il nome, l’URL o l’ID di quell’argomento nelle impostazioni di quella categoria?

Come questo?

1 Mi Piace

Sì. Se vedi qualcosa di simile in composer (non badare alla lingua molto strana, l’idea dovrebbe essere chiara però):

Tätä käytetään hampurilaisvalikossa esittelemään 20 eniten reaktioita saanutta ketjua kategoriassa #koiramaailma . Eräänlainen mainosikkuna siis.

## Top-20 eniten reagoitua ketjua

* Mitä helvettiä eläinlääkinnässä tapahtuu 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Kuivamuonamainokset: Hassut aidot tapaukset: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479

Quelle descrizioni non vengono visualizzate nella barra laterale.

1 Mi Piace

Beh, come potete vedere, niente sul lato destro :frowning:

Se può essere d’aiuto a qualcuno, ecco l’elenco dei plugin che ho installato…

    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

Di solito la barra laterale è a sinistra (rossa). La barra laterale della documentazione sostituisce semplicemente il contenuto predefinito. Sulla destra (viola) vedi un indice che viene aggiunto dal componente del tema DiscoTOC - automatic table of contents.

Sì, DiscoTOC è anche un componente del tema installato. Non riesco a farlo funzionare neanche. C’è qualcosa che non va…

Non sono sicuro, ma i tuoi screenshot non sono chiari. Stai facendo lo screenshot e non mostri affatto una barra laterale? È la barra laterale del documento che non viene mostrata? O la barra laterale non viene mostrata affatto (non è semplicemente nascosta, prova a premere =)?

Modifica: pensando a questo, dovresti essere chiaro se hai problemi con discoTOC (indice dei contenuti per l’OP) o con le doc-categories (barra laterale dell’indice dei documenti).

1 Mi Piace

Ehi Marc–
Quindi DiscoTOC funziona. Sono tornato indietro per ricontrollare e crea effettivamente un sommario laterale dopo essere andato su ingranaggi e aver inserito il sommario come dicono le istruzioni.
Tutti i miei screenshot includono la barra laterale, quindi sto mostrando il panorama aperto senza barre laterali visibili.
Ho solo questa strana sensazione che sarà una correzione molto semplice, ma non ci sono ancora arrivato :frowning:

Non vedo barre laterali nei tuoi screenshot: mostrano tutti solo il contenuto del post. Potresti pubblicare uno screenshot dell’intera schermata di Discourse quando ti trovi in una categoria che dovrebbe mostrare un indice?

3 Mi Piace