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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
#use wml::debian::ddp title="SVN del Debian Documentation Project"
#use wml::debian::toc
#use wml::debian::translation-check translation="bf1a0486dfbf35e11a7ff98a29d9e2e4f2eda3f3" maintainer="skizzhg"
<p>Il "Debian Documentation Project" (Progetto di documentazione Debian) deposita
le sue pagine web e la maggior parte dei
manuali sul server subversion <strong>svn.debian.org</strong>.
svn.debian.org è parte dell'installazione Gforge su alioth.debian.org.
Si legga la <a href="https://wiki.debian.org/Alioth">Alioth documentation</a>
per ulteriori informazioni sul funzionamento di questo servizio.
</p>
<p>Chiunque può scaricare i sorgenti dal server SVN. Solo i membri del
Debian Documentation Project possono aggiornare i file.</p>
<toc-display />
<toc-add-entry name="access">Accedere ai sorgenti nel SVN</toc-add-entry>
<p>Si può utilizzare un'interfaccia web per accedere a dei singoli file e
per vedere le loro modifiche all'indirizzo <url "https://anonscm.debian.org/viewvc/ddp/manuals/trunk/" /></p>
<p>Per scaricare un intero manuale, l'accesso diretto al server SVN
è spesso la cosa migliore. Sarà necessario il
pacchetto <tt><a href="https://packages.debian.org/subversion">subversion</a></tt> sul vostro
computer.</p>
<h3>Connessione anonima (solo lettura) al server SVN</h3>
<p>Usate questo comando per scaricare tutti i file:</p>
<p style="margin-left: 2em">
<code>svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
</p>
<p>Questo comando crea ricorsivamente le directory e le popola.</p>
<p>Per aggiornare la vostra copia locale con qualsiasi modifica fatta da altre persone, entrate
nella directory <strong>manuals</strong> ed usate il comando:</p>
<p style="margin-left: 2em">
<code>svn export --force svn://svn.debian.org/svn/ddp/manuals</code>
</p>
<h3>Connessione al server SVN con i privilegi di aggiornamento (svn)</h3>
<p>Prima di accedere al server SVN usando questo metodo dovete ottenere
l'accesso in scrittura. Si legga prima come <a
href="#obtaining">richiedere</a> il permesso di aggiornamento.</p>
<p>Usate questo comando per scaricare tutti i file:</p>
<p style="margin-left: 2em">
<code>svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
</p>
<p>Questo comando crea ricorsivamente le directory e le popola.</p>
<p>Per aggiornare la vostra copia locale con qualsiasi modifica fatta da altre persone, entrate
nella directory <strong>manuals</strong> ed eseguite il comando:</p>
<p style="margin-left: 2em">
<code>svn update</code>
</p>
<h3>Connessione al server SVN con i privilegi di aggiornamento (git-svn)</h3>
<p>Prima di accedere al server SVN usando questo metodo dovete ottenere
l'accesso in scrittura. Si legga come <a
href="#obtaining">richiedere</a> l'autorizzazione per l'aggiornamento.</p>
<p>Usate questo comando per scaricare tutti i file:</p>
<p style="margin-left: 2em">
<code>git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals</code>
</p>
<p>Questo comando crea ricorsivamente le directory e le popola, crea
inoltre un repository git locale privo della cronologia più vecchia che
può tracciare il server alioth SVN.</p>
<p>Per aggiornare la vostra copia locale con qualsiasi modifica fatta da
altre persone, entrate nella directory <strong>manuals</strong> ed
eseguite il comando:
<p style="margin-left: 2em">
<code>git svn rebase</code>
</p>
<toc-add-entry name="obtaining">Ottenere i privilegi di aggiornamento</toc-add-entry>
<p>I privilegi di aggiornamento sono disponibili per chiunque voglia partecipare alla
scrittura dei manuali. Solitamente è richiesto che abbia già proposto
un paio di "patch" utili.</p>
<p>Per ottenerli, si invii una domanda, alla mailing list
<a href="mailto:debian-doc@lists.debian.org">Debian documentation</a>,
spiegando il motivo per cui si ha bisono dell'accesso i nscrittura ed indicando
il proprio login name per <a href="https://alioth.debian.org">Alioth</a>.
Quando la richiesta sarà approvata si farà parte del <a
href="https://alioth.debian.org/projects/ddp"><q>ddp</q> project</a> (e
del gruppo Unix) on Alioth.</p>
<hr />
# Disabled (obsolete)
#<toc-add-entry name="organization">Organizzazione dei file</toc-add-entry>
#
#<p>Questa figura mostra la struttura dell'albero delle directory CVS:
#</p>
#<div class="center">
#<img src="dirtree.jpg" alt="Albero delle directory CVS del DDP" />
#</div>
#
#<p>Notare che il sito web del DDP è situato nel modulo webwml del
#repository CVS Debian, per essere integrato con le altre pagine web
#Debian.</p>
#
#<hr />
<h1>Meccanismo di aggiornamento automatico</h1>
<p>Le pagine web dei manuali sono generate su
www-master.debian.org durante il regolare processo di <q>rebuilding</q> del sito web,
che viene effettuato ogni quattro ore.</p>
<p>Il processo è impostato in modo da scaricare le versioni più recenti dei
pacchetti dall'archivio, ricompilare ciscun manuale e installare i file nella
sottodirectory <code>doc/manuals/</code> del sito web.</p>
<p>I file della documentazione creata dallo script di aggiornamento possono
essere trovati su
<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
<p>I file di log creati dal processo di aggiornamento possono essere trovati
in <url "https://www-master.debian.org/build-logs/ddp/" /> (il nome dello
script è <code>7doc</code> e viene eseguito in quanto fa parte del lavoro
di cron <code>often</code>).</p>
# <p>Si noti come questo processo rigenera la directory <code>/doc/manuals/</code>.
# I contenuti della directory <code>/doc/</code> sono creati
# o da <a href="/devel/website/desc">webwml</a> o da altri script,
# come quelli contenuti nei pacchetti di alcuni manuali.</p>
# <!-- Created: Mon Jul 6 19:58:09 BST 1998 -->
|
