Documentazione sull’estensione di Discourse tramite plug-in, temi e componenti tematici, sul lavoro con il codice principale e sull’utilizzo dell’API di Discourse.
Introduzione
- Introduzione: Introduzione allo sviluppo di Discourse
Ambienti di sviluppo
- Dev Container: Sviluppare Discourse utilizzando un Dev Container
- GitHub Codespaces: Sviluppare Discourse su GitHub Codespaces
- Configurazione Docker: Installare Discourse per lo sviluppo tramite Docker
- Configurazione macOS: Installare Discourse su macOS per lo sviluppo
- Configurazione Ubuntu/Debian: Installare Discourse su Ubuntu o Debian per lo sviluppo
- Configurazione Windows: Installare Discourse su Windows per lo sviluppo
- Plug-in non Docker: Installare plug-in nell’ambiente di sviluppo non Docker
- Configurazione locale: Configurare un ambiente di sviluppo Discourse locale?
- Configurazione multisito: Configurare un ambiente di sviluppo multisito
- Configurazione Fedora: Configurare Discourse per lo sviluppo su Fedora Linux
Codice e funzionalità interne
- Componenti Ember: Aggiungere componenti Ember a Discourse
- UI kit: La UI kit di componenti, helper e modifier condivisi di Discourse
- Lint e formattazione: Eseguire automaticamente il lint e la formattazione del codice prima dei commit
- Test di accettazione: Scrivere test di accettazione per il codice Ember in Discourse
- Esecuzione suite di test: Come eseguire le suite di test QUnit del core di Discourse, dei plug-in e dei temi
- Compatibilità versione: Fissare le versioni dei plug-in e dei temi per installazioni Discourse più vecchie (branch d-compat)
- Proprietà degli oggetti Ember: Proprietà degli oggetti Ember (getOwner, iniezioni di servizi, ecc.)
- Prestazioni JS: Utilizzare ‘tachometer’ di Google per misurare le variazioni di prestazioni JS in Discourse
- CI con GitHub Actions: Configurare l’integrazione continua utilizzando GitHub Actions
- Estensioni Markdown: Guida per sviluppatori alle estensioni Markdown
- Conversione modal: Convertire le modal dai controller legacy alla nuova API dei componenti DModal
- API DModal: Utilizzare l’API DModal per renderizzare le finestre modal (noti anche come popup/dialoghi) in Discourse
- API JS: Utilizzare l’API JS
- Connettori outlet dei plug-in: Utilizzare i connettori outlet dei plug-in da un tema o plug-in
- modifyClass: Utilizzare modifyClass per modificare il comportamento del core
- Creazione di rotte: Creare rotte in Discourse e visualizzare dati
- Metodo di autenticazione: Aggiungere un nuovo metodo di autenticazione ‘gestito’ a Discourse
- Serializzazione accidentale dei modelli ActiveRecord: Prevenire la serializzazione accidentale dei modelli ActiveRecord
- Override dei template: (non consigliato) Eseguire l’override dei template di Discourse da un tema o plug-in
- Oggetti di servizio: Utilizzare gli oggetti di servizio in Discourse
- Specifiche di sistema: Scrivere specifiche di sistema end-to-end per l’interfaccia utente di Discourse
- FormKit: Toolkit Discourse per renderizzare i form.
- Trigger AppEvents: Riferimento ai trigger AppEvents
- Transformer: Utilizzare i Transformer per personalizzare valori e comportamenti lato client
- Personalizzazione della lista argomenti: Personalizzare la lista degli argomenti
- Linee guida CSS: Linee guida per le classi CSS utilizzando BEM
- Suggerimenti e validazione dei tipi JS: Suggerimenti e validazione dei tipi JavaScript (typescript)
- Progettazione per dispositivi: Progettazione per diversi dispositivi (Touch & Hover)
- Progettazione per larghezze responsive: Progettazione per larghezze responsive (Breakpoint, Viewport e Contenitori)
- Primitivi di gesto: Primitivi di trascinamento, ridimensionamento e gesto
- Divisione dei bundle: Divisione dei bundle per i plug-in
- Moduli privati: Moduli privati e la convenzione
-internals - Test dei componenti: Scrivere test dei componenti per Discourse
Plug-in
- Plug-in di base: Sviluppare plug-in Discourse - Parte 1 - Creare un plug-in di base
- Outlet del plug-in: Sviluppare plug-in Discourse - Parte 2 - Connettersi a un outlet del plug-in
- Impostazioni del sito: Sviluppare plug-in Discourse - Parte 3 - Aggiungere impostazioni personalizzate del sito
- Configurazione Git: Sviluppare plug-in Discourse - Parte 4 - Configurare git
- Interfaccia di amministrazione: Sviluppare plug-in Discourse - Parte 5 - Aggiungere un’interfaccia di amministrazione
- Test di accettazione: Sviluppare plug-in Discourse - Parte 6 - Aggiungere test di accettazione
- Pubblicare il plug-in: Sviluppare plug-in Discourse - Parte 7 - Pubblicare il tuo plug-in
- Nuove localizzazioni: Aggiungere una nuova localizzazione da un plug-in
- Integrazione chat: Aggiungere un nuovo provider a discourse-chat-integration
- Estensione markdown-it: Rimpacchettare un’estensione markdown-it come plug-in Discourse
- Autoloading Rails: Strutturare un plug-in per l’autoloading di Rails
Temi e componenti
- Sviluppo dei temi: Sviluppare temi e componenti tematici di Discourse
- Guida rapida di riferimento: Guida rapida di riferimento per lo sviluppatore di temi
- Guida per designer: Guida del designer per iniziare con i temi in Discourse
- Theme Creator: Iniziare con Theme Creator e la Theme CLI
- Theme CLI: Installare l’app console Discourse Theme CLI per aiutarti a costruire temi
- Struttura dei temi: Struttura dei temi e dei componenti tematici
- File JS multipli: Dividere il Javascript dei temi in più file
- File SCSS multipli: Dividere lo SCSS dei temi in più file
- Impostazioni del tema: Aggiungere impostazioni al tuo tema Discourse
- Oggetti per le impostazioni del tema: Tipo Objects per l’impostazione del tema
- Migrazione delle impostazioni: Migrare le impostazioni del tema Discourse
- Metadati del tema: Aggiungere metadati e screenshot a un tema
- Variabili del core: Utilizzare le variabili del core di Discourse nel tuo tema
- Stringhe localizzabili: Aggiungere stringhe localizzabili a temi e componenti tematici
- Test E2E: Test di sistema end-to-end per temi e componenti tematici
- Minimizzare la manutenzione: Minimizzare la manutenzione delle personalizzazioni dei temi
- Dimensioni del font: Modificare le dimensioni del font nei temi
- Includere asset: Includere asset (ad esempio immagini, font) nei temi e nei componenti
- Icone personalizzate: Sostituire le icone SVG predefinite di Discourse con icone personalizzate in un tema
- Modalità scura: Aggiornare temi e plug-in per supportare la modalità scura automatica
- Modifier del tema: Modifier del tema: una breve introduzione
- Pseudo-elementi: Inserire testo o immagini ovunque sul tuo sito utilizzando gli pseudo-elementi CSS
- Componente font: Creare e condividere un componente tematico per i font
- Linguaggio Highlight.JS: Installare un nuovo linguaggio per Highlight.JS tramite un componente tematico
- Contenuto della homepage: Aggiungere contenuto personalizzato che appare solo sulla tua homepage
- Formato dei messaggi: Supporto per il formato dei messaggi per la localizzazione
- Modifiche globali delle icone: Modificare le icone globalmente
- Icone alternative: Icone alternative
- Stile dei post wiki: Modificare lo stile di un post wiki
- Schema di colori: Creare e condividere uno schema di colori
- Menu di navigazione: Utilizzare il parametro di query
navigation_menuper anteprima la sidebar o altre opzioni - Stili dei contenuti dei post: Personalizzare il contenuto dei post con i propri stili
- Screenshot dei temi: Aggiungere screenshot di anteprima ai temi Discourse
- Impostazioni del sito personalizzabili: Controllare le impostazioni del sito con i temi
Guide generali
- App mobili white-labelling: Considerazioni prima di decidere il white-labeling delle app mobili Discourse
- Automazioni personalizzate: Creare automazioni personalizzate
- Dump di dati pubblici: Dump di dati pubblici di Discourse
- Valutazioni AI: Eseguire le valutazioni dell’AI di Discourse
- Bot AI tramite API: Utilizzare il bot AI tramite l’API di Discourse
Tutorial per lo sviluppo di temi
- 1 - Introduzione: Tutorial per lo sviluppatore di temi: 1. Introduzione
- 2 - Tema remoto: Tutorial per lo sviluppatore di temi: 2. Creare un tema remoto
- 3 - CSS: Tutorial per lo sviluppatore di temi: 3. Il CSS nei temi
- 4 - Outlet: Tutorial per lo sviluppatore di temi: 4. Utilizzare gli outlet per inserire e sostituire contenuti
- 5 - Componenti: Tutorial per lo sviluppatore di temi: 5. Costruire e utilizzare i componenti
- 6 - API JS: Tutorial per lo sviluppatore di temi: 6. Utilizzare l’API JS
- 7 - Conclusione: Tutorial per lo sviluppatore di temi: 7. Conclusione