diff --git a/README.md b/README.md index df21c21da63f4f44567605d7c8dbf7a52d559d71..9470689309414d20cbde22dcf385062a7c627fec 100644 --- a/README.md +++ b/README.md @@ -21,20 +21,56 @@ Usiamo Composer ([e.g](https://www.smashingmagazine.com/2019/03/composer-wordpr ``` shell apt install composer ``` + Io ho dovuto installare alcune librerie php extra ``` shell apt install php-xml php-zip ``` -Il codice scritto da noi (temi e plugin) si trova nel gruppo @noblogs. Viene tutto rilasciato come pacchetti Composer sul Registry di GitLab. -In questo repository ci sono solo le patch ed i file di configuarazione di composer (al momento, ~8Mb). Il codice vero e proprio di noblogs (l'equivalente di ai/noblogs-wp> per intenderci) abbiamo deciso che non verrà mantenuto in git, dato che viene generato da composer a partire da questo repository. Lanciando ```composer install``` dovrebbe venire tutto generato nella directory ```app/```. +Il codice scritto da noi (temi e plugin) si trova nel gruppo +@noblogs. Viene tutto rilasciato come pacchetti Composer sul Registry +di GitLab. + +In questo repository ci sono solo le patch ed i file di +configuarazione di composer (al momento, ~8Mb). Il codice vero e +proprio di noblogs (l'equivalente di ai/noblogs-wp> per intenderci) +abbiamo deciso che non verrà mantenuto in git, dato che viene generato +da composer a partire da questo repository. Lanciando `composer +install` dovrebbe venire tutto generato nella directory `app/`. * Per aggiornare le dipendenze di noblogs, il comando da usare è ``` shell composer update ``` +### Set up dell'autenticazione + +Siccome alcune dipendenze sono al momento in repository privati, +composer ha bisogno di autenticarsi con git.autistici.org. Per fare +ciò bisogna ottenere un *token di autenticazione* (da dentro Gitlab, +User Settings > Access Tokens, selezionare *read_api*), e poi dare il +comando: + +```shell +composer config gitlab-token.git.autistici.org $PERSONAL_ACCESS_TOKEN +``` + +Questo comando creerà un file *auth.json* con il token: questo file +verrà ignorato da git perché non va assolutamente committato nel +repository. + +### Utilizzo di Docker + +Sfortunatamente la versione di composer in Debian Buster non è +sufficientemente recente, ma si può usare Docker per eseguire la +versione giusta, per esempio: + +```shell +docker run --rm --volume $PWD:/data --workdir /data composer:1.10 composer require noblogs/r2db:0.1.7 +``` + + ## Cosa fa composer Nel repository c'è un file JSON chiamato ```composer.json```, che descrive le dipendenze di Noblogs, più da una certa configurazione alla struttura del suo repository. In questo senso le dipendenze possono essere