Consigli per sviluppatori front-end
Questa documentazione tradotta potrebbe non essere aggiornata. Per funzionalità o requisiti più recenti, consultare la documentazione inglese.
Iniziando dalla versione 2.3, wallabag usa webpack per raggruppare le sue risorse.
Modalità sviluppatore
Se il server funziona in modalità sviluppatore, dovete eseguire yarn build:dev per generare i file javascript in uscita per ogni tema. Questi sono chiamati
%theme%.dev.js e sono ignorati da git. Dovete riavviare
yarn build:dev per ogni cambiamento fatto ad uno del file delle risorse
(js, css, pictures, fonts,...).
Ricaricamento in tempo reale
Webpack aggiunge il supporto per il ricaricamento in tempo reale, ciò significa che non dovete rigenerare il file delle risorse per ogni cambiamento e nemmeno ricaricare la pagina manualmente. I cambiamenti sono applicati automaticamente nella pagina web. Impostate semplicemente
l'impostazione use_webpack_dev_server come true in
app/config/config.yml ed eseguite yarn watch ed il gioco è fatto.
Non dimenticate di cambiare use_webpack_dev_server in false quando la funzione di ricaricamento in tempo reale non è utilizzata.
Build di produzione
Quando vorrete fare un commit con i vostri cambiamenti, costruiteli in un ambiente di produzione usando yarn build:prod. Questo costruirà tutte le risorse necessarie per wallabag. Per assicurarsi che ciò funzioni a dovere, dovrete avere il vostro server in modalità produzione, per esempio con
bin/console server:run --env=prod.
Non dimenticate di generare le build di produzione prima di fare un commit!
Stile del codice
Lo stile del codice è controllato da due strumenti: stylelint per (S)CSS e eslint per JS. La configurazione di eslint è basata sul preset base di Airbnb.