Template:Autori: differenze tra le versioni

Versione attuale delle 10:37, 28 mar 2021

Anteprima

Guida scritta da: Socrate	Debianized 60%
Estesa da: Aristofane 21:21, 14 gen 2014 (CEST) (aggiunto un capitolo alla storia)
Verificata da: Alcibiade 19:11, 9 ago 2013 (CEST) Fedro 11:29, 6 lug 2014 (CEST)
Verificare ed estendere la guida \| Cos'è una guida Debianized

Cos'è

Questo template consente di firmare una guida e, al tempo stesso, tenere traccia di tutte le sue revisioni significative e verifiche. Tutti possono aggiungere il proprio nome utente al template in caso di revisione o estensione della guida. Così facendo si fa in modo che la maturità della guida le permetta di essere contrassegnata come Debianized, ossia che raggiunga un alto grado di accuratezza e completezza per poter essere di maggior aiuto a tutte le persone che fanno parte della comunità Debian.

Utilizzo

L'utilizzo è il seguente:

{{Autori
|Autore = Firma dell'autore della guida
|Estesa_da =
: Firma di Utente1
: Firma di Utente2
: Firma di Utente3
|Verificata_da=
: Firma di Utente4
: Firma di Utente5
: Firma di Utente6
}}

Da tener presente che:

Il template va inserito in fondo alla guida.
In caso di pagine riunite sotto lo stesso argomento tramite il template "Sommario", questo template va inserito solo sulla pagina principale.

Autore

Se la guida è stata appena creata e dunque non vi sono revisioni o verifiche, è sufficiente firmarla:

{{Autori
|Autore = ~~~~
}}

a tal proposito, vedere anche come firmare una guida.

Nel caso si trattasse di una guida il cui contenuto è stato il risultato dell'impegno di più membri della comunità, specificare l'autore come "Debianizzati.org". In tal caso sarà anche possibile specificare il link alla discussione che ha originato la guida. Ad esempio:

{{Autori
|Autore = Debianizzati.org
|Link = http://forum.debianizzati.org/viewtopic.php?...
}}

È consigliato specificare separatamente per le verifiche i nominativi di coloro che hanno contribuito alla stesura della guida, in modo che il livello di debianizzazione rifletta il suo livello di affidabilità. Purtroppo, senza verifiche, una guida che avesse come autore la comunità di Debianizzati risulterebbe perfino meno testata di quella scritta da una singola persona.

Si ricorda inoltre che ogni carattere =, per esempio all'interno del link, dovrebbe essere sostituito con {{=}} in quanto = è un carattere speciale all'interno di un template.

Verifiche

Se avete seguito la guida e ne avete accertato la validità, allora potete aggiungere il vostro nome utente al template semplicemente inserendo la firma attraverso il parametro Verificata_da.
Quindi le modifiche ad esempio a:

{{Autori
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
}}

saranno, per una verifica di nomeutente:

{{Autori
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Verificata_da =
:~~~~
}}

oppure, se esistono già delle verifiche da parte di altri utenti, le modifiche saranno, ad esempio, da:

{{Autori
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Verificata_da =
: pluto 10:22, 22 feb 2013 (CEST) 
}}

a:

{{Autori
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Verificata_da =
: pluto 10:22, 22 feb 2013 (CEST) 
: ~~~~
}}

Ciascuno può verificare la guida in ogni momento e, nel caso di modifiche successive da parte di altri utenti, decidere se lasciare il proprio nome utente tra i revisori o rimuoverlo.
Anche in caso di più verifiche, ognuno può aggiungere il proprio nome alla lista dei revisori soltanto una volta.
È importante che ogni aggiunta di una firma alla lista dei revisori avvenga su una riga separata e preceduta dal carattere "due punti" ":"

Estensione della guida

Se estendete la guida in maniera significativa, ad esempio con l'aggiunta di paragrafi o intere sezioni, potete inserire il vostro nome utente attraverso il parametro Estesa_da in modo simile agli esempi precedenti.
Se la modifica interessasse la maggior parte della guida, tanto da risultare quasi in una sua riscrittura, tutte le precedenti verifiche sono da rimuovere. In caso di dubbi, utilizzare la pagina di discussione della guida. Per questo motivo, prima di modificare una guida Debianized, si raccomanda la lettura di questa pagina.

Ovviamente è anche possibile aggiungere il proprio nome utente sia alla lista dei revisori, come visto prima, sia alla lista degli estensori.

Per aggiungere il proprio nome utente nel caso esista solo l'indicazione dell'autore:

{{Autori
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
}}

diventa:

{{Autori 
|Autore = pippo
|Estesa_da = 
: ~~~~
}}

Nel caso esistano revisioni e altre estensioni:

{{Autori 
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Estesa_da = 
: sempronio 20:01, 03 apr 2013 (CEST) 
|Verificata_da = 
: tizio 23:07, 21 lug 2014 (CEST) 
: caio 18:10, 21 feb 2015 (CEST) 
}}

diventerà:

{{Autori 
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Estesa_da =   
: sempronio 20:01, 03 apr 2013 (CEST) 
: ~~~~
|Verificata_da = 
: tizio 23:07, 21 lug 2014 (CEST) 
: caio 18:10, 21 feb 2015 (CEST) 
}}

Nel caso di estensione della guida e sua contemporanea verifica:

{{Autori
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Estesa_da =
: sempronio 20:01, 03 apr 2013 (CEST) 
|Verificata_da =
: tizio 23:07, 21 lug 2014 (CEST) 
: caio 18:10, 21 feb 2015 (CEST) 
}}

diventa:

{{Autori 
|Autore = pippo 10:11, 21 feb 2013 (CEST) 
|Estesa_da =  
: sempronio 20:01, 03 apr 2013 (CEST) 
: ~~~~
|Verificata_da = 
: tizio 23:07, 21 lug 2014 (CEST) 
: caio 18:10, 21 feb 2015 (CEST) 
: ~~~~
}}

si ricorda sempre che le quattro tilde (~~~~) vengono convertite automaticamente nel nome utente dell'utente e nella data corrente.

Numero di revisori

Il numero dei revisori, e il conseguente incremento delle percentuale di "debianizzazione" della guida, viene automaticamente ricavato da questo script Lua a partire dal numero di coloro che hanno aggiunto il proprio nickname tramite il parametro "Verificata_da".
Il parametro "Numero_revisori", utilizzato in precedenza a tale scopo, non viene più considerato e può essere tranquillamente rimosso se lo si trova all'interno del template sulle pagine del wiki.

Guide adottate

Nel caso si sia adottata una guida, al termine del suo completamento bisogna rimuovere le precedenti revisioni/estensioni dal template e aggiungervi solo il proprio nome utente oltre a un breve richiamo all'autore originario come piccola forma di riconoscenza per aver messo a disposizione parte del proprio tempo per affrontare l'argomento:

{{Autori
|Autore = ~~~~<br/>
(guida originariamente scritta da pluto)
}}

Dove non inserire il template

Su diverse guide il template non va inserito.

Pagina principale
Indice Guide
FAQ
Tabella Software e Lista Hardware
Pagine di help: Aiuto:Linee guida su come contribuire al Wiki
Recensioni di libri
Pagine di glossario
Categorie e pagina delle categorie
Template
Pagine che appartengono esclusivamente a una o più delle seguenti categorie: "Wiki", "Debianizzati", "Filosofia di Debian" o "Storia di Debian"
Pagine da cancellare
Installazione Debian: pagine utili
Installare Debian
Elenco laptop debianizzati
Elenco programmi senza interfaccia grafica
Pagine successive ad una guida con sommario verticale (esempio)
Guide che rimandano agli articoli dell'e-zine (esempio)
Revisione Wiki
Adozione Guide
Pagine incomplete
Guide da adottare

@@ Riga 7: / Riga 7: @@
      }} | {{{Autore}}}
 }}
-|rowspan="3" width="5%" align="center" valign="top" |
+|rowspan="3" width="5%" align="center" valign="top" | {{ #invoke: Autori_Lua | getimage }}
-{{#ifeq: {{{Autore}}} | Debianizzati.org |
-{{#switch: {{{Numero_revisori|}}}
-| 0 = [[image:Swirl-auth0.png|60px|link=]] <small>Debianized 0%</small>
-| 1 = [[image:Swirl-auth20.png|60px|link=]] <small>Debianized 20%</small>
-| 2 = [[image:Swirl-auth40.png|60px|link=]] <small>Debianized 40%</small>
-| 3 = [[image:Swirl-auth60.png|60px|link=]] <small>Debianized 60%</small>
-| 4 = [[image:Swirl-auth80.png|60px|link=]] <small>Debianized 80%</small>
-| 5
-| 6
-| 7
-| 8
-| 9
-| 10 = [[image:Swirl-auth100.png|60px|link=]] <small><span style="color:red">Guida Debianized</span></small>[[Categoria:Debianized]]
-| #default = [[image:Swirl-auth0.png|60px|link=]] <small>Debianized 0%</small>
-}} |
-{{#switch: {{{Numero_revisori|}}}
-| 0 = [[image:Swirl-auth20.png|60px|link=]] <small>Debianized 20%</small>
-| 1 = [[image:Swirl-auth40.png|60px|link=]] <small>Debianized 40%</small>
-| 2 = [[image:Swirl-auth60.png|60px|link=]] <small>Debianized 60%</small>
-| 3 = [[image:Swirl-auth80.png|60px|link=]] <small>Debianized 80%</small>
-| 4
-| 5
-| 6
-| 7
-| 8
-| 9
-| 10 = [[image:Swirl-auth100.png|60px|link=]] <small><span style="color:red">Guida Debianized</span></small>[[Categoria:Debianized]]
-| #default = [[image:Swirl-auth20.png|60px|link=]] <small>Debianized 20%</small>
-}} }}
 |-
 | ''Estesa da:''
@@ Riga 81: / Riga 52: @@
 : Firma di Utente5
 : Firma di Utente6
-|Numero_revisori = numero
 }}
 </pre>
@@ Riga 104: / Riga 74: @@
 }}
 </pre>
-È consigliato specificare separatamente per le verifiche i nominativi di coloro che hanno contribuito alla stesura della guida, in modo che il livello di debianizzazione rifletta il suo livello di affidabilità. Purtroppo, senza verifiche, una guida che avesse come autore la comunità di debianizzati risulterebbe perfino meno testata di quella scritta da una singola persona.
+È consigliato specificare separatamente per le verifiche i nominativi di coloro che hanno contribuito alla stesura della guida, in modo che il livello di debianizzazione rifletta il suo livello di affidabilità. Purtroppo, senza verifiche, una guida che avesse come autore la comunità di Debianizzati risulterebbe perfino meno testata di quella scritta da una singola persona.
 Si ricorda inoltre che ogni carattere '''<code>=</code>''', per esempio all'interno del link, dovrebbe essere sostituito con '''<code><nowiki>{{=}}</nowiki></code>''' in quanto '''<code>=</code>''' è un carattere speciale all'interno di un [[template]].
 === Verifiche ===
-Se avete seguito la guida e ne avete accertato la validità, allora potete aggiungere il vostro nome utente al template semplicemente inserendo la firma attraverso il parametro '''Verificata_da'''. È necessario anche aumentare di uno il parametro '''Numero_revisori'''.<br/>
+Se avete seguito la guida e ne avete accertato la validità, allora potete aggiungere il vostro nome utente al template semplicemente inserendo la firma attraverso il parametro '''Verificata_da'''.<br/>
 Quindi le modifiche ad esempio a:
 <pre>
@@ Riga 122: / Riga 92: @@
 |Verificata_da =
 :~~~~
-|Numero_revisori = 1
 }}
 </pre>
@@ Riga 131: / Riga 100: @@
 |Verificata_da =
 : pluto 10:22, 22 feb 2013 (CEST)
-|Numero_revisori = 1
 }}
 </pre>
@@ Riga 141: / Riga 109: @@
 : pluto 10:22, 22 feb 2013 (CEST)
 : ~~~~
-|Numero_revisori = 2
 }}
 </pre>
-# Ciascuno può verificare la guida in ogni momento e, nel caso di modifiche successive da parte di altri utenti, decidere se lasciare il proprio nome utente tra i revisori o rimuoverlo. In quest'ultimo caso è necessario decrementare di uno il parametro "Numero_revisori".
+# Ciascuno può verificare la guida in ogni momento e, nel caso di modifiche successive da parte di altri utenti, decidere se lasciare il proprio nome utente tra i revisori o rimuoverlo.
 # Anche in caso di più verifiche, ognuno può aggiungere il proprio nome alla lista dei revisori soltanto una volta.
 # È importante che ogni aggiunta di una firma alla lista dei revisori avvenga su una riga separata e preceduta dal carattere "due punti" ":"
-# Accertarsi, dopo ogni modifica, che il numero dei revisori associato a "Numero_revisori" sia uguale al numero di coloro che hanno verificato la guida.
-# L'autore della guida viene già considerato e conteggiato come revisore, pertanto non deve incrementare il parametro "Numero_revisori".
 === Estensione della guida ===
@@ Riga 154: / Riga 119: @@
 Se la modifica interessasse la maggior parte della guida, tanto da risultare quasi in una sua riscrittura, tutte le precedenti verifiche sono da rimuovere. In caso di dubbi, utilizzare la pagina di discussione della guida. Per questo motivo, prima di modificare una guida '''Debianized''', si raccomanda la lettura di [[Debianized|questa pagina]].
-Ovviamente è anche possibile aggiungere il proprio nome utente sia alla lista dei revisori, come visto prima, incrementando di uno il parametro "Numero_revisori", sia alla lista degli estensori.
+Ovviamente è anche possibile aggiungere il proprio nome utente sia alla lista dei revisori, come visto prima, sia alla lista degli estensori.
 * Per aggiungere il proprio nome utente nel caso esista solo l'indicazione dell'autore:
@@ Riga 179: / Riga 144: @@
 : tizio 23:07, 21 lug 2014 (CEST)
 : caio 18:10, 21 feb 2015 (CEST)
-|Numero_revisori = 2
 }}
 </pre>
@@ Riga 192: / Riga 156: @@
 : tizio 23:07, 21 lug 2014 (CEST)
 : caio 18:10, 21 feb 2015 (CEST)
-|Numero_revisori = 2
 }}
 </pre>
@@ Riga 204: / Riga 167: @@
 : tizio 23:07, 21 lug 2014 (CEST)
 : caio 18:10, 21 feb 2015 (CEST)
-|Numero_revisioni = 2
 }}
 </pre>
 diventa:
 <pre>
 {{Autori
 |Autore = pippo 10:11, 21 feb 2013 (CEST)
@@ Riga 218: / Riga 180: @@
 : caio 18:10, 21 feb 2015 (CEST)
 : ~~~~
-|Numero_revisori = 3
 }}
 </pre>
@@ Riga 224: / Riga 185: @@
 === Numero di revisori ===
-Coloro i quali verificano una guida (revisori), devono accertarsi che il parametro '''Numero_revisori''' sia specificato e che contenga l'esatto numero di revisori.<br/>
+Il numero dei revisori, e il conseguente incremento delle percentuale di "debianizzazione" della guida, viene automaticamente ricavato da [[Modulo:Autori_Lua | questo script Lua]] a partire dal numero di coloro che hanno aggiunto il proprio nickname tramite il parametro "Verificata_da".<br/>
-Il valore del parametro è necessario per modificare automaticamente nel template il riempimento della [[Debian Swirl|swirl]], fino ad arrivare ad una guida '''[[Debianized]]'''.
+Il parametro "Numero_revisori", utilizzato in precedenza a tale scopo, non viene più considerato e può essere tranquillamente rimosso se lo si trova all'interno del template sulle pagine del wiki.
 == Guide adottate ==