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.

results matching ""

    No results matching ""