Differenze tra le versioni 1 e 9 (in 8 versioni)

Introduzione

In questa pagina verranno elencate le convenzioni adottate, e da adottare, nella stesura della newsletter.

La numerazione della newsletter

La numerazione della newsletter sarà composta da 7 cifre, in due gruppi di 4 e di 3 cifre ciascuno separati da un punto.

Il gruppo di 4 cifre indica l'anno della newsletter, il gruppo di 3 cifre è un progressivo indicante il numero effettivo della newsletter.

La numerazione del progressivo parte dal numero 001, a ogni cambio di anno viene ripristinata. Il numero 000 è relativo alla newsletter promozionale e non viene mai usato.

Un esempio: la terza newsletter dell'anno 2007 avrà come numero 2007.003.

Le pagine della newsletter

Le pagine della newsletter vengono create come sottopagina della pagina [:NewsletterItaliana]. La pagina promozionale, identificata dal numero 2007.000, è la pagina [:NewsletterItaliana/2007.000].

Stile per la scrittura delle newsletter

Lo stile da adottare nella stesura delle newsletter è lo stesso adottato all'interno del wiki.

Per maggiori informazioni consultate la pagina [:GuidaWiki/StileDellePagine:StileDellePagine]. Per una guida su come modificare la pagine del wiki consultare la pagina [:GuidaWiki].

Alcune note

Nella creazione della newsletter per l'invio tramite email, viene utilizzato uno script recuperabile nella pagina [:../Materiale:Materiale] (file newsletter.py). Affinché lo script svolga il suo lavoro, è necessario adottare della "sintassi" precisa per alcuni elementi della newsletter.

I collegamenti esterni (URL), se racchiusi tra parentesi quadre, vengono messi tra parentesi tonde. Questo per il fatto che è possibile "rinominare" un collegamento URL. Per esempio, se il collegamento è:
```
[http://www.ubuntu-it.org il sito di Ubuntu]
```
viene reso come:
```
il sito di Ubuntu (http://www.ubuntu-it.org)
```

I riferimenti interni al wiki devono essere indicati tra parentesi quadre. Per esempio:

Consultare la pagina [:PaginaProva:PaginaProva]...

viene reso come:

Consultare la pagina PaginaProva (http://wiki.ubuntu-it.org/PaginaProva)

Per questi collegamenti è possibile utilizzare anche la sintassi:

[:PaginaProva]

Per i riferimenti al wiki internazionale, è possibile utilizzare:

[wiki:Ubuntu/PaginaWiki pagina del wiki internazionale]

che viene reso come:

pagina del wiki internazionale (http://wiki.ubuntu.com/PaginaWiki)

Per non far riconoscere al motore del wiki una pagina come una pagina wiki, è necessario utilizzare i due apici inversi all'interno della parola, non si può utilizzare il punto esclamativo in principio di parola. Per esempio:
```
il progetto Open``Office...
```
viene reso come:
```
il progetto OpenOffice...
```

Grafico dei bug

Per la creazione del grafico relativo ai bug, i dati vengono presi dalla pagina [https://launchpad.net/ubuntu/+bugs], basta espandere la sezione chiamata Filters. I dati utili sono:

Open
Critical
New
Unassigned

I valori relativi vanno riportati all'interno del file bug.odspresente nella pagina [:../Materiale:Materiale].

Una volta inseriti i dati basta selezionare il grafico, copiarlo e incollarlo all'interno del file bug.odg per l'esportazione in PNG. il nome del file solitamente è:

bugAAAA.NNN.png

in cui:

AAAA è l'anno della newsletter,
NNN è il numero della newsletter a cui fa riferimento il grafico.

Usare lo script

Per usare lo script per la creazione della newsletter per l'invio via email, basta scaricare il file newsletter.py dalla pagina [:../Materiale:Materiale], dare i permessi di esecuzione al file e avviarlo semplicemente con:

./newsletter.py

Lo script chiederà quindi l'anno e il numero della newsletter da scaricare. Verranno chiesti anche i dati relativi ai bug.

Tutte le tabelle presenti all'interno della newsletter vengono eliminate dallo script.

Limitazioni dello script

Non gestisce gli indirizzi di posta inseriti attraverso la macro [[MailTo()]]
Non inserisce automaticamente il collegamento alla newsletter online, è quindi necessario inserirlo "a mano" dopo il testo iniziale, prima delle "Notizie dal mondo" citando:
```
Per la versione online della newsletter consultate: [collegamento]
```
Non invia automaticamente la newsletter in mailing list
Presenta degli errori nel caso di parole con apostrofo quando queste vengono rese con l'uso del grassetto o del corsivo (lo script elimina gli apici usati per questi casi)

Invio della newsletter

Una volta creata la newsletter per l'invio tramite email, è necessario inviare "manualmente" una email alla mailing list di supporto italiano di Ubuntu: [https://lists.ubuntu.com/mailman/listinfo/ubuntu-it].

L'oggetto dell'email deve essere:

Newsletter italiana, numero XX

in cui XX è il numero della newsletter inviata.

-  ⇤ ← Versione 1 del 18/01/2007 19.43.10 → 
  Dimensione: 1453
  Autore: MiloCasagrande
  Commento: creata la pagina con le poche convenzioni da adottare
+   ← Versione 9 del 08/03/2008 14.56.05 → ⇥
  Dimensione: 5293
  Autore: PaoloGarbin
  Commento: aggiornato l'header..
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 3:
-||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">[[TableOfContents]]||
+[[Include(../Header)]]
[[BR]]
||<tablestyle="float:right; font-size: 0.9em; width:35%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Indice'''[[BR]] [[TableOfContents]]||
-Linea 21:
+Linea 23:
-Le pagine della newsletter, vengono create come sottopagina della pagina [:NewsletterItaliana]. La pagina promozionale, identificata dal numero '''2007.000''', è la pagina [:NewsletterItaliana/2007.000].
+Le pagine della newsletter vengono create come sottopagina della pagina [:NewsletterItaliana]. La pagina promozionale, identificata dal numero '''2007.000''', è la pagina [:NewsletterItaliana/2007.000].
-Linea 25:
+Linea 27:
-Lo stile da adottare nella stesura delle newsletter, è lo stesso adottato all'interno del wiki.
+Lo stile da adottare nella stesura delle newsletter è lo stesso adottato all'interno del wiki.
-Linea 27:
+Linea 29:
-Per maggiori informazioni consultate la pagina [:StileDellePagine]. Per una guida su come modificare la pagine del wiki consultare la pagina [:GuidaWiki].
+Per maggiori informazioni consultate la pagina [:GuidaWiki/StileDellePagine:StileDellePagine]. Per una guida su come modificare la pagine del wiki consultare la pagina [:GuidaWiki].

== Alcune note ==

Nella creazione della newsletter per l'invio tramite email, viene utilizzato uno script recuperabile nella pagina [:../Materiale:Materiale] (file `newsletter.py`). Affinché lo script svolga il suo lavoro, è necessario adottare della "sintassi" precisa per alcuni elementi della newsletter.

 * I collegamenti esterni (URL), se racchiusi tra parentesi quadre, vengono messi tra parentesi tonde. Questo per il fatto che è possibile "rinominare" un collegamento URL. Per esempio, se il collegamento è: {{{
[http://www.ubuntu-it.org il sito di Ubuntu]
}}} viene reso come: {{{
il sito di Ubuntu (http://www.ubuntu-it.org)
}}}
 * I riferimenti interni al wiki '''devono''' essere indicati tra parentesi quadre. Per esempio: {{{
Consultare la pagina [:PaginaProva:PaginaProva]...
}}} viene reso come: {{{
Consultare la pagina PaginaProva (http://wiki.ubuntu-it.org/PaginaProva)
}}} Per questi collegamenti è possibile utilizzare anche la sintassi: {{{
[:PaginaProva]
}}} Per i riferimenti al wiki internazionale, è possibile utilizzare: {{{
[wiki:Ubuntu/PaginaWiki pagina del wiki internazionale]
}}} che viene reso come: {{{
pagina del wiki internazionale (http://wiki.ubuntu.com/PaginaWiki)
}}}
 * Per non far riconoscere al motore del wiki una pagina come una pagina wiki, è necessario utilizzare i due apici inversi all'interno della parola, '''non''' si può utilizzare il punto esclamativo in principio di parola. Per esempio: {{{
il progetto Open``Office...
}}} viene reso come: {{{
il progetto OpenOffice...
}}}

= Grafico dei bug =

Per la creazione del grafico relativo ai bug, i dati vengono presi dalla pagina [https://launchpad.net/ubuntu/+bugs], basta espandere la sezione chiamata '''Filters'''. I dati utili sono:
 * '''Open'''
 * '''Critical'''
 * '''New'''
 * '''Unassigned'''
I valori relativi vanno riportati all'interno del file `bug.ods`presente nella pagina [:../Materiale:Materiale].

Una volta inseriti i dati basta selezionare il grafico, copiarlo e incollarlo all'interno del file `bug.odg` per l'esportazione in PNG. il nome del file solitamente è: {{{
bugAAAA.NNN.png
}}} in cui:
 * '''AAAA''' è l'anno della newsletter,
 * '''NNN''' è il numero della newsletter a cui fa riferimento il grafico.

= Usare lo script =

Per usare lo script per la creazione della newsletter per l'invio via email, basta scaricare il file `newsletter.py` dalla pagina [:../Materiale:Materiale], dare i permessi di esecuzione al file e avviarlo semplicemente con: {{{
./newsletter.py
}}} Lo script chiederà quindi l'anno e il numero della newsletter da scaricare. Verranno chiesti anche i dati relativi ai bug.

Tutte le tabelle presenti all'interno della newsletter vengono eliminate dallo script.

== Limitazioni dello script ==

 * Non gestisce gli indirizzi di posta inseriti attraverso la macro `[[MailTo()]]`
 * Non inserisce automaticamente il collegamento alla newsletter online, è quindi necessario inserirlo "a mano" dopo il testo iniziale, prima delle "Notizie dal mondo" citando: {{{
Per la versione online della newsletter consultate: [collegamento]
}}}
 * Non invia automaticamente la newsletter in mailing list
 * Presenta degli errori nel caso di parole con apostrofo quando queste vengono rese con l'uso del grassetto o del corsivo (lo script elimina gli apici usati per questi casi)

= Invio della newsletter =

Una volta creata la newsletter per l'invio tramite email, è necessario inviare "manualmente" una email alla mailing list di supporto italiano di Ubuntu: [https://lists.ubuntu.com/mailman/listinfo/ubuntu-it].

L'oggetto dell'email deve essere: {{{
Newsletter italiana, numero XX
}}} in cui `XX` è il numero della newsletter inviata.