Questo plugin sta venendo ritirato a favore del plugin sperimentale Doc Categories. Continueremo a supportare Docs fino a quando il nuovo plugin non sarà più considerato sperimentale.
 |
Riepilogo | Discourse Docs offre la possibilità di trovare e filtrare argomenti della knowledge base |
 |
Link al Repository | https://github.com/discourse/discourse-docs |
 |
Guida all’installazione | Come installare i plugin in Discourse |
Funzionalità
Il plugin Discourse Docs è uno strumento potente che trasforma il tuo forum Discourse in una knowledge base alimentata dalla comunità. Fornisce una sezione dedicata Docs dove gli utenti possono creare, aggiornare e curare la documentazione. Questo plugin include un pulsante Docs che permette un facile accesso a questa sezione. È un ottimo modo per sfruttare la conoscenza collettiva della tua comunità e fornire una risorsa centralizzata per informazioni importanti.
In sostanza, Docs permette di rendere più semplici gli argomenti in stile knowledge base attraverso un insieme definito di categorie e/o tag.
Filtra l’elenco per tag, cerca tramite la barra di ricerca e clicca sugli argomenti per vedere il primo post: tutto senza uscire dal contesto dell’esploratore della conoscenza.
Devi trovare un argomento della knowledge base da un’altra parte di Discourse? Usa il nuovo assistente di ricerca: in:kb.
Configurazione
-
Abilita il plugin attivando l’impostazione
docs enabled. -
Aggiungi categorie e tag alle impostazioni
docs categoriesedocs tags. -
Trova il link Docs nel menu di navigazione.
- Goditi un accesso più semplice alla conoscenza!
Impostazioni
| Nome | Descrizione |
|---|---|
| docs enabled | Abilita il plugin Docs |
| docs categories | Elenco degli slug delle categorie da includere in Docs |
| show tags by group | Organizza i tag utilizzando i gruppi di tag. Crea gruppi per categorizzare tag correlati. |
| docs tag groups | I gruppi di tag utilizzati per mostrare i tag per gruppo |
| docs tags | Elenco dei tag da includere in Docs |
| docs add solved filter | Aggiunge un filtro per gli argomenti risolti – richiede che Discourse Solved sia installato e abilitato |
| docs add to top menu | Aggiunge un link al menu superiore per navigare alla vista Docs |
| docs add search menu tip | Aggiunge il suggerimento “in:docs” ai suggerimenti casuali del menu di ricerca |
Abbinamenti utili
Rinominare il percorso /docs
Se hai accesso al tuo server, puoi modificare il percorso del tuo link /docs aggiungendo una variabile d’ambiente DISCOURSE_DOCS_PATH: al tuo file app.yml:
Affinché la modifica abbia effetto, puoi eseguire ./launcher rebuild app oppure, dato che si tratta di una variabile d’ambiente, puoi eseguire ./launcher destroy app && ./launcher start app per ridurre al minimo i tempi di inattività. Ci sono ulteriori informazioni a riguardo qui - Set Environmental Variables
Potresti anche voler modificare il testo visualizzato sul sito per farlo corrispondere. Puoi cercare tutte le istanze di ‘docs’ dalla pagina /admin/customize/site_texts, ma quelle principali sono:
- js.docs.title
- js.sidebar.docs_link_text
Ospitato da noi? La rinomina del percorso
/docsè disponibile solo nel nostro piano Enterprise. Contattaci se desideri saperne di più.
Cronologia dello sviluppo
Il plugin Docs è una continuazione del Knowledge Explorer Theme Component.