Sito
Questo sito è generato con rest2web a partire da sorgenti in reStructuredText gestiti in un repository git.
Istruzioni per la modifica
A seconda della complessità della modifica che si vuole effettuare e della frequenza con la quale si pensa di lavorare sul sito ci sono più modi per effettuare modifiche.
Segnalare un bug
Per modifiche semplici può essere sufficiente inviare un'email ad info AT lifolab DOT org segnalando la modifica che si desidera venga effettuata.
Mandare una patch
Per modifiche più significative di un paio di paragrafi è molto gradito che la richiesta arrivi corredata da una patch generata con git.
Per farlo, innanzitutto bisogna avere una copia locale del repository, ottenuta ad esempio con:
git clone git://git.home.trueelena.org/pages/lifo.git
o aggiornarne una già esistente:
cd $REPO git pull
Si possono quindi effettuare le modifiche che si desiderano, ricordandosi di aggiungere i file modificati e completare un commit per ogni divisione logica delle aggiunte:
git add file1.txt git add file2.txt git commit -m "Modificata pagina 1 e suo riferimento nella pagina 2"
Se necessario, controllare che il repository upstream non sia stato cambiato e far sì che le modifiche si applichino all'ultima versione:
git pull --rebase
A questo punto è possibile generare delle patch con tutti i commit aggiunti rispetto ad upstream:
git format-path origin/master
ed inviarle ad info AT lifolab DOT org come attachment, ad esempio con:
git send-email --to=info@lifolab.org 00*.patch
(controllare in man git-send-email eventuali altre opzioni necessarie, come ad esempio --smtp-server=<host>).
Se le modifiche sono significative e/o controverse può essere oppurtuno inviare la patch sulla mailing list, per richiedere opinioni prima di applicarla.
Mandare una pull request
Clonare come sopra il repository, quindi crearne una copia accessibile pubblicamente e pusharvi le proprie modifiche. A quel punto inviare una pull-request ad info@ o alla mailing list, come sopra.
Chiedere accesso al repository
I frequentatori assidui del laboratorio che pensano di voler effettuare molte modifiche al sito possono ovviamente chiedere accesso al repository principale, in modo da essere autonomi.