Documentazione sull’estensione di Discourse con plugin, temi e componenti di tema, sulla gestione del 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 utilizzando 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
- Plugin non-Docker: Installare plugin nel tuo ambiente di sviluppo non-Docker
- Configurazione locale: Come configurare un ambiente di sviluppo locale per Discourse?
- Configurazione multisito: Configurare un ambiente di sviluppo multisito
- Configurazione Fedora: Configurare Discourse per lo sviluppo su Fedora Linux
Codice e aspetti interni
- Componenti Ember: Aggiungere componenti Ember a Discourse
- UI kit: Il kit di interfacce utente con componenti, helper e modificatori condivisi di Discourse
- Lint e formattazione: Lint e formattazione automatica del codice prima dei commit
- Test di accettazione: Scrivere test di accettazione e test dei componenti per il codice Ember in Discourse
- Esecuzione delle suite di test: Come eseguire le suite di test QUnit di Discourse core, plugin e temi
- Compatibilità delle versioni: Fissare le versioni di plugin e temi per installazioni più vecchie di Discourse (rami d-compat)
- Proprietà degli oggetti Ember: Proprietà degli oggetti Ember (getOwner, iniezioni di servizi, ecc.)
- Prestazioni JS: Utilizzo di ‘tachometer’ di Google per misurare le variazioni delle prestazioni JS in Discourse
- CI con GitHub Actions: Configurazione dell’Integrazione Continua utilizzando GitHub Actions
- Estensioni Markdown: Guida per sviluppatori alle estensioni Markdown
- Conversione dei modali: Conversione dei modali dai controller legacy alla nuova API del componente DModal
- API DModal: Utilizzo dell’API DModal per rendere finestre modali (alias popup/dialoghi) in Discourse
- API JS: Utilizzo dell’API JS
- Connettori di uscita dei plugin: Utilizzo dei Connettori di Uscita dei Plugin da un Tema o da un Plugin
- modifyClass: Utilizzo di modifyClass per modificare il comportamento del core
- Creazione delle rotte: Creazione delle rotte in Discourse e visualizzazione dei dati
- Metodo di autenticazione: Aggiunta di un nuovo metodo di autenticazione ‘gestito’ a Discourse
- Serializzazione accidentale dei modelli ActiveRecord: Prevenire la serializzazione accidentale dei modelli ActiveRecord
- Sovrascrittura dei template: (non consigliato) Sovrascrivere i template di Discourse da un Tema o da un Plugin
- Oggetti di servizio: Utilizzo di oggetti di servizio in Discourse
- Specifiche di sistema: Scrivere specifiche di sistema end-to-end per l’interfaccia utente di Discourse
- FormKit: Toolkit di Discourse per il rendering di moduli.
- Trigger di AppEvents: Riferimento ai trigger di AppEvents
- Trasformatori: Utilizzo dei Trasformatori per personalizzare valori e comportamenti lato client
- Personalizzazione dell’elenco dei topic: Personalizzazione dell’elenco dei topic
- Linee guida CSS: Linee guida per le classi CSS utilizzando BEM
- Suggerimenti di tipo e validazione JS: Suggerimenti di tipo e validazione JavaScript (typescript)
- Progettazione per dispositivi: Progettazione per diversi dispositivi (Touch & Hover)
- Progettazione per larghezze responsive: Progettazione per larghezze responsive (Breakpoint, Viewport e Containner)
- Primitive di gesto: Primitive per trascinamento, ridimensionamento e gesti
- Divisione dei bundle: Divisione dei bundle per i plugin
Plugin
- Plugin di base: Sviluppo di plugin per Discourse - Parte 1 - Creare un plugin di base
- Uscita del plugin: Sviluppo di plugin per Discourse - Parte 2 - Collegamento a un’uscita del plugin
- Impostazioni del sito: Sviluppo di plugin per Discourse - Parte 3 - Aggiunta di impostazioni personalizzate del sito
- Configurazione Git: Sviluppo di plugin per Discourse - Parte 4 - Configurazione di git
- Interfaccia di amministrazione: Sviluppo di plugin per Discourse - Parte 5 - Aggiunta di un’interfaccia di amministrazione
- Test di accettazione: Sviluppo di plugin per Discourse - Parte 6 - Aggiunta di test di accettazione
- Pubblicazione del plugin: Sviluppo di plugin per Discourse - Parte 7 - Pubblicazione del tuo plugin
- Nuove lingue: Aggiungere una nuova lingua da un plugin
- Integrazione chat: Aggiungere un nuovo provider a discourse-chat-integration
- Estensione markdown-it: Ripacchettamento di un’estensione markdown-it come plugin Discourse
- Autoloading Rails: Strutturazione di un plugin per l’autoloading di Rails
Temi e Componenti
- Sviluppo di temi: Sviluppo di temi e componenti di tema per Discourse
- Riferimento rapido: Guida di riferimento rapido per sviluppatori di temi
- Guida per designer: Guida per designer per iniziare con i temi in Discourse
- Theme Creator: Iniziare con Theme Creator e la CLI dei temi
- CLI dei temi: Installare l’app console CLI dei temi di Discourse per aiutarti a creare temi
- Struttura dei temi: Struttura dei temi e dei componenti di tema
- Più file JS: Dividere il JavaScript del tema in più file
- Più file SCSS: Dividere l’SCSS del tema in più file
- Impostazioni del tema: Aggiungere impostazioni al tuo tema di Discourse
- Oggetti per le impostazioni del tema: Tipo di oggetto per l’impostazione del tema
- Migrazione delle impostazioni: Migrare le impostazioni del tema di Discourse
- Metadati del tema: Aggiunta di metadati e screenshot a un Tema
- Variabili core: Utilizzo delle variabili core di Discourse nel tuo Tema
- Stringhe localizzabili: Aggiunta di stringhe localizzabili a temi e componenti di tema
- Test E2E: Test di sistema end-to-end per temi e componenti di tema
- Minimizzazione della manutenzione: Minimizzare la manutenzione delle personalizzazioni del tema
- Dimensioni dei caratteri: Cambiare le dimensioni dei caratteri nei tuoi temi
- Inclusione di asset: Includere asset (ad es. immagini, font) in temi e componenti
- Icone personalizzate: Sostituire le icone SVG predefinite di Discourse con icone personalizzate in un tema
- Modalità scura: Aggiornare temi e plugin per supportare la modalità scura automatica
- Modificatori del tema: Modificatori del tema: una breve introduzione
- Pseudo-elementi: Inserire testo o immagini ovunque sul tuo sito utilizzando pseudo-elementi CSS
- Componente font: Creare e condividere un componente di tema per i font
- Lingua Highlight.JS: Installare una nuova lingua per Highlight.JS tramite un componente di tema
- Contenuto della homepage: Aggiungere contenuti personalizzati che vengono visualizzati solo sulla homepage
- Formato messaggio: Supporto per Message Format per la localizzazione
- Modifiche globali delle icone: Cambiare le icone globalmente
- Icone alternative: Icone alternative
- Stile dei post wiki: Cambiare 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 visualizzare in anteprima la barra laterale o altre opzioni - Stili dei contenuti dei post: Personalizzare i contenuti dei post con i tuoi stili
- Screenshot dei temi: Aggiunta di screenshot di anteprima ai temi di Discourse
- Impostazioni del sito tematizzabili: Controllo delle impostazioni del sito con i temi
Guide generali
- White-labelling delle app mobili: Cose da considerare prima di decidere di white-labelizzare le app mobili di Discourse
- Automazioni personalizzate: Creare Automazioni personalizzate
- Dump dati pubblici: Dump dati pubblici di Discourse
- Valutazioni AI: Eseguire valutazioni AI di Discourse
- Bot AI tramite API: Utilizzo del bot AI tramite l’API di Discourse
Tutorial per sviluppatori di temi
- 1 - Introduzione: Tutorial per sviluppatori di temi: 1. Introduzione
- 2 - Tema remoto: Tutorial per sviluppatori di temi: 2. Creazione di un tema remoto
- 3 - CSS: Tutorial per sviluppatori di temi: 3. CSS nei temi
- 4 - Uscite: Tutorial per sviluppatori di temi: 4. Utilizzo delle Uscite per inserire e sostituire contenuti
- 5 - Componenti: Tutorial per sviluppatori di temi: 5. Costruzione e utilizzo dei componenti
- 6 - API JS: Tutorial per sviluppatori di temi: 6. Utilizzo dell’API JS
- 7 - Conclusione: Tutorial per sviluppatori di temi: 7. Riepilogo