Base di conoscenza

:warning: La funzionalità di questo componente del tema è stata sostituita dal plugin Discourse Docs

Questo componente del tema abilita una visualizzazione in stile knowledge base per le categorie selezionate.

:link: Link al repository

:link: Anteprima su Theme Creator


Viene aggiunto un pulsante KB ai pilastri di navigazione per tutte le categorie abilitate nelle impostazioni.

Una volta attivata la visualizzazione, il knowledge base mostra una versione semplificata dell’elenco degli ultimi argomenti.

Clicca su un tag nella barra laterale e l’elenco degli argomenti si filtrerà automaticamente in base a quel tag. Puoi selezionare quanti tag desideri e l’elenco dei tag mostrerà solo quelli aggiunti agli argomenti filtrati, facilitando la navigazione tra molta documentazione.

Vuoi cercare? Basta digitare un termine nella casella. I risultati della ricerca sono limitati anche ai tag selezionati.

Considerazioni

Le seguenti impostazioni del sito sono obbligatorie affinché questo componente funzioni: tagging enabled e show filter by tag.

Questo componente del tema non ha attualmente una visualizzazione mobile.

Detto questo, stiamo lavorando alla creazione di una versione più avanzata di questa funzionalità. Ti informeremo qui su Meta quando sarà pronta!

27 Mi Piace

Questo commit aggiunge ora una visualizzazione mobile di base.

Tieni presente che non è perfetto: se ci sono molti tag, è necessario scorrere su di essi. Sto valutando alcune idee per risolvere il problema.

9 Mi Piace

Usiamo Discourse come nostra Knowledge Base da oltre 4 anni e abbiamo circa 350 post specifici per la KB, quindi è molto entusiasmante!

Non sono sicuro che questo sia possibile tramite un componente del tema, ma esiste un modo per impostare questa “vista” come predefinita quando qualcuno apre una categoria? In modo che invece di andare a: /c/knowledge-base, venga caricato automaticamente /c/knowledge-base?kb=active?

Abbiamo abilitato il componente del tema KB e ci piace molto, ma temiamo che le persone non vedano la vista KB perché stanno usando il link /c/knowledge-base che avevano precedentemente salvato nei preferiti.

Grazie per il vostro lavoro su questo.

6 Mi Piace

Valuterò di aggiungere un’impostazione per questo! Grazie per il suggerimento, e sono contento che tu lo trovi utile.

6 Mi Piace

Questa funzionalità è ora implementata come impostazione del tema. Sono supportate anche le sottocategorie!

9 Mi Piace

Aggiornato. Sembra ottimo, grazie!

3 Mi Piace

Come si applica questo a una sottocategoria? Esiste una sintassi speciale?

Grazie mille per questo! Abbiamo una categoria nella nostra community che sarebbe perfetta per applicare questo componente, ma stiamo riscontrando un problema: le categorie non appaiono nel menu a tendina “kb categories”, quindi non possiamo selezionare la categoria a cui applicare il componente. Qualche consiglio?

Puoi semplicemente digitare lo slug della categoria e crearla. Non è estremamente intuitivo. Non sono riuscito a capire come ottenere le sottocategorie, ma se la tua categoria è al primo livello è piuttosto semplice.

1 Mi Piace

Ok, davvero poco intuitivo. Ho digitato e ‘creato’ la categoria e ha funzionato. Ma non appare comunque come previsto.

Ho fatto un’installazione pulita di Discourse per testare, impostando entrambi i componenti:

br%20a170a9ec422c

(D.I.Y. / diy è la categoria per cui voglio abilitare la Knowledge Base, e ha un link superiore specifico creato con il componente Link di navigazione superiori personalizzati)

br%2086f9546a1534

Ma la categoria D.I.Y. appare con la visualizzazione normale:

L’URL mostra alla fine: /c/diy?kb=active

1 Mi Piace

Nessuna sintassi speciale: basta inserire lo slug della categoria (sia essa una sottocategoria o meno) nell’impostazione del tema kb categories, aggiornare il browser e dovrebbe funzionare.

Questa è una limitazione delle impostazioni del tema al momento: dovrai inserire manualmente lo slug, come suggerito da @Sean_R.

Sei riuscito a risolvere @TowerBR? Hai aggiornato la pagina dopo aver aggiunto la categoria all’impostazione? Hai cliccato sul pulsante KB? Scusa per le domande banali, ma sto cercando di capire cosa non va.

1 Mi Piace

Ha funzionato, grazie :slight_smile:

Mi piace così perché posso dare lo stesso nome a tutte le mie sottocategorie KB e aggiungerle solo una volta.

Ho notato però che se accedo alla categoria tramite il menu a tendina, non passa automaticamente alla visualizzazione KB.

Tutti gli altri metodi di navigazione sembrano funzionare, tranne il menu a tendina delle sottocategorie.

2 Mi Piace

Hai attivato l’opzione “default to kb view”? L’ho appena testato su un mio sito e sembrava funzionare con le sottocategorie.

2 Mi Piace

Sì, funziona la maggior parte delle volte, ma non quando uso il menu a tendina della sottocategoria per cambiare categoria da una all’altra.

Strano, ok. Se riesci a riprodurlo in modo coerente, fammi sapere e lo esaminerò. Non sono riuscito a far scattare quel comportamento utilizzando il menu a discesa della sottocategoria.

2 Mi Piace

Sì, l’avevo già fatto, vedi l’immagine del post precedente:

br%2086f9546a1534

Ho rimosso il componente “Link di navigazione superiori personalizzati”. Ora si tratta di un’installazione completamente “pulita”:

br%20346e44618d61

Sì, e ho svuotato la cache.

Sì. Quando seleziono la categoria dal menu a tendina principale, viene già caricata la pagina della categoria con /c/diy?kb=active alla fine dell’URL. Quando passo il mouse sopra il pulsante KB, viene mostrata l’URL “normale” senza questo “componente aggiuntivo”, ma quando ci faccio clic non succede nulla.

Stai utilizzando l’ultima versione del componente del tema? Stai utilizzando tests-passed o stable per la tua versione di Discourse?

2 Mi Piace

Accade ogni volta. Posso semplicemente cliccare su “KB” o aggiornare la pagina e il problema si risolve, ma non quando accedo alla categoria dal menu a tendina.

Sì:

params:
   version: tests-passed
3 Mi Piace

È fantastico! L’ho appena installato per dare un’occhiata e posso già vedere che è molto utile.

Questo componente del tema sembra entrare in conflitto con https://meta.discourse.org/t/knowledge-base-plugin/115288 di @angus. Posso confermare che il plugin deve essere disinstallato prima di attivare questo componente del tema; altrimenti, quando si visualizza una categoria della knowledge base, si verifica quanto segue. Notate la strana linea orizzontale accanto al menu e il cerchio che gira.

Mi piacerebbe saperne di più sulla versione avanzata e su ciò che avete in programma. Ecco alcuni feedback:

  • Bug? Quando si seleziona un tag dal menu a sinistra per filtrare in base a quel tag, e poi si clicca su un’altra categoria o su “ultimi”, ecc., quando si clicca di nuovo su KB per tornare alla knowledge base, si scopre che si è ancora filtrati per quel tag.
  • Quando si clicca sul tag sotto un titolo, si viene reindirizzati alla pagina del tag per quel tag, non a una vista filtrata della KB come accade quando si clicca sul tag nel menu a sinistra.
  • Cliccando sul titolo della categoria dei tag nel menu a sinistra, si viene portati alla vista “ultimi” per quella categoria. Suggerirei di non rendere questo titolo un link. Inoltre, il titolo della categoria probabilmente non dovrebbe contenere #, che è di distrazione.
  • Sarebbe utile vedere il numero di argomenti con ogni tag nel menu a sinistra.
  • Sarebbe utile poter ordinare gli argomenti della KB in ordine alfabetico o anche in un ordine personalizzato.
4 Mi Piace