Differences between revisions 7 and 21 (spanning 14 versions)
Revision 7 as of 2010-10-06 02:46:12
Size: 18181
Editor: ?skizzhg
Comment:
Revision 21 as of 2020-04-10 10:12:48
Size: 21452
Comment: sync with English master v.63
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[ProjectNews/HowToContribute|English]] - [[es/ProjectNews/HowToContribute|Español]] - [[fr/ProjectNews/HowToContribute|Français]] - Italiano-~ ~-[[DebianWiki/EditorGuide#translation|Traduzioni]]: [[ProjectNews/HowToContribute|English]] - [[es/ProjectNews/HowToContribute|Español]] - [[fr/ProjectNews/HowToContribute|Français]] - Italiano - [[ko/ProjectNews/HowToContribute|한국어]] - [[pt/ProjectNews/HowToContribute|Português]] - [[pt_BR/ProjectNews/HowToContribute|Português Brasileiro]] -~
Line 12: Line 12:
/!\ '''Tutto il materiale fornito al repository publicity (ad esempio i vostri contributi) saranno pubblicati sul sito web di Debian sotto i termini delle [[http://www.debian.org/license|licenze MIT (Expat) o GPL2+]]'''

<<Anchor(Contents)>>
Line 45: Line 48:
Line 47: Line 51:
Le uscite della newsletter sono stilate in un repository di Subversion. I dettagli su come accedere usando un client Subversion sono elencati più avanti, nella sezione intitolata "Diventare un redattore". Qualora ci si trovi poco a proprio agio con Subversion, è sempre possibile scaricare l'[[https://alioth.debian.org/scm/viewvc.php/*checkout*/dpn/en/current/index.wml?root=publicity|uscita attuale]], revisionarla, e mandare i commenti via mail alla [[mailto:debian-publicity@lists.debian.org|mailing list debian-publicity]]. Le uscite della newsletter sono stilate in un repository Git. I dettagli su come accedere usando un client Git sono elencati più avanti, nella sezione intitolata "Diventare un redattore". Anche se non si ha familiarità con Git, è sempre possibile scaricare l'uscita attuale dal [[https://salsa.debian.org/publicity-team/dpn/tree/master/en|repository inglese delle DPN]], revisionarla, e mandare i commenti via mail alla [[mailto:debian-publicity@lists.debian.org|mailing list debian-publicity]].
Line 56: Line 60:
 *''Potresti'' inoltre volerti iscrivere alla mailing list publicity-commits all'indirizzo http://lists.alioth.debian.org/mailman/listinfo/publicity-commits. Ogni volta che viene effettuato un cambiamento al nostro repository subversion, viene inviata una mail in quella lista: in questo modo è davvero semplice rimanere aggiornati.
 * Se sei già un Debian Developer dovresti avere già l'accesso in scrittura al repository subversion.
 * Se non sei un Debian Developer, hai bisogno di un account su Alioth.
  * Se ne hai già uno, devi solo [[https://alioth.debian.org/project/request.php?group_id=100480|effettuare una richiesta]] di partecipazione al publicity project.
  * Se invece ancora non ne hai uno, [[https://alioth.debian.org/account/register.php|registrati su Alioth]] e poi [[https://alioth.debian.org/project/request.php?group_id=100480|fai richiesta]] per partecipare al Publicity Project.
 * ''Potresti'' anche volere iscriverti al pseudopacchetto "press" in https://tracker.debian.org/pkg/press. Ogni volta che viene fatto il commit di un cambiamento nei repository Git, riceverai una notifica via email, perciò è molto facile rimanere aggiornati. Vedere https://lists.debian.org/debian-publicity/2018/04/msg00001.html per i passi specifici da seguire.
 * Se sei già un Debian Developer dovresti avere già l'accesso in scrittura al repository Git.
 * Se non sei un Debian Developer, puoi inviare le tue proposte alla mailing list o usare il tuo account Salsa per inviare i contributi.
  * Se non hai un account su Salsa e vuoi crearlo, [[https://signup.salsa.debian.org/|registrati su Salsa]].
  * Se hai già un account e vuoi contribuire nel lungo periodo, fai il login nella piattaforma Salsa di Debian con il tuo account, e poi puoi semlicemente richiedere di unirti al progetto Pubblicity cliccano il pulsante "Request Access" al centro della [[https://salsa.debian.org/groups/publicity-team/|pagina del Publicity Team in Salsa]]. Una buona prassi è di scrivere nel frattempo alla mailing list debian-pubblicity presentandosi in modo che i coordinatori delle DPN possano conoscerti e approvare la tua richiesta di unirti al gruppo.
  * Se hai già un account but vuoi solo fare qualche contributo sporadico, puoi fare il fork del repository e inviare [[https://docs.gitlab.com/ee/user/project/merge_requests/|richieste di merge]].
Line 63: Line 68:
== Accedere al repository subversion ==

Prima di accedere al repository subversion, potresti voler leggere come [[it/Alioth/Svn#ConfigurareSSHperlaprimavolta|configurare SSH per la prima volta]] così da usare il repository subversion su alioth opportunamente.

 * lancia {{{svn co svn+ssh://svn.alioth.debian.org/svn/publicity/dpn/en/current}}}. Questo comando creerà una cartella {{{current}}} contenente l'attuale bozza del Debian Project News. Se vuoi, puoi rinominarla come preferisci.
 * spostati in quella cartella. Qualsiasi cosa tu faccia ricordati però di non cancellare né modificare o toccare in altro modo la cartella {{{.svn}}}: contiene alcuni metadati necessari per far funzionare subversion.

Ora puoi scrivere nel Debian Project News. Non preoccuparti se non hai esperienza con subversion o con il Website Meta Language / HTML (che viene usato per il sito di Debian). Niente di quello che farai apparirà direttamente sul sito e tutti gli errori che potresti fare possono essere rimediati senza eccessiva difficoltà.
== Accedere al repository Git delle DPN ==

 * Il numero delle DPN in fase di preparazione può essere sfogliato usando [[https://salsa.debian.org/publicity-team/dpn|il nostro repository git in Salsa]]

Prima di accedere al repository Git, potresti voler leggere la [[it/Salsa|documentazione]] per usare il repository Git su Salsa opportunamente.

 * eseguire {{{git clone git@salsa.debian.org:publicity-team/dpn.git}}}. Questo comando creerà una cartella {{{dpn}}} contenente le Debian Project News. Il numero attuale è nella sottocartella {{{current}}} della cartella {{{dpn}}}. Se lo si desidera, la si può rinominare come si preferisce.
 * spostarsi in quella cartella. Qualsiasi cosa si faccia ricordarsi però di non cancellare né modificare o toccare in altro modo la cartella {{{.git}}} lì contenuta: contiene alcuni metadati necessari per far funzionare tutto in modo corretto.

Ora puoi scrivere nel Debian Project News. Non preoccuparti se non hai esperienza con Git o con il Website Meta Language / HTML (che viene usato per il sito di Debian). Niente di quello che farai apparirà direttamente sul sito e tutti gli errori che potresti fare possono essere rimediati senza eccessiva difficoltà.

=== Accedere al repository Git in modo anonimo ===

Se non si ha un account Salsa, si può accedere al repository Git in modo anonimo.

Si può fare il checkout della bozza attuale di Debian Project News usando il comando seguente: {{{git clone https://salsa.debian.org/publicity-team/dpn.git}}}. Questo comando creerà una cartella {{{dpn}}} contenente le Debian Project News. La bozza più recente è nella cartella {{{dpn/current}}}.
Line 75: Line 87:
 * Spostati nella cartella contenente il chekout. Se non l'hai rinominata, dovrebbe essere {{{current}}}.
 * Prima di scrivere o modificare dovresti lanciare {{{svn update}}}, così da aggiornare la tua copia locale.
 * Spostati nella cartella contenente il checkout. Se non è stata rinominata, dovrebbe essere {{{dpn}}}.
 * Prima di scrivere o modificare dovresti lanciare {{{git pull}}}, così da aggiornare la tua copia locale.
Line 78: Line 90:
 * Dopo aver modificato il file {{{index.wml}}}, lancia di nuovo {{{svn update}}}, nel caso qualcuno avesse modificato quel documento mentre ci lavoravi.
  * Subversion cerca di essere intelligente, quando applica modifiche esterne al tuo documento modificato: a meno che  le modifiche (tue e dell'altro autore) non riguardino proprio la stessa riga, tutto dovrebbe funzionare bene.
  * Nel caso in cui abbiate modificato la stessa identica riga, si crea un cosidetto conflitto che deve essere risolto. Per sapere come fare a risolverlo, consulta [[http://svnbook.red-bean.com/en/1.1/svn-book.html#svn-ch-3-sect-5.4|la guida svn]].
 * Una volta che la tua copia locale è aggiornata, puoi inviare le tue modifiche al repository centrale lanciando il comando {{{svn -m "descrizione delle tue modifiche" commit index.wml}}}.
 * Invia con un commit le tue modifiche con {{{git commit index.wml}}}
 * Dopo aver modificato il file {{{index.wml}}}
, lancia {{{git update --rebase}}}, nel caso qualcun altro avesse modificato quel documento mentre ci lavoravi.
  * Git cerca di essere intelligente, quando applica modifiche esterne al tuo documento modificato: a meno che le modifiche (tue e dell'altro autore) non riguardino proprio la stessa riga, tutto dovrebbe funzionare bene.
  * Nel caso in cui abbiate modificato le stesse identiche righe, si crea un cosiddetto conflitto che deve essere risolto. Per sapere come farlo leggi [[http://githowto.com/resolving_conflicts|questa pagina]]
 * Una volta che la tua copia locale è aggiornata, puoi inviare le tue modifiche al repository centrale lanciando il comando {{{git push}}}
.
Line 84: Line 97:
Esistono, inoltre, svariate interfacce grafiche a subversion. Tuttavia, poiché l'autore manca totalmente di esperienza al riguardo, non si sente di consigliarne alcuna. Esistono, inoltre, svariate interfacce grafiche per Git. Tuttavia, poiché l'autore manca di esperienza al riguardo, non si sente di consigliarne alcuna.
Line 90: Line 103:

== Alcuni suggerimenti sull'uso di subversion ==

=== Espansione di parole chiave e subversion ===

Per usare l'intestazione di controllo della traduzione (che rende possibile ai traduttori segnalare su quale revisione di un file si sono basati nella traduzione), il file wml deve avere impostate le corrispondenti proprietà svn keywords.
Perciò puoi inserire manualmente $Id:$ nel documento, e subversion lo sostituirà automaticamente con alcune informazioni inerenti chi ha effettuato le ultime modifiche, quando e qual è il numero di revisione del documento.

Prima di inviare il commit di un nuovo file wml al repository, è necessario fare quanto segue per abilitare l'espansione delle parole chiave: {{{svn propset svn:keywords "Date Author Id Rev" <tuofile>}}}.

Si può in alternativa aggiungere quanto segue alla sezione {{{[auto-props]}}} del tuo {{{~/.subversion/config}}} e decommentare la riga {{{enable-auto-props = yes}}}, il che si occuperà del tutto automaticamente.
{{{
*.wml = svn:keywords="Author Date Id Rev URL";
}}}
Line 115: Line 114:
Se guardi un {{{index.wml}}} vuoto (dai un'occhiata a [[https://alioth.debian.org/scm/viewvc.php/*checkout*/dpn/en/index.wml-template?root=publicity|questo]] che viene usato come modello) noterai che inizia così:

{{{
#use wml::debian::projectnews::header PUBDATE="2010-XX-XX" SUMMARY=""
Se guardi un {{{index.wml}}} vuoto (dai un'occhiata a [[https://salsa.debian.org/publicity-team/dpn/blob/master/en/index.wml-template|questo]] che viene usato come modello) noterai che inizia così:

{{{
#use wml::debian::projectnews::header PUBDATE="2017-MM-DD" SUMMARY=""
Line 120: Line 119:
}}}

La prima riga dice al compilatore wml di usare il template project-news per l'intestazione, e inoltre imposta due variabili per la data di pubblicazione e un piccolo riassunto. Il riassunto è utilizzato, ad esempio, [[http://www.debian.org/News/project/2009/|nell'indice dei numeri recenti]]. Non dovrebbe essere troppo lungo.

}}}

La prima riga dice al compilatore wml di usare il modello ("template") project-news per l'intestazione, e inoltre imposta due variabili per la data di pubblicazione e un piccolo riassunto. Il riassunto è utilizzato, ad esempio, [[https://www.debian.org/News/weekly/2018/|nell'indice dei numeri recenti]]. Non dovrebbe essere troppo lungo.
Line 128: Line 128:
#use wml::debian::projectnews::footer editor="XXX, XXX, Alexander Reichle-Schmehl" #use wml::debian::projectnews::footer editor="The Publicity Team with contributions from contributor1, contributor2, contributor3"
Line 133: Line 133:
Tutto ciò che è compreso tra quelle righe, è normale HTML, che nel nostro caso significa soprattutto: alcuni titoli ({{{<h2>...</h2>}}}), alcuni paragrafi ({{{<p>...</p>}}}) e qualche elenco ({{{<ul><li>...</li><li>...</li></ul>}}}).

Ogni articolo deve iniziare con un titolo:
{{{
<a name="1"></a>
<h2>This is the headline of my small article</h2>
}}}

Ciò che si trova tra {{{<h2>}}} e {{{</h2>}}} è il titolo vero e proprio. Invece {{{<a name="x"></a>}}} crea una cosiddetta "ancora" che viene usata per saltare direttamente ad una riga particolare. È usata, per esempio, nei feed RSS.

Dopo il titolo abbiamo l'articolo vero e proprio, contenuto tra i tag {{{<p>}}} e {{{</p>}}}. Si possono usare svariati paragrafi, ma è importante notare come solo il primo di questi apparirà nei feed RSS. (Questo potrebbe essere un bug degno di essere corretto, nel caso tu conosca il perl...)
Tutto ciò che è compreso tra quelle righe, è quasi normale HTML, che nel nostro caso significa soprattutto: alcuni titoli ({{{<toc-add-entry>...</toc-add-entry>}}}), alcuni paragrafi ({{{<p>...</p>}}}) o qualche elenco ({{{<ul><li>...</li><li>...</li></ul>}}}).

Ogni articolo deve iniziare con un nome univoco:
{{{
<toc-add-entry name="$anchor_univoco">$mio_titolo</toc-add-entry>
<p>Questo è il contenuto del mio breve articolo, dove posso inserire <a href="http://debian.org/">collegamenti</a> e altri markup HTML.</p>
}}}

Ciò che si trova tra {{{<toc-add-entry>}}} e {{{</toc-add-entry>}}} è il titolo vero e proprio.

Dopo il titolo abbiamo l'articolo vero e proprio, contenuto tra i tag {{{<p>}}} e {{{</p>}}}. Si possono usare svariati paragrafi, ma è importante notare come solo il primo di questi apparirà nei feed RSS. (Questo potrebbe essere un bug degno di essere corretto, nel caso tu conosca il Perl...)
Line 162: Line 162:
= Tradurre il Debian Project News =

Sentiti anche libero di usare il repository subversion per il tuo lavoro di traduzione.
In questi casi è più facile fare semplicemente il checkout della completa gerarchia del DPN nel repository, seguendo questi passi:

 * {{{svn co svn+ssh://svn.alioth.debian.org/svn/publicity/dpn/}}}
= Tradurre le Debian Project News =

Sentiti anche libero di usare il repository Git per il tuo lavoro di traduzione.
In questi casi è più facile fare semplicemente il checkout della completa gerarchia del DPN nel repository Git, seguendo questi passi:

 * {{{git clone git@salsa.debian.org:publicity-team/dpn.git}}}
Line 171: Line 171:
  * aggiungila al repository, ad esempio {{{svn add it}}}
  * e manda il commit al server centrale, ad esempio {{{svn commit -m "creata la directory per la traduzione italiana" it}}}
  * crea la sottodirectory anno/numero corrispondente (es. {{{mkdir -p 2015/07}}})
  * aggiungi una prima versione (va bene anche una bozza) della tua traduzione come {{{index.wml}}}
  * aggiungila al repository, ad esempio {{{git add fr/}}}
  * fai il commit locale delle tue modifiche {{{git commit -m"primi passi di traduzione"}}}
  * e invia le modifiche al server centrale, es. {{{git push}}}
Line 174: Line 177:
 * Leggi [[#becomingeditor|Diventare un redattore]] per alcune linee guida sull'uso di subversion e una breve descrizione del formato dei file wml. Ma tieni presente che:
  * i traduttori devono usare anche un header ulteriore: {{{#use wml::debian::translation-check translation="<revision>"}}}, che serve a segnalare su quale revisione dell'originale si basa la traduzione.
 * Leggi [[#becomingeditor|Diventare un redattore]] per alcune linee guida sull'uso di Git e una breve descrizione del formato dei file wml. Ma tieni presente che:
  * i traduttori devono usare anche un header ulteriore: {{{#use wml::debian::translation-check translation="<revision_git_hash>"}}}, che serve a segnalare su quale revisione dell'originale si basa la traduzione. Tuttavia per il momento lasciare <revision_git_hash> vuoto; la persona che farà l'effettiva pubblicazione del numero copierà l'hash corrispondente quando la versione inglese viene aggiunta al repository del sito web.
Line 177: Line 180:
Ad esempio:
{{{
#use wml::debian::projectnews::footer editor="Moritz Muehlenhoff, Andre Felipe Machado, Alexander Reichle-Schmehl" translator="Benedikt Beckmann"
}}}

== Usare Translation check per tenere traccia delle versioni dell'originale ==

Se usi il repository subversion di publicity, puoi usare lo script in {{{scripts/trans-check}}} per tenere traccia di quali delle tue traduzioni necessitano aggiornamenti. A questo scopo le tue traduzioni hanno bisogno di un campo translation-check. Ad esempio:
Ad esempio (per il francese):
{{{
#use wml::debian::projectnews::footer editor="L'équipe en charge de la publicité avec des contributions de Thomas Lange et Paulo Henrique de Lima Santana et Jean-Pierre Giraud" translator="Jean-Pierre Giraud, l\'équipe francophone de traduction"
}}}

== Usare "Translation check" per tenere traccia delle versioni dell'originale (FIXME: Sezione non aggiornata) ==

'''Nota: Questa sezione non è più aggiornata, lo script è stato progettato per usare Subversione e ora invece viene usato GIt. Queste informazioni vengono mantenute nel caso qualcuno voglia aggiornare lo script.'''


Se usi il repository
di publicity, puoi usare lo script in {{{scripts/trans-check}}} per tenere traccia di quali delle tue traduzioni necessitano aggiornamenti. A questo scopo le tue traduzioni hanno bisogno di un campo translation-check. Ad esempio:
Line 200: Line 206:
Come brevemente spiegato nella sezione [[#indexwmlformat|Formato del file index.wml]], il Debian Project News è pubblicato in tre modi: Come brevemente spiegato nella sezione [[#indexwmlformat|Formato del file index.wml]], le Debian Project News sono pubblicate in tre modi:
Line 205: Line 211:
Per far sì che la tua traduzione venga pubblicata sul sito Debian, sarà necessario aggiungerla al repository CVS. Leggi questa pagina per avere maggiori informazioni: http://www.debian.org/devel/website/ . Per far sì che la tua traduzione venga pubblicata sul sito Debian, sarà necessario aggiungerla al repository webml. Per maggiori informazioni vedere http://www.debian.org/devel/website/ .
Line 209: Line 215:
A prescindere da dove la invii, troverai lo script {{{scripts/DPNhtml2mail.pl}}} piuttosto comodo: quando la traduzione è disponibile sul sito, devi solo lanciarlo e creerà la versione in formato testo. Puoi lanciarlo in questo modo: {{{scripts/DPNhtml2mail.pl -d -l en -i 2008/06}}}. Non sarà ancora perfetto, ma è un modo davvero semplice di creare delle versioni di testo esteticamente gradevoli. A prescindere da dove la invii, troverai lo script {{{scripts/DPNhtml2mail.pl}}} piuttosto comodo: quando la traduzione è disponibile sul sito, devi solo lanciarlo e creerà la versione in formato testo. Puoi lanciarlo in questo modo: {{{scripts/DPNhtml2mail.pl -d -l en -i 2008/06}}}. Non sarà ancora perfetto, ma è un modo davvero semplice di creare delle versioni di testo esteticamente gradevoli.

=== Flusso di lavoro attuale (team francese) ===
Questo è il flusso di lavoro utilizzato (più o meno) dal gruppo di traduzione in francese.

 1. Dopo ogni rilascio {{{https://salsa.debian.org/publicity-team/dpn/tree/master/LL/current}}} viene spostato nella posizione appropriata (es. {{{2010/01}}}). Poi viene creata una nuova directory {{{current}}} e vi viene copiato dentro {{{index.wml-template}}}, per iniziare con una traduzione nuova e vuota delle notizie.
 1. Circa una settimana prima della pubblicazione del nuovo numero, si inizia la traduzione di ciò che è disponibile (per evitare di fare lavoro all'ultimo minuto di fretta e possibilmente non di buona qualità).
 1. Se ci sono già abbastanza articoli (diciamo quattro o cinque), viene inviata la bozza WIP all'indirizzo debian-l10n-<lingua>@l.d.o per la revisione.
 1. Quando le DPN sono in fase ''string-frozen'', cercare di finire il più velocemente possibile; chiedere aiuto in debian-l10n-language@l.d.o può essere una buona idea e offre a ogni membro la possibilità di fornire almeno un articolo tradotto (chiedere esplicitamente di indicare su quale articolo si lavora per evitare duplicati).
 1. Quando il DPN tradotto è completo, si spera venerdì o sabato, chiedere una revisione formale in debian-l10n-<lingua>@l.d.o.
 1. Il lunedì successivo, pubblicare le DPN tradotte sul sito web seguendo quelle originali e inviare un'ultima chiamata per commenti in debian-l10n-<lingua>@l.d.o.
 1. Due o tre giorni dopo, inviare le DPN su debian-news-<lingua>@l.d.o.

=== Commenti e problemi con il flusso di lavoro attuale ===

 * Il tempo a disposizione per chi contribuisce per revisionare il numero è poco, da qui deriva la proposta di fornire una bozza WIP parziale per la revisione con una settimana d'anticipo.
 * Dipende pesantemente da una DPN che '''non''' sia modificata all'ultimo minuto ;-).
 * Viene comunque rilasciata due o tre giorni dopo la sua data obiettivo.

Traduzioni: English - Español - Français - Italiano - 한국어 - Português - Português Brasileiro


In questa pagina è spiegato come contribuire al Debian ProjectNews e cosa puoi fare TU per aiutarci.

Come contribuire a DPN

Contribuire al ProjectNews è piuttosto semplice, ma dipende dalle tue capacità e dalla quantità di tempo a tua disposizione.

/!\ Tutto il materiale fornito al repository publicity (ad esempio i vostri contributi) saranno pubblicati sul sito web di Debian sotto i termini delle licenze MIT (Expat) o GPL2+

Inviare notizie interessanti

Il modo più semplice di aiutarci consiste nel farci sapere le cose interessanti che succedono nell'universo Debian: Debian è un progetto piuttosto grosso, e non siamo certo in grado di monitorare ogni mailing list, blog e sito di notizie per selezionare contenuti da inserire nel nostro ProjectNews. Perciò faccelo sapere, se scopri qualcosa di interessante. Puoi farlo inviando una e-mail a debian-publicity@lists.debian.org .

Cose da segnalare

In linea di massima, tutto ciò che può avere un qualche impatto sul progetto Debian in generale e sulla sua utenza è da considerarsi speciale.

Alcune idee:

  • Discussioni sulle mailing list che:
    • abbiano un impatto significativo su Debian (ad esempio: discussioni sulle licenze, la pianificata transizione di un programma)
    • contengano un dibattito interessante riguardo il Progetto pinco o il Progetto pallino Risoluzioni Generali, etc.)

  • Annunci provenienti da progetti minori:
    • debian installer vicino alla release beta3, richieste di test
    • la traduzione francese di debconf raggiunge il 100%
    • cdrkit in grado di masterizzare blue ray disc
    • lettere "Notizie da"
    • etc.
  • Segnalazioni di bug interessanti (avete mai dato un'occhiata al 245047?)

  • Hai rappresentato Debian ad una conferenza o ad un'esibizione (con uno stand, un discorso o un workshop)
    • Hai scritto un resoconto dopo aver rappresentato Debian ad una conferenza o ad un'esibizione
  • Sei stato intervistato a proposito del tuo lavoro su Debian
  • Recensioni, testi e articoli riguardanti Debian su altri media, siti web, mailing list, blog
  • Conferenze, mini DebConfs, FOSDEM, CeBIT, etc.

  • etc.

Cose che non è necessario segnalare

Naturalmente la lista di cui sopra è ben lungi dall'essere completa. In particolare vorremmo sottolineare che non siamo in grado di cercare notizie su gli altri media, siti web, blog, eccetera. Quindi sarebbe davvero un contributo apprezzato se poteste segnalare tutto ciò che ritenete adeguato al ProjectNews alla nostra mailing list debian-publicity@lists.debian.org .

Tenete presente che uno dei maggiori propositi da parte nostra, oltre che tenere i nostri utenti informati, è di mostrar loro che siamo una comunità viva e attiva. Cioè mostrare che Debian è fiorente, che Debian è vivo!

Aiuto da parte degli utenti madrelingua

Attualmente il redattore principale delle notizie non è di madrelingua inglese. Lui lo sa e probabilmente lo avrai notato anche tu. Dunque ciò che puoi fare per aiutare, se sei madrelingua inglese, è di correggere il suo inglese da tedesco in un inglese corretto. Le uscite della newsletter sono stilate in un repository Git. I dettagli su come accedere usando un client Git sono elencati più avanti, nella sezione intitolata "Diventare un redattore". Anche se non si ha familiarità con Git, è sempre possibile scaricare l'uscita attuale dal repository inglese delle DPN, revisionarla, e mandare i commenti via mail alla mailing list debian-publicity. Sarebbe meglio mandare i cambiamenti proposti sotto forma di diff o wdiff, se possibile: basta fare una copia del file scaricato, modificarla e inviarci l'output di diff -u <file_vecchio> <file_nuovo>.

Diventare un redattore

Se vuoi contribuire direttamente e aggiungere dei brevi articoli per il ProjectNews, sentiti libero di entrare a far parte del team:

  • Dovresti davvero iscriverti alla mailing list debian-publicity, all'indirizzo http://lists.debian.org/debian-publicity, dato che tutte le discussioni vengono tenute lì;

  • Potresti anche volere iscriverti al pseudopacchetto "press" in https://tracker.debian.org/pkg/press. Ogni volta che viene fatto il commit di un cambiamento nei repository Git, riceverai una notifica via email, perciò è molto facile rimanere aggiornati. Vedere https://lists.debian.org/debian-publicity/2018/04/msg00001.html per i passi specifici da seguire.

  • Se sei già un Debian Developer dovresti avere già l'accesso in scrittura al repository Git.
  • Se non sei un Debian Developer, puoi inviare le tue proposte alla mailing list o usare il tuo account Salsa per inviare i contributi.
    • Se non hai un account su Salsa e vuoi crearlo, registrati su Salsa.

    • Se hai già un account e vuoi contribuire nel lungo periodo, fai il login nella piattaforma Salsa di Debian con il tuo account, e poi puoi semlicemente richiedere di unirti al progetto Pubblicity cliccano il pulsante "Request Access" al centro della pagina del Publicity Team in Salsa. Una buona prassi è di scrivere nel frattempo alla mailing list debian-pubblicity presentandosi in modo che i coordinatori delle DPN possano conoscerti e approvare la tua richiesta di unirti al gruppo.

    • Se hai già un account but vuoi solo fare qualche contributo sporadico, puoi fare il fork del repository e inviare richieste di merge.

  • A questo punto, devi proprio leggere le nostre Linee Guida per gli articoli del ProjectNews.

Accedere al repository Git delle DPN

Prima di accedere al repository Git, potresti voler leggere la documentazione per usare il repository Git su Salsa opportunamente.

  • eseguire git clone git@salsa.debian.org:publicity-team/dpn.git. Questo comando creerà una cartella dpn contenente le Debian Project News. Il numero attuale è nella sottocartella current della cartella dpn. Se lo si desidera, la si può rinominare come si preferisce.

  • spostarsi in quella cartella. Qualsiasi cosa si faccia ricordarsi però di non cancellare né modificare o toccare in altro modo la cartella .git lì contenuta: contiene alcuni metadati necessari per far funzionare tutto in modo corretto.

Ora puoi scrivere nel Debian Project News. Non preoccuparti se non hai esperienza con Git o con il Website Meta Language / HTML (che viene usato per il sito di Debian). Niente di quello che farai apparirà direttamente sul sito e tutti gli errori che potresti fare possono essere rimediati senza eccessiva difficoltà.

Accedere al repository Git in modo anonimo

Se non si ha un account Salsa, si può accedere al repository Git in modo anonimo.

Si può fare il checkout della bozza attuale di Debian Project News usando il comando seguente: git clone https://salsa.debian.org/publicity-team/dpn.git. Questo comando creerà una cartella dpn contenente le Debian Project News. La bozza più recente è nella cartella dpn/current.

Editing

  • Spostati nella cartella contenente il checkout. Se non è stata rinominata, dovrebbe essere dpn.

  • Prima di scrivere o modificare dovresti lanciare git pull, così da aggiornare la tua copia locale.

  • Ora puoi modificare il file index.wml come preferisci. Vedi sotto per i dettagli sul formato.

  • Invia con un commit le tue modifiche con git commit index.wml

  • Dopo aver modificato il file index.wml, lancia git update --rebase, nel caso qualcun altro avesse modificato quel documento mentre ci lavoravi.

    • Git cerca di essere intelligente, quando applica modifiche esterne al tuo documento modificato: a meno che le modifiche (tue e dell'altro autore) non riguardino proprio la stessa riga, tutto dovrebbe funzionare bene.
    • Nel caso in cui abbiate modificato le stesse identiche righe, si crea un cosiddetto conflitto che deve essere risolto. Per sapere come farlo leggi questa pagina

  • Una volta che la tua copia locale è aggiornata, puoi inviare le tue modifiche al repository centrale lanciando il comando git push.

  • Congratulazioni: hai appena contribuito al prossimo numero del Debian Project News!

Esistono, inoltre, svariate interfacce grafiche per Git. Tuttavia, poiché l'autore manca di esperienza al riguardo, non si sente di consigliarne alcuna.

Due ulteriori consigli riguardanti il commit delle proprie modifiche:

  1. Usa un messaggio di commit (la descrizione dei tuoi cambiamenti dopo il parametro "-m") che sia utile ed esplicativo.
  2. Cerca di non usare righe troppo lunghe: tenere conto dei cambiamenti o vedere i diff è più facile se la lunghezza delle righe è inferiore agli 80 caratteri. Molti editor possono essere configurati per andare a capo automaticamente oltre un certo numero di caratteri.

Formato del file index.wml

Il Debian Project News è disponibile in tre formati:

Tutti questi formati sono generati dal file index.wml. Il sito Debian utilizza il website meta language (WML) per creare le pagine web. Grossomodo il WML è HTML con inserite delle macro (ad esempio per elementi comuni in vari siti) e la possibilità di inserire script perl, ad esempio creare un elenco dei numeri di DPN in base ai file disponibili. Ma niente paura: non è necessario conoscere il WML o il perl (ma solo un po' di HTML) per contribuire a DPN. Fortunatamente, quasi ogni cosa è già al suo posto e c'è solo bisogno di creare i contenuti con davvero poco markup HTML.

Se guardi un index.wml vuoto (dai un'occhiata a questo che viene usato come modello) noterai che inizia così:

#use wml::debian::projectnews::header PUBDATE="2017-MM-DD" SUMMARY=""
#use wml::debian::acronyms

La prima riga dice al compilatore wml di usare il modello ("template") project-news per l'intestazione, e inoltre imposta due variabili per la data di pubblicazione e un piccolo riassunto. Il riassunto è utilizzato, ad esempio, nell'indice dei numeri recenti. Non dovrebbe essere troppo lungo.

La riga relativa agli acronimi consente l'uso di acronimi specifici, il che permetterà di mostrare la loro spiegazione quando il puntatore è sopra di essi.

Alla fine vedrai invece qualcosa di simile a questo:

#use wml::debian::projectnews::footer editor="The Publicity Team with contributions from contributor1, contributor2, contributor3"

Questo dice al compilatore wml di aggiungere il piè di pagina normale alla pagina web. Con la variabile editor verranno inseriti anche i nomi dei redattori lì elencati.

Tutto ciò che è compreso tra quelle righe, è quasi normale HTML, che nel nostro caso significa soprattutto: alcuni titoli (<toc-add-entry>...</toc-add-entry>), alcuni paragrafi (<p>...</p>) o qualche elenco (<ul><li>...</li><li>...</li></ul>).

Ogni articolo deve iniziare con un nome univoco:

<toc-add-entry name="$anchor_univoco">$mio_titolo</toc-add-entry>
<p>Questo è il contenuto del mio breve articolo, dove posso inserire <a href="http://debian.org/">collegamenti</a> e altri markup HTML.</p>

Ciò che si trova tra <toc-add-entry> e </toc-add-entry> è il titolo vero e proprio.

Dopo il titolo abbiamo l'articolo vero e proprio, contenuto tra i tag <p> e </p>. Si possono usare svariati paragrafi, ma è importante notare come solo il primo di questi apparirà nei feed RSS. (Questo potrebbe essere un bug degno di essere corretto, nel caso tu conosca il Perl...)

Come detto, puoi usare il normale HTML in questi paragrafi; questo significa:

  • <q>...</q> per i virgolettati, le citazioni o i nomi delle release:

    • Debian 6.0 <q>squeeze</q>, Steve McIntyre ha detto: <q>Boh!</q>

  • <a href="..."> per i link:

    • Il Segretario ha <a href="http://lists.debian.org/debian-devel-announce/2010/03/msg00000.html">aperto le liste per i candidati</a> alle elezioni del leader del progetto.

  • <!-- ... --> per i commenti, che non appariranno sul sito:

    • {<!-- TODO:  Aggiungi un collegamento quando questa discussione è terminata! -->

Poiché il Project News viene letto anche da utenti che non hanno familiarità con il gergo interno di Debian e i suoi acronimi, va usato anche il tag <acronym ...> </acronym> (non fa parte di HTML ma di uno dei nostri template wml). Si veda il seguente esempio:

One topic discussed was: <q>Race against <acronym lang="en" title="None of the above">NOTA</acronym>.</q>

Anche se non funzionerà nelle versioni in formato testo per le e-mail, almeno nella versione HTML per il sito e nei feed RSS questo marcherà l'acronimo in modo che quando l'utente muove il mouse sopra di esso, ne viene mostrato il significato. Per vedere un esempio vai a questa pagina: http://www.debian.org/News/project/2009/02/ (cerca l'acronimo DPL).

Tradurre le Debian Project News

Sentiti anche libero di usare il repository Git per il tuo lavoro di traduzione. In questi casi è più facile fare semplicemente il checkout della completa gerarchia del DPN nel repository Git, seguendo questi passi:

  • git clone git@salsa.debian.org:publicity-team/dpn.git

  • cd dpn

  • Ora guarda se esiste già una directory per la tua lingua. Se non esiste
    • creane una, ad esempio mkdir it

    • crea la sottodirectory anno/numero corrispondente (es. mkdir -p 2015/07)

    • aggiungi una prima versione (va bene anche una bozza) della tua traduzione come index.wml

    • aggiungila al repository, ad esempio git add fr/

    • fai il commit locale delle tue modifiche git commit -m"primi passi di traduzione"

    • e invia le modifiche al server centrale, es. git push

  • Ora puoi imitare la stessa struttura della directory utilizzata nella cartella en. I vecchi numeri sono posti nelle directory specifiche en/<anno>/<numero>, quello attualmente in lavorazione è nella directory en/current. Inoltre en/index.wml-template, che è un numero vuoto, è usato come template per iniziarne uno nuovo.

  • Leggi Diventare un redattore per alcune linee guida sull'uso di Git e una breve descrizione del formato dei file wml. Ma tieni presente che:

    • i traduttori devono usare anche un header ulteriore: #use wml::debian::translation-check translation="<revision_git_hash>", che serve a segnalare su quale revisione dell'originale si basa la traduzione. Tuttavia per il momento lasciare <revision_git_hash> vuoto; la persona che farà l'effettiva pubblicazione del numero copierà l'hash corrispondente quando la versione inglese viene aggiunta al repository del sito web.

  • In modo simile a quanto avviene per i redattori nel campo editor della riga #use wml::debian::projectnews::footer}}, i traduttori possono aggiungere un campo {{{translator in modo simile.

Ad esempio (per il francese):

#use wml::debian::projectnews::footer editor="L'équipe en charge de la publicité avec des contributions de Thomas Lange et Paulo Henrique de Lima Santana et Jean-Pierre Giraud" translator="Jean-Pierre Giraud, l\'équipe francophone de traduction"

Usare "Translation check" per tenere traccia delle versioni dell'originale (FIXME: Sezione non aggiornata)

Nota: Questa sezione non è più aggiornata, lo script è stato progettato per usare Subversione e ora invece viene usato GIt. Queste informazioni vengono mantenute nel caso qualcuno voglia aggiornare lo script.

Se usi il repository di publicity, puoi usare lo script in scripts/trans-check per tenere traccia di quali delle tue traduzioni necessitano aggiornamenti. A questo scopo le tue traduzioni hanno bisogno di un campo translation-check. Ad esempio:

#use wml::debian::translation-check translation="45"

Questo dice allo script (e successivamente al sito Debian) che la tua traduzione è basata sulla revisione 45 del documento originale.

L'unico parametro da dare è la lingua da controllare o, per essere più precisi, la cartella da confrontare con la cartella en/. Si veda l'esempio sotto riportato:

alex@rusalka:publicity/dpn$ scripts/trans-check fr
Found 'fr/current/index.wml' is outdated!
  Please run 'svn diff -r 9:18 "en/current/index.wml"' to review the changes to the original document.

Far pubblicare la propria traduzione

Come brevemente spiegato nella sezione Formato del file index.wml, le Debian Project News sono pubblicate in tre modi:

  • in HTML sul sito Debian
  • sotto forma di feed RSS (anch'esso sul sito Debian)
  • mail di testo inviata a varie liste

Per far sì che la tua traduzione venga pubblicata sul sito Debian, sarà necessario aggiungerla al repository webml. Per maggiori informazioni vedere http://www.debian.org/devel/website/ .

Per inviare le tue traduzioni sotto forma di e-mail ad una delle nostre mailing list utenti, tieni presente che le liste debian-news-lingua sono moderate, quindi mettiti in contatto con i rispettivi moderatori o con il tuo gruppo di localizzazione (ad esempio attraverso la lista debian-l10n-lingua). Se non c'è una lista debian-news-lingua per la tua lingua, ma esiste una lista debian-user-lingua, puoi mandare la tua traduzione a quest'ultima (a seconda di cosa ne pensano i membri della lista).

A prescindere da dove la invii, troverai lo script scripts/DPNhtml2mail.pl piuttosto comodo: quando la traduzione è disponibile sul sito, devi solo lanciarlo e creerà la versione in formato testo. Puoi lanciarlo in questo modo: scripts/DPNhtml2mail.pl -d -l en -i 2008/06. Non sarà ancora perfetto, ma è un modo davvero semplice di creare delle versioni di testo esteticamente gradevoli.

Flusso di lavoro attuale (team francese)

Questo è il flusso di lavoro utilizzato (più o meno) dal gruppo di traduzione in francese.

  1. Dopo ogni rilascio https://salsa.debian.org/publicity-team/dpn/tree/master/LL/current viene spostato nella posizione appropriata (es. 2010/01). Poi viene creata una nuova directory current e vi viene copiato dentro index.wml-template, per iniziare con una traduzione nuova e vuota delle notizie.

  2. Circa una settimana prima della pubblicazione del nuovo numero, si inizia la traduzione di ciò che è disponibile (per evitare di fare lavoro all'ultimo minuto di fretta e possibilmente non di buona qualità).
  3. Se ci sono già abbastanza articoli (diciamo quattro o cinque), viene inviata la bozza WIP all'indirizzo debian-l10n-<lingua>@l.d.o per la revisione.

  4. Quando le DPN sono in fase string-frozen, cercare di finire il più velocemente possibile; chiedere aiuto in debian-l10n-language@l.d.o può essere una buona idea e offre a ogni membro la possibilità di fornire almeno un articolo tradotto (chiedere esplicitamente di indicare su quale articolo si lavora per evitare duplicati).

  5. Quando il DPN tradotto è completo, si spera venerdì o sabato, chiedere una revisione formale in debian-l10n-<lingua>@l.d.o.

  6. Il lunedì successivo, pubblicare le DPN tradotte sul sito web seguendo quelle originali e inviare un'ultima chiamata per commenti in debian-l10n-<lingua>@l.d.o.

  7. Due o tre giorni dopo, inviare le DPN su debian-news-<lingua>@l.d.o.

Commenti e problemi con il flusso di lavoro attuale

  • Il tempo a disposizione per chi contribuisce per revisionare il numero è poco, da qui deriva la proposta di fornire una bozza WIP parziale per la revisione con una settimana d'anticipo.
  • Dipende pesantemente da una DPN che non sia modificata all'ultimo minuto ;-).

  • Viene comunque rilasciata due o tre giorni dopo la sua data obiettivo.