BR Include(/Header) BR

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.