Posso usare un link esterno qui? E usare _blank per aprire una nuova scheda?
Puoi iniziare con una breve descrizione opzionale della categoria.
## Test esterno
* Google: https://google.com
## Prima sezione
* https://discourse.example.com/t/topic-title/12
* https://discourse.example.com/t/another-topic-title/34
* Titolo breve: https://discourse.example.com/t/topic-with-a-long-title/56
* Altro titolo: https://discourse.example.com/t/another-topic-with-a-long-title/78
## Seconda sezione
* Titolo argomento: https://discourse.example.com/t/documentation-topic/98
* https://discourse.example.com/t/new-topic/76
Le installazioni non supportate riceveranno in genere un link alle installazioni non supportate. Come avviso, poiché qualsiasi problema potrebbe essere in parte correlato.
I plugin, i temi e i componenti dei temi avranno in genere un file relativo al file di compatibilità della versione
L’apertura di questo file fornirà importanti note sulla compatibilità delle versioni. Altri potrebbero averlo all’interno della descrizione. Ad esempio, il plugin Category Moderators enhance ha un avviso di supportare solo il ramo stabile.
Pavilion fornisce la frequenza di aggiornamento consigliata di discourse per garantire che abbiano il tempo di aggiornare i loro componenti aggiuntivi.
Funziona per le sottocategorie? Ho un sito con 6 categorie principali ma voglio la documentazione per ogni categoria, così come la discussione. Non sono sicuro di come ottenere al meglio questo risultato.
Mi sono appena imbattuto in questo e ho un paio di domande, per favore: Come possiamo installarlo sul nostro sito ospitato nel cloud? E quanto tempo pensi che rimarranno attivi i vecchi Documenti?
Non abbiamo ancora una tempistica per la rimozione completa del vecchio plugin, ma non è più in fase di sviluppo attivo. Una volta prese alcune decisioni in merito, pubblicheremo un annuncio per informare tutti!
Poiché questo plugin è ancora #sperimentale, non è disponibile sul nostro hosting, ma stiamo attualmente discutendo internamente e valutando se possiamo rendere disponibile questo plugin. Torneremo qui una volta giunti a una conclusione.
Lo aggiungerò per altri che potrebbero trovarlo confuso, come lo ero io, su cosa fa realmente il plugin.
Con tutte le impostazioni, l’argomento dell’indice, ecc., può sembrare opprimente, oltre a cercare di capire cosa si può fare, come si può usare, ecc. Almeno, ero un po’ confuso finché non ho trovato un modo per capirlo (se mi manca qualcosa qui, sentiti libero di condividerlo).
Quindi, fondamentalmente, il modo in cui lo vedo è: crea le tue categorie come vuoi e poi questo plugin rimuove semplicemente la barra laterale predefinita (con le sezioni per categorie, tag, ecc.) e la sostituisce con un elenco di sezioni e collegamenti all’interno di quelle sezioni a argomenti, categorie, collegamenti esterni, ecc. È semplicemente più facile per me vederla in quel modo. È qualcosa di più focalizzato sulla personalizzazione della barra laterale quando viene visitata una particolare categoria. Qualcosa come: quando viene visitata la categoria A, sostituisci la barra laterale predefinita con quella barra laterale personalizzata fornita dall’argomento dell’indice. Semplice.
5 Mi Piace
mcwumbly
(Dave McClure)
Ha separato questo argomento il
103
Mi chiedo come rendere più visibile l’indice della barra laterale su Docs anche su mobile, perché gli utenti non vedono gli argomenti fino a quando non premono l’icona dell’hamburger.
È meraviglioso su desktop; sfortunatamente, la maggior parte degli utenti utilizza gli smartphone.
Non ci sono troppe opzioni, o direi che non ci sono affatto opzioni. I cellulari non hanno abbastanza spazio.
Questo è uno dei motivi per cui sto pensando di abbandonare completamente i documenti. Circa il 95% dei miei utenti utilizza il cellulare e usa la barra laterale molto raramente o per niente. Quindi curare il menu dei documenti richiede molto tempo e non credo che il rapporto tempo/beneficio sia in equilibrio
Va bene, ho letto tutta questa discussione e ho alcune domande. Capisco che la struttura di questa pagina sia creata da questa pagina, ma allora è necessaria anche una pagina indice per ogni sottocategoria? L’indice per questa pagina, deve essere enorme… o per una qualsiasi delle altre con un sacco di articoli.
Quanto sarebbe difficile implementare un layout in stile xwiki per le pagine che fanno parte della documentazione di un sito Discourse? L’interfaccia utente è abbastanza semplice, spunti la casella alla creazione della pagina dichiarando che questa pagina è documentazione. Ora ti chiede semplicemente qual è il genitore. Nessun genitore? È un argomento di primo livello. Imposti un genitore, la pagina appare sotto quel soggetto/categoria. Questo elimina completamente la necessità di mantenere manualmente le pagine indice. Sembrano un sacco di lavoro extra che non dovrebbe essere necessario. Ed è facile trascurare l’aggiunta di elementi man mano che vengono creati.
Se vai su https://checkin.technospider.com e apri alcuni degli elementi nella barra laterale, puoi vedere come funziona l’annidamento in un esempio reale. Tutta quella barra laterale viene generata dinamicamente semplicemente annidando pagine sotto altre pagine (relazione genitore/figlio). Questo sito ha solo circa 150 pagine, ma mi ci sarebbe voluto il doppio del tempo per completarlo se avessi dovuto creare indici per tutto questo.
E questo mi porta a un problema di interfaccia utente/esperienza utente su come è disposta la barra laterale della documentazione. Una volta che fai clic lontano dalla pagina principale, perdi l’elenco iniziale delle categorie. Dovresti avere un modo per tornare indietro sulla pagina da qualche parte.
Ciascuna delle tue 8 aree principali dovrebbe avere triangoli di espansione in modo che, sia che tu faccia clic sulla casella nella pagina principale, sia sul nome nella barra laterale, si apra semplicemente e non perdi la possibilità di fare clic direttamente su un’altra delle aree principali.
Hai un breadcrumb su ogni articolo finale, ma anche questo manca nelle 8 categorie. Fare clic su “rimuovi filtro” dalle sottocategorie in cima alla pagina mi riporta indietro, ma è molto poco intuitivo. E puoi fare cose strane giocando con i filtri, ad esempio, il bel banner verde scompare se fai clic su “nessuna sottocategoria”.
Sì, quello è per gli argomenti di gestione del sito, la pagina dell’indice è qui. (index è un tag che rivela tutte le pagine dell’indice)
Concordo che deve aver richiesto un bel po’ di lavoro per raccogliere tutti i link delle pagine e metterli ordinatamente in categorie con etichette. Ma il risultato è così bello e utilizzabile!
Sembra decisamente bello, ma come ho detto, ci sono alcuni problemi di usabilità per quanto riguarda la navigazione.
E se il lavoro può essere eliminato, sembra una vittoria per tutti.
Non sto criticando il lavoro svolto, sembra molto bello e dato che non so programmare neanche lontanamente, non posso nemmeno iniziare ad apprezzare quanto lavoro ci sia stato, o quanto altro lavoro richiederebbero i miei suggerimenti.
Va bene per la documentazione minima, ma manca molta formattazione che ho usato nel wiki che ho linkato. A meno che non mi stia sfuggendo qualcosa. Sono ancora abbastanza nuovo a Discourse.
Ad esempio, non riesco a trovare un modo per creare caselle informative/di avviso/di errore.
Per gli self-hoster che utilizzano questo plugin, il nostro aggiornamento più recente richiederebbe una ricostruzione manuale dell’indice. Ciò comporterebbe l’esecuzione di questo rake task:
bundle exec rake doc_categories:build_sidebar
# se l'esecuzione del task precedente fallisce a causa di NoDatabaseError,
# eseguilo con il seguente comando per le configurazioni self-hosted tipiche
sudo -E -u discourse bundle exec rake doc_categories:build_sidebar
Se non sei in grado di eseguire questo rake task, puoi andare alle impostazioni di ciascuna categoria di documentazione, rimuovere l’indice della categoria, salvare, riaggiungerlo e salvare. Ciò li ricostruirebbe e aggiornerebbe anche la cache della categoria.
Perché lo stiamo facendo?
In precedenza, quando la barra laterale doveva essere popolata, analizzavamo al volo ogni argomento dell’indice e li memorizzavamo nella cache. Questo aggiornamento sposta gli indici esistenti per essere supportati dal database invece che da un argomento. Ciò espone il nostro team a maggiori opzioni quando si pensa a modi per migliorare l’UX dell’organizzazione dell’indice.
Aggiornamenti per gli self-hoster