A little italian 2 pages manual for users that want to discover Firefox and the community
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Readme

In questo file verrà spiegato cos'è il vademecum e come poter collaborare. Verranno elencati coloro che hanno collaborato nella realizzazione.

È ALTAMENTE CONSIGLIATO LEGGERE PRIMA IL FILE CONTRIBUTING.MD

Contiene tutte le informazioni utili per sapere come essere utile e collaborare al progetto e le REGOLE di stile da SEGUIRE per realizzare un progetto ben fatto ed uniforme.

Mappa file

  • Cos'è
  • Tipi di versione e release attuale
  • Come collaborare & Regole di stile
  • Come viene generato il pdf finale
  • Collaboratori
  • Licenza

Cos'è

Vademecum, dal latino vade mecum, significato letterario vieni con me e figurativo ti do una mano è un progetto Mozilla Italia e consiste nella realizzazione di un volantino (digitale e stampato) che permetta di capire in un foglio A4 (suddiviso in sezioni) cos'è Mozilla, Firefox e tutti i progetti correlati; l'importanza sta nel fatto che tutti questi concetti vengano espressi in pochissimo spazio e debbano essere soddisfacenti.

Tipi di versione e release attuale

L'attuale release è la 1.2. Ci sono due tipi di versioni: generale, indirizzata a un pubblico con competenze non specificate, quindi non necessariamente tecniche, e la versione tecnica, indirizzata a un pubblico con competente prettamente tecniche, in quanto molti concetti vengono sottintesi e vengono approfonditi temi più "tecnici", appunto. Per brevità, la versione generale può essere indicata come "VG" mentre la versione tecnica come "VT".

Come collaborare & Regole di stile

Per sapere come contribuire/collaborare e per leggere le regole di stile si prega di leggere il file contributing.md.

Come viene generato il PDF finale

Una volta volta aggiornato correttamente il file vademecum.md si passa ad aggiornare, manualmente, anche il file HTML. Terminato anche questo passaggio, viene generato il PDF automaticamente tramite uno script (vedi file nella cartella scripts) che, partendo dal file HTML, ne genera il PDF. Dall'HTML, inoltre, vengono generate le due immagini PNG (FRONTE e RETRO). Per la generazione (conversione) HTML->PDF e HTML->PNG è stata usato il tool da CLI wkhtmltopdf e wkhtmltoimage. Per informazioni più specifiche riguardo il file HTML o il file CSS contattare @Sav22999 o @Mte90, invece, per informazioni relative al file SH contattare @mone27, @Sav22999 o @Mte90.

Collaboratori

Hanno collaborato alla realizzazione del vademecum (ordine A-Z):

  • Cantu Niccolo
  • De Rose Pasquale
  • Massaro Simone
  • Morelli Saverio
  • Pignataro Giuseppe
  • Pirrotta Irene
  • Pizii Mirko
  • Putti Edoardo
  • Scasciafratte Daniele
  • Viola Edoardo

Licenza

La licenza utilizzata per Vademecum è la Creative Commons - Attribution (BY), ShareAlike (SA) 2.0 Italia (Attribuzione, Condivisione allo stesso modo)

Disponibile all'indirizzo https://creativecommons.org/licenses/by-sa/2.0/it/ (o quella completa https://creativecommons.org/licenses/by-sa/2.0/it/legalcode)

Ulteriori informazioni

Coordinatore del progetto è @Mte90.