Gentoo Archives: gentoo-commits

From: "Davide Cendron (scen)" <scen@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/it/overlays: devguide.xml
Date: Thu, 19 Feb 2009 21:42:53
Message-Id: E1LaGfS-0004X0-3E@stork.gentoo.org
1 scen 09/02/19 21:42:50
2
3 Modified: devguide.xml
4 Log:
5 Version 2.3, revision 1.16 of EN CVS
6
7 Revision Changes Path
8 1.3 xml/htdocs/proj/it/overlays/devguide.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/overlays/devguide.xml?rev=1.3&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/overlays/devguide.xml?rev=1.3&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/overlays/devguide.xml?r1=1.2&r2=1.3
13
14 Index: devguide.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/overlays/devguide.xml,v
17 retrieving revision 1.2
18 retrieving revision 1.3
19 diff -u -r1.2 -r1.3
20 --- devguide.xml 9 May 2008 19:00:18 -0000 1.2
21 +++ devguide.xml 19 Feb 2009 21:42:50 -0000 1.3
22 @@ -1,12 +1,18 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/overlays/devguide.xml,v 1.2 2008/05/09 19:00:18 scen Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/overlays/devguide.xml,v 1.3 2009/02/19 21:42:50 scen Exp $ -->
27
28 <guide link="/proj/it/overlays/devguide.xml" lang="it">
29 <title>Overlay Gentoo: Guida per gli Sviluppatori</title>
30
31 <author title="Autore">
32 - <mail link="stuart@g.o">Stuart Herbert</mail>
33 + <mail link="stuart"/>
34 +</author>
35 +<author title="Autore">
36 + <mail link="jokey">Markus Ullmann</mail>
37 +</author>
38 +<author title="Autore">
39 + <mail link="robbat2">Robin H. Johnson</mail>
40 </author>
41 <author title="Traduzione">
42 <mail link="info@××××××××××××××.com">Franco Tampieri</mail>
43 @@ -19,8 +25,8 @@
44
45 <license/>
46
47 -<version>1.0</version>
48 -<date>2006-07-29</date>
49 +<version>2.3</version>
50 +<date>2009-01-18</date>
51
52 <chapter>
53 <title>Introduzione</title>
54 @@ -40,35 +46,20 @@
55 </body>
56 </section>
57 <section>
58 -<title>Cosa è overlays.gentoo.org?</title>
59 -<body>
60 -
61 -<p>
62 -<uri link="http://overlays.gentoo.org">overlays.gentoo.org</uri> fornisce spazi
63 -di lavoro sociali per lo sviluppo di progetti Gentoo, dove sviluppatori e utenti
64 -possono collaborare sui pacchetti Gentoo futuri. Tale obbiettivo viene
65 -realizzato con l'hosting di overlay per progetti Gentoo e overlay per
66 -sviluppatori Gentoo.
67 -</p>
68 -
69 -</body>
70 -</section>
71 -<section>
72 <title>Chi può usare overlays.gentoo.org?</title>
73 <body>
74
75 <p>
76 Ogni progetto Gentoo, o ogni sviluppatore Gentoo, può avere un proprio overlay
77 -ospitato su overlays.gentoo.org, con un RSS alimentato dal changelog incluso
78 -sulla <uri link="http://overlays.gentoo.org">homepage di
79 +ospitato su (git.)overlays.gentoo.org, con un RSS alimentato dal changelog
80 +incluso sul <uri link="http://overlays.gentoo.org">planet di
81 overlays.gentoo.org</uri>.
82 </p>
83
84 <p>
85 -Qualsiasi membro dello staff Gentoo o utente (cioè chiunque non abbia accesso in
86 -scrittura all'albero principale dei pacchetti di Portage) può scaricare e usare
87 -i contenuti di qualunque overlay ospitato. Se uno sviluppatore lo desidera, può
88 -concedere il diritto di scrittura sul proprio overlay agli utenti.
89 +Qualsiasi utente può scaricare e usare i contenuti di qualunque overlay
90 +ospitato. Se uno sviluppatore lo desidera, può concedere il diritto di scrittura
91 +sul proprio overlay agli utenti.
92 </p>
93
94 </body>
95 @@ -78,25 +69,24 @@
96 <body>
97
98 <p>
99 -Il servizio overlays.gentoo.org attualmente offre:
100 +Il servizio (git.)overlays.gentoo.org attualmente offre:
101 </p>
102
103 <ul>
104 <li>
105 <uri link="http://trac.edgewall.com">Trac</uri> (un ambiente wiki con
106 navigatore di versioni incorporato), per creare e mantenere rapidamente
107 - documentazione per il proprio overlay
108 - </li>
109 - <li>
110 - <uri link="http://subversion.tigris.org">Subversion</uri> - un sistema di
111 - controllo di versione centralizzato (un sistema di controllo di versione
112 - distribuito sarà disponibile in futuro)
113 + documentazione per il proprio overlay basato su Subversion
114 </li>
115 <li>
116 La pubblicazione del changelog per il proprio overlay sulla <uri
117 link="http://overlays.gentoo.org/">homepage di o.g.o</uri>, in modo che
118 chiunque sia interessato può vedere come si sviluppa il progetto
119 </li>
120 + <li>
121 + <uri link="http://git.or.cz/gitwiki/Gitweb">gitweb</uri> - fornisce
122 + un'interfaccia web completamente matura per visualizzare i repository Git.
123 + </li>
124 </ul>
125
126 <p>
127 @@ -107,10 +97,10 @@
128 </p>
129
130 <p>
131 -Ogni overlay ha liste di autenticazione separate per Trac e Subversion. Non è
132 -assolutamente un problema dare a qualcuno l'accesso in scrittura solo per Trac
133 -(ad esempio per scrivere documentazione) senza dare l'accesso in scrittura a
134 -Subversion.
135 +Ciascun overlay ha liste di autenticazione separate per Trac, Subversion e Git.
136 +Non è assolutamente un problema dare a qualcuno l'accesso in scrittura solo per
137 +Trac (ad esempio per scrivere documentazione) senza dare l'accesso in scrittura
138 +a Subversion.
139 </p>
140
141 </body>
142 @@ -174,9 +164,11 @@
143 </warn>
144
145 <p>
146 -Un'altra cosa da dire è che o.g.o serve a ospitare overlay. Non lo si può usare
147 -per essere $UPSTREAM. Se questo è il tipo di hosting desiderato, è possibile
148 -usare servizi quali <uri
149 +o.g.o. aveva delle restrizioni per quanto riguardo all'impossibilità di essere
150 +$UPSTREAM per i pacchetti. Questa restrizione è stata corretta. Ora viene
151 +offerto l'hosting come $UPSTREAM, ma solo per pacchetti che sono specifici per
152 +Gentoo o importanti per il suo funzionamento. Altri servizi di hosting
153 +risultano essere più adatti, per esempio <uri
154 link="http://www.sourceforge.net/">SourceForge.net</uri>, <uri
155 link="http://www.berlios.de">Berlios</uri>, o <uri
156 link="http://www.gentooexperimental.org">GentooExperimental.org</uri> di
157 @@ -201,7 +193,7 @@
158
159 <impo>
160 Prima di chiedere un overlay, assicurarsi di aver letto il <uri
161 -link="/proj/en/overlays/policy.xml">Documento delle Politiche d'utilizzo</uri>.
162 +link="/proj/it/overlays/policy.xml">Documento delle Politiche d'utilizzo</uri>.
163 In esso si precisa chiaramente cosa è permesso e cosa no, e quali saranno le
164 proprie responsabilità.
165 </impo>
166 @@ -214,29 +206,35 @@
167
168 <p>
169 Gli overlays per "progetti" sono overlay per i progetti ufficiali Gentoo. Un
170 -buon esempio è l'<uri link="http://overlays.gentoo.org/proj/php">Overlay
171 +esempio è l'<uri link="http://overlays.gentoo.org/proj/php">Overlay
172 PHP</uri>.</p>
173
174 <p>
175 Un progetto ufficiale Gentoo è un progetto che ha una pagina su www.gentoo.org,
176 -e ha un capo eletto. (Questa definizione viene dal <uri
177 -link="http://www.gentoo.org/proj/en/glep/glep-0039.html">documento di
178 -metastruttura</uri>, che è il documento di governo di Gentoo). I capo progetto
179 -sono responsabili per l'overlay del progetto stesso, inclusi i suoi contenuti, e
180 -per ogni altro problema che esso causi ad altri progetti e sviluppatori Gentoo.
181 +e ha un capo eletto. (Questa definizione viene dal documento di metastruttura).
182 +I(l) capo(i) progetto sono responsabili per l'overlay del progetto stesso,
183 +inclusi i suoi contenuti, e per ogni altro problema che esso causi ad altri
184 +progetti e sviluppatori Gentoo.
185 </p>
186
187 <p>
188 -Per richiedere un overlay di progetto, il capo progetto deve solo entrare dentro
189 -#gentoo-overlays su IRC e chiedere la creazione di un overlay. Oppure, se lo
190 -preferiscono, devono inviare una email a overlays@g.o. Il team Overlays
191 -curerà tutto il resto, incluso il garantire l'accesso in scrittura a tutti i
192 -membri del proprio progetto (così come elencati nella propria pagina di
193 +Per richiedere un overlay SVN di progetto il capo progetto deve solo entrare
194 +dentro #gentoo-overlays su IRC e chiedere la creazione di un overlay. Oppure, se
195 +lo preferiscono, devono inviare una email a overlays@g.o. Il team
196 +Overlays curerà tutto il resto, incluso il garantire l'accesso in scrittura a
197 +tutti i membri del proprio progetto (così come elencati nella propria pagina di
198 progetto).
199 </p>
200
201 <p>
202 -Il team Overlays:
203 +Per richiedere un overlay Git di progetto, basta visitare il sito <uri
204 +link="http://git.overlays.gentoo.org">git.overlays</uri>, e seguire le
205 +istruzioni di configurazione, inviando via e-mail il template completato a chi
206 +di dovere.
207 +</p>
208 +
209 +<p>
210 +Per un overlay SVN Il team Overlays:
211 </p>
212
213 <ul>
214 @@ -254,8 +252,23 @@
215 darà accesso in scrittura a tutti i membri del progetto che già hanno un
216 acconto o.g.o.
217 </li>
218 +</ul>
219 +
220 +<p>
221 +Per un overlay Git Il team Overlays:
222 +</p>
223 +
224 +<ul>
225 + <li>creerà l'overlay per il progetto (git, gitweb, no trac)</li>
226 + <li>aggiungerà il feed RSS dell'overlay del progetto all'homepage o.g.o.</li>
227 + <li>
228 + creerà un account git o.g.o per lo sviluppatore che ha fatto la richiesta,
229 + se non ne ha già uno
230 + </li>
231 + <li>gli darà accesso in scrittura al repository degli overlay Git</li>
232 <li>
233 - contatterà tutti gli altri membri del progetto, e organizzerà i loro accessi
234 + darà accesso in scrittura a tutti i membri del progetto che già hanno un
235 + acconto o.g.o.
236 </li>
237 </ul>
238
239 @@ -268,7 +281,7 @@
240 <p>
241 Gli overlay per "sviluppatori" sono proprietà degli sviluppatori Gentoo
242 individuali. Un esempio è <uri
243 -link="http://overlays.gentoo.org/dev/tcort">l'overlay di tcort</uri>.
244 +link="http://overlays.gentoo.org/dev/beandog">l'overlay di beandog</uri>.
245 </p>
246
247 <p>
248 @@ -278,13 +291,13 @@
249 </p>
250
251 <p>
252 -Per richiedere un overlay di sviluppatore, entrate semplicemente in
253 -#gentoo-overlays su IRC e chiedete che si crei un overlay per sé. Oppure, se
254 -lo si preferisce, inviare un email a overlays@g.o.
255 +Per richiedere un overlay SVN come sviluppatore, basta entrare in
256 +#gentoo-overlays su IRC e chiedere che venga creato un overlay per sé. Oppure,
257 +se lo si preferisce, inviare un email a overlays@g.o.
258 </p>
259
260 <p>
261 -Il team Overlays:
262 +Per una richiesta SVN il team Overlays:
263 </p>
264
265 <ul>
266 @@ -298,6 +311,19 @@
267 </li>
268 </ul>
269
270 +<p>
271 +Per una richiesta Git il team Overlays:
272 +</p>
273 +
274 +<ul>
275 + <li>creerà l'overlay dello sviluppatore (git, gitweb, no trac)</li>
276 + <li>aggiungerà il feed RSS del suo overlay all'homepage o.g.o.</li>
277 + <li>
278 + creerà un account o.g.o per lo sviluppatore, se non ne possiede già uno
279 + </li>
280 + <li>gli darà accesso in scrittura al repository degli overlay Git</li>
281 +</ul>
282 +
283 </body>
284 </section>
285 <section>
286 @@ -307,8 +333,7 @@
287 <p>
288 Siccome o.g.o è strutturato per supportare una miscela di sviluppatori e
289 semplici utenti Gentoo, non vengono creati account 'reali' a livello di sistema
290 -sull'host o.g.o. Tutti gli accessi avvengono attualmente tramite Apache, e sono
291 -gestiti tramite i file Apache htpasswd e htgroup.
292 +sull'host o.g.o.
293 </p>
294
295 <impo>
296 @@ -353,7 +378,17 @@
297 </p>
298
299 <pre caption="Effettuare il checkout del proprio overlay per progetti">
300 -svn co http://overlays.gentoo.org/svn/proj/foo/
301 +svn co https://overlays.gentoo.org/svn/proj/foo/
302 +</pre>
303 +
304 +<p>
305 +Nonstante sia possibile effettuare azioni in sola lettura tramite l'insicuro
306 +protocollo HTTP, bisogna effettuare tutti i commit tramite HTTPS. Se si
307 +necessita di passare da una modalità all'altra, usare:
308 +</p>
309 +
310 +<pre caption="Passare il proprio overlay di progetto da HTTP a HTTPS">
311 +svn sw --relocate http://overlays.gentoo.org/svn/proj/foo/ https://overlays.gentoo.org/svn/proj/foo/
312 </pre>
313
314 <p>
315 @@ -377,7 +412,17 @@
316 </p>
317
318 <pre caption="Effettuare il checkout del proprio overlay per sviluppatori">
319 -svn co http://overlays.gentoo.org/svn/dev/foo/
320 +svn co https://overlays.gentoo.org/svn/dev/foo/
321 +</pre>
322 +
323 +<p>
324 +Nonstante sia possibile effettuare azioni in sola lettura tramite l'insicuro
325 +protocollo HTTP, bisogna effettuare tutti i commit tramite HTTPS. Se si
326 +necessita di passare da una modalità all'altra, usare:
327 +</p>
328 +
329 +<pre caption="Passare il proprio overlay di sviluppatore da HTTP a HTTPS">
330 +svn sw --relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.gentoo.org/svn/dev/foo/
331 </pre>
332
333 <p>
334 @@ -408,48 +453,9 @@
335 <p>
336 Il feed RSS del proprio overlay - quello mostrato sull'<uri
337 link="http://overlays.gentoo.org">homepage di o.g.o</uri> - deriva dalla pagina
338 -Timeline di Trac.
339 -</p>
340 -
341 -<p>
342 -sono stati installato diversi plugin di Trac, che si spera rendano il proprio
343 -wiki ancora più utile. Se si scoprono plugin addizionali interessanti, che si
344 -ritiene possano essere utili, contattare il team.
345 +Timeline di Trac o dal sommario di GitWeb.
346 </p>
347
348 -<ul>
349 - <li><e>LayOnTrac</e> - lista i pacchetti contenuti nell'overlay.</li>
350 - <li>
351 - <uri link="http://muness.textdriven.com/trac/wiki/tags/Setup">TracTags</uri>
352 - - mostra a tag a forma di nuvola
353 - </li>
354 - <li>
355 - <uri link="http://trac.edgewall.org/wiki/WebAdmin">TracWebAdmin</uri> -
356 - fornisce un pannello web di amministratore per Trac
357 - </li>
358 -</ul>
359 -
360 -<p>
361 -Sono state installate anche diverse macro Trac, con la speranza che anche in
362 -questo caso il wiki sia più utile. E anche in questo caso, se si trova qualche
363 -macro utile, comunicarlo al team Overlays che ne valuterà l'adozione.
364 -</p>
365 -
366 -<ul>
367 - <li>
368 - <uri link="http://trac-hacks.org/wiki/AddCommentMacro">AddComment</uri> -
369 - permette ai visitatori di aggiungere commenti alla fine delle vostre pagine
370 - </li>
371 - <li>
372 - <uri link="http://trac-hacks.org/wiki/FootNoteMacro">FootNote</uri> - è il
373 - supporto per le note a piè di pagina
374 - </li>
375 - <li>
376 - <uri link="http://trac-hacks.org/wiki/TocMacro">TOC</uri> - è il supporto
377 - per pubblicare l'indice dei contenuti
378 - </li>
379 -</ul>
380 -
381 </body>
382 </section>
383 <section>
384 @@ -457,19 +463,16 @@
385 <body>
386
387 <p>
388 -Il proprio overlay viene fornito con <uri
389 -link="http://subversion.tigris.org">Subversion</uri>, un alternativa moderna a
390 -CVS. Il vantaggio di Subversion su CVS include il versioning reale delle
391 -directory, completo supporto al changeset, ed è molto più semplice eseguire
392 -branching all'occorrenza. Lo svantaggio principale è che è più lento di CVS, e
393 -che un controllo locale di Subversion richiede più spazio su disco.
394 +Il vantaggio di Subversion su CVS include il versioning reale delle directory,
395 +completo supporto al changeset, ed è molto più semplice eseguire branching
396 +all'occorrenza. Lo svantaggio principale è che è più lento di CVS, e che un
397 +controllo locale di Subversion richiede più spazio su disco.
398 </p>
399
400 <p>
401 -Se non si ha mai usato Subversion precedenza, il <uri
402 -link="http://svnbook.red-bean.com/">manuale in linea</uri> è un eccellente modo
403 -per imparare ad usarlo. È possibile anche comprarlo in formato cartaceo, se lo
404 -si preferisce.
405 +Se non si ha mai usato Subversion precedenza, il manuale in linea è un buon
406 +metodo per imparare ad usarlo. È possibile anche comprarlo in formato cartaceo,
407 +se lo si preferisce.
408 </p>
409
410 <p>
411 @@ -477,7 +480,7 @@
412 </p>
413
414 <pre caption="Effettuare il checkout del proprio overlay">
415 -svn co http://overlays.gentoo.org/proj/php
416 +svn co https://overlays.gentoo.org/proj/php
417 </pre>
418
419 <pre caption="Vedere per quali file bisogna fare il commit">
420 @@ -507,10 +510,9 @@
421
422 <p>
423 Per iniziare ad usare layman, vedere la <uri
424 -link="http://www.gentoo.org/news/it/gwn/20060522-newsletter.xml">Gentoo Weekly
425 -Newsletter del 22 Maggio</uri>, <uri
426 -link="http://gentoo-wiki.com/TIP_Overlays#layman">questo articolo su
427 -Gentoo-Wiki.com</uri>, o la pagina di man che viene installata con layman.
428 +link="http://layman.sourceforge.net/">documentazione nell'homepage</uri>, la
429 +<uri link="http://www.gentoo.org/news/it/gwn/20060522-newsletter.xml">Newsletter
430 +Settimanale Gentoo del 22 Maggio</uri>, o consultare <c>man layman</c>.
431 </p>
432
433 </body>
434 @@ -545,25 +547,6 @@
435
436 <chapter>
437 <title>Usare git sugli overlay</title>
438 -
439 -<section>
440 -<title>Configurare git per operare con webdav</title>
441 -<body>
442 -
443 -<pre caption="aggiungere il proprio ~/.netrc">
444 -machine overlays.gentoo.org
445 -login (proprio-nome-utente)
446 -password (propria-password)
447 -</pre>
448 -
449 -<p>
450 -Sorgente:
451 -http://www.kernel.org/pub/software/scm/git/docs/howto/setup-git-server-over-
452 -http.txt
453 -</p>
454 -
455 -</body>
456 -</section>
457 <section>
458 <title>Inizializzare il proprio overlay</title>
459 <body>
460 @@ -584,16 +567,16 @@
461 </pre>
462
463 <p>
464 -Notare che questa operazione è solo locale, e con essa il server inizia a
465 -operare. Assicurarsi di mettere i / finali
466 +Notare che questa operazione è solo locale, e con essa il server inizia ad
467 +operare.
468 </p>
469
470 <pre caption="specificare l'url a git">
471 -git-config remote.upload.url http://(your-username)@overlays.gentoo.org/git/(proj o dev)/(nome)/
472 +git-config remote add origin git+ssh://git@×××××××××××××××××××.org/(proj o dev)/(nome)/
473 </pre>
474
475 <pre caption="caricare definitivamente i dati">
476 -git push upload master
477 +git push origin master
478 </pre>
479
480 <p>
481 @@ -603,11 +586,11 @@
482 </body>
483 </section>
484 <section>
485 -<title>Controllare l'overlay con git</title>
486 +<title>Effettuare il checkout dell'overlay con git</title>
487 <body>
488
489 <pre caption="clonalo!">
490 -git clone http://overlays.gentoo.org/git/(proj o dev)/(nome)/
491 +git clone git://git@×××××××××××××××××××.org/(proj o dev)/(name)/
492 </pre>
493
494 </body>
495 @@ -627,13 +610,6 @@
496 metodo per valutare potenziali sviluppatori Gentoo in un ambiente sicuro.
497 </p>
498
499 -<p>
500 -Al momento, solo il team degli Overlay può aggiornare le liste di controllo
501 -degli accessi per overlays.gentoo.org. Uno strumento basato su web per la
502 -gestione degli accessi verrà fornito più avanti. Per ora, se si ha bisogno di
503 -eseguire un cambiamento, contattare #gentoo-overlays su IRC per assistenza.
504 -</p>
505 -
506 </body>
507 </section>
508 <section>
509 @@ -839,10 +815,6 @@
510 R: Puoi mandare una email a overlays@g.o. Qualcuno ti risponderà il
511 prima possibile.
512 </li>
513 - <li>
514 - D: Puoi contattare Stuart Herbert (il capo progetto) direttamente, mediante
515 - il suo indirizzo di email: <mail>stuart@g.o</mail>.
516 - </li>
517 </ul>
518
519 <p>
520 @@ -851,9 +823,13 @@
521
522 <ul>
523 <li>
524 - R: La lista di controllo degli accessi risiede correntemente sui file
525 - htpasswd / htgroup usati da Apache. Solo lo staff admin di o.g.o ha accesso
526 - tramite ssh alla box o.g.o.
527 + R: (SVN) La lista di controllo degli accessi risiede attualmente in formato
528 + htpasswd. Solo lo staff admin di o.g.o ha accesso tramite ssh alla box
529 + o.g.o.
530 + </li>
531 + <li>
532 + R: (Git) La lista di controllo degli accessi risiede attualmente nel
533 + repository gitosis-admin, scrivibile solamente dallo staff di o.g.o.
534 </li>
535 </ul>