LIFO » Laboratorio » Sito

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.

Invia un commento

Torna all'inizio