Aiuto:Linee guida su come contribuire al Wiki: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
mNessun oggetto della modifica
m (Aggiunto sommario)
 
(10 versioni intermedie di 2 utenti non mostrate)
Riga 1: Riga 1:
{{Stub}}{{Help}}
__NOTOC__
==Convenzioni==
{{Help}}
Ci sono delle semplici convenzioni da rispettare in modo che il contenuto del Wiki cresca in maniera omogenea e quindi più facile da leggere, per tutti.
Questo sito è un [http://it.wikipedia.org/wiki/Wiki Wiki] e il motore usato si chiama [http://wikipedia.sourceforge.net/ MediaWiki], lo stesso usato da [http://it.wikipedia.org/wiki/Pagina_principale Wikipedia].<br/>
Dopo la registrazione tutti possono creare nuove pagine o modificare quelle esistenti nel rispetto del [[Contratto sociale|contratto sociale]] e delle regole di rispetto reciproco che contraddistinguono questa comunità. Si legga anche la pagina che spiega come [[Collabora al Wiki|contribuire]] a questo Wiki.


=== Versioni compatibili ===
Qui di seguito sono raccolte le pagine che riteniamo possano aiutare a scrivere su questo Wiki; se si hanno dubbi o domande, i membri di questa comunità saranno ben felici di rispondere e intervenire in qualsiasi discussione aperta nella sezione "Guide@Debianizzati.com" del [http://forum.debianizzati.org forum].
Inserite, all'inizio di ogni guida, il template [[Template:Versioni compatibili|Versioni compatibili]], che permette di capire immediatamente a quali versioni di Debian fa riferimento la guida in oggetto. Per le istruzioni specifiche su come inserire questo template si veda la pagina [[Usare_i_Template#Template_Versioni_compatibili|Usare i Template]].


=== Categorie ===
==== [[Aiuto:Prima di iniziare|Prima di iniziare]] ====
Ciascuna guida deve far parte di [[Lista Categorie|una o più categorie]] per essere indicizzata e permetterne una più facile ricerca e individuazione. Ricordarsi pertanto di inserire, in fondo alla guida, il tag ''<nowiki>[[Categoria: nome_della_categoria]]</nowiki>'' per ciascuna categoria di cui la guida andrà a far parte.
:pagina che cerca di riassumere tutto ciò che bisogna conoscere ''prima'' di iniziare a scrivere o modificare una guida, in modo che il Wiki abbia una struttura leggibile e omogenea.
==== [[Aiuto:Creare e modificare una pagina|Creare e modificare una pagina]] ====
:come iniziare a creare le guide del Wiki o modificarne di esistenti.


=== Convenzioni sulla sintassi ===
==== [[Aiuto:Spostare e cancellare una pagina|Spostare e cancellare una pagina]] ====
# Tutte le volte che riportate l'output di un comando, un pezzo di un file di configurazione, o in genere dei dati ASCII, racchiudeteli in un riquadro (racchiudendo tra <nowiki><pre></nowiki> e <nowiki></pre></nowiki>).
:viene spiegato come rinominare il titolo di una guida o cancellare una guida esistente.
# Se riportate un comando usate come primo carattere <code>$</code> se il comando deve essere lanciato da utente normale e <code>#</code> se il comando deve essere lanciato da root. Lasciate anche uno spazio dopo questo carattere, in modo che il comando non risulti attaccato al <code>$</code> o <code>#</code> e quindi poco leggibile.
==== [[Aiuto:Discussioni|Discussioni]] ====
# Quando dovete inserire all'interno del corpo del testo i seguenti elementi:
:cosa sono le discussioni delle pagine e come utilizzarle al meglio.
#* percorsi di file o cartelle;
==== [[Aiuto:Cronologia|Cronologia]] ====
#* nomi di file;
:l'utilissimo strumento associato ad ogni pagina: la sua cronologia.
#* comandi, opzioni di comandi, singole stringhe e/o direttive dei file di configurazione;</blockquote>
==== [[Aiuto:Sintassi|Sintassi]] ====
:racchiudeteli tra i tag <nowiki><code></nowiki> e <nowiki></code></nowiki>.
:la sintassi con cui vengono scritte le guide. Qui sono illustrati i vari tag con cui inserire formattazione per il testo, titoli, immagini, link e tanto altro.


=== Convenzioni sullo stile ===
==== [[Aiuto:Categorie|Categorie]] ====
# Dividete in maniera logica la guida in sezioni, sottosezioni (e, se necessario sotto-sottosezioni). In questo modo si sfrutterà meglio la potenza di MediaWiki che creerà automaticamente un indice iniziale che renderà molto più facile la navigazione nella vostra guida.
:come categorizzare le guide in modo da facilitarne la ricerca.
# Usate, quando necessario, i vari [[Help:Editing|elementi di formattazione]] (descrizioni, riquadro di warning, esempio ecc.): la guida risulterà più leggibile.
==== [[Aiuto:I template|I template]] ====
# Cercate di rendere leggibile e pulito il codice della pagina, evitando ad esempio di lasciare tante righe vuote consecutive.
:in questa guida viene introdotto l'utilizzo e la creazione di un elemento fondamentale di questo Wiki.
==== [[Aiuto:Segnalazione dei problemi|Segnalazione dei problemi]] ====
:la pagina da leggere se si incontrano problemi per cui è necessario scrivere una segnalazione.
==== [[Aiuto:Licenze|Licenze]] ====
:altra pagina fondamentale sulle licenze con cui rilasciare i contenuti del Wiki.


=== Interconnessione dei contenuti ===
==== [[Aiuto:Varie|Varie]] ====
Cercate il più possibile di inserire link ad altre pagine del Wiki, in modo da aumentare le interconnessioni, rendere più facile la ricerca delle informazioni ed evitare inutili ripetizioni in più di una guida..<br/>
:qui sono riassunti ulteriori informazioni non incluse nelle pagine precedenti:
Non è necessario che le pagine verso cui si creano i link debbano esistere (in questo caso il link resterà di colore rosso); la loro creazione può essere successiva da parte dello stesso autore o di altri. In entrambi i casi la presenza di link ad altri contenuti del Wiki renderà la guida stessa più completa e leggibile.
:*Redirect
:*Estensioni
:*Namespace


==Evoluzione delle guide==
==== [[Aiuto:Scheletro_di_nuova_guida|Scheletro/modello di una nuova guida]] ====
Le guide su '''Guide @ Debianizzati.org''' seguono un percorso ''(idealmente)'' simile a quello seguito dai pacchetti Debian nelle tre distribuzioni. Si distinguono infatti tre fasi per una guida:
:presenta un modello utilizzabile come punto di partenza per facilitare la stesura di una nuova guida.
 
* '''Stub''': una guida è in questo stato se è ancora incompleta. Queste guide sono caratterizzate dal seguente box iniziale:
 
 
{| align="center" style="border: 1px solid darkgray; background:#f4f4f4; border-spacing: 0px; width:80%"
| style="background-color:#aeaf9c;" width="4px" |
| style="padding-left:6px" width="45px" |[[image:Trash.png|center|38px]]
| style="padding-left:11px; padding-right:10px" | '''Attenzione'''<br/>Questo articolo è ancora incompleto o richiede delle verifiche. Sentiti libero di contribuire cliccando sul tasto "Modifica".
|-
|}
 
 
inseribile semplicemente aggiungendo all'inizio della guida il seguente testo:
 
<pre>{{stub}}</pre>
 
* '''Guida completa''': la guida è ragionevolmente completa e può essere usata per conoscere nuovi argomenti. Le guide di questo tipo non hanno nessun segno particolare. Le guide complete sono state terminate dall'autore iniziale e cercano una sorta di testing da parte della comunità.
 
* '''Guida Debianized''': è il terzo è ultimo livello raggiungibile da una guida sul wiki. Una guida di questo tipo ha raggiunto la sua piena maturità essendo stata verificata e corretta anche da più di una persona nella community. Le guide Debianized si distinguono con un apposito [[Template:Debianized|Template]] posto al loro inizio dallo [[Persone|staff di debianizzati]]. Nell'indice le guide '''Debianized''' sono facilmente individuabili da uno swirl: [[Image:swirl.png|link=]]. Tutte le guide sul wiki possono diventare Debianized una volta ricevuto un sufficiente feedback dalla comunità.
 
Se leggi una guida e verifichi la sua correttezza, utilizza per favore il template [[Template:Autori | Autori]] in modo da tenere traccia della maturità della guida.
 
Con questi piccoli accorgimenti che richiedono un piccolo aiuto da parte della community, speriamo di poter '''tracciare''' e '''mantenere''' lo "stato di salute" delle guide, sperando che un numero sempre maggiore di esse diventi [[Debianized]] ;-).
 
== Pagine protette ==
[[Speciale:PagineProtette|Alcune pagine]] del wiki sono protette, cioè un normale utente non può modificarle anche se registrato. Le pagine protette sono pagine di presentazione del progetto, pagine di licenza o pagine tecniche del Wiki. In nessun caso un articolo di documentazione riguardate Debian GNU/Linux verrà resa protetta. Se trovate una pagina di documentazione protetta, per favore, segnalatelo agli amministratori.

Versione attuale delle 20:11, 7 apr 2021


Linee guida su come contribuire al Wiki

Sommario

Questo sito è un Wiki e il motore usato si chiama MediaWiki, lo stesso usato da Wikipedia.
Dopo la registrazione tutti possono creare nuove pagine o modificare quelle esistenti nel rispetto del contratto sociale e delle regole di rispetto reciproco che contraddistinguono questa comunità. Si legga anche la pagina che spiega come contribuire a questo Wiki.

Qui di seguito sono raccolte le pagine che riteniamo possano aiutare a scrivere su questo Wiki; se si hanno dubbi o domande, i membri di questa comunità saranno ben felici di rispondere e intervenire in qualsiasi discussione aperta nella sezione "Guide@Debianizzati.com" del forum.

Prima di iniziare

pagina che cerca di riassumere tutto ciò che bisogna conoscere prima di iniziare a scrivere o modificare una guida, in modo che il Wiki abbia una struttura leggibile e omogenea.

Creare e modificare una pagina

come iniziare a creare le guide del Wiki o modificarne di esistenti.

Spostare e cancellare una pagina

viene spiegato come rinominare il titolo di una guida o cancellare una guida esistente.

Discussioni

cosa sono le discussioni delle pagine e come utilizzarle al meglio.

Cronologia

l'utilissimo strumento associato ad ogni pagina: la sua cronologia.

Sintassi

la sintassi con cui vengono scritte le guide. Qui sono illustrati i vari tag con cui inserire formattazione per il testo, titoli, immagini, link e tanto altro.

Categorie

come categorizzare le guide in modo da facilitarne la ricerca.

I template

in questa guida viene introdotto l'utilizzo e la creazione di un elemento fondamentale di questo Wiki.

Segnalazione dei problemi

la pagina da leggere se si incontrano problemi per cui è necessario scrivere una segnalazione.

Licenze

altra pagina fondamentale sulle licenze con cui rilasciare i contenuti del Wiki.

Varie

qui sono riassunti ulteriori informazioni non incluse nelle pagine precedenti:
  • Redirect
  • Estensioni
  • Namespace

Scheletro/modello di una nuova guida

presenta un modello utilizzabile come punto di partenza per facilitare la stesura di una nuova guida.