blob: 54b14d53eee7280d850837144ad50ad375f7f120 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
..
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:
|
