..
   restindex
      page-description:
         Istruzioni su come modificare questo sito
      /description
      tags:
      section: laboratorio
      encoding: UTF8
      initialheaderlevel: 2
   /restindex

   uservalues
      created: 2012-05-04T06:38:00Z
   /uservalues

Sito
====

Questo sito è generato con rest2web_ a partire da sorgenti in 
reStructuredText_ gestiti in un repository git_.

.. _rest2web: http://www.voidspace.org.uk/python/rest2web/
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _git: http://git-scm.com/

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.

.. _`mailing list`: contatti.html

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. 

..
   vim: set filetype=rst sw=3: