In questo file verrà spiegato cos'è il vademecum e come poter collaborare. Verranno elencati coloro che hanno collaborato nella realizzazione.
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.
- Cos'è
- Tipi di versione, release attuale e come scaricare i file da stampare
- Come collaborare & Regole di stile
- Come viene generato il pdf finale
- Vademecum realizzato da
- Licenza
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.
L'attuale release è la 2.0. 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". Per scaricare i file stampabili, recarsi nella cartella volantino, poi pdf, quindi scegliere la versione che si desidera. Fai clic qui per andare direttamente alla cartella pdf.
Per sapere come contribuire/collaborare e per leggere le regole di stile si prega di leggere il file contributing.md.
Una 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.
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
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)
Coordinatore del progetto è @Mte90.