Indice Guide: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
m (Link guida XGL e Beryl su KDE con schede ATI)
Riga 1: Riga 1:
==Intro==


Questo sito un [http://it.wikipedia.org/wiki/Wiki wiki], ci vuol dire che  puoi editare ogni pagina semplicemente iscrivendoti e cliccando sul tasto modifica presente (in alto) su ongi pagina. Il motore usato per questo wiki si chiama [http://wikipedia.sourceforge.net/ MediaWiki], ed lo stesso usato da [http://it.wikipedia.org/wiki/Pagina_principale Wikipedia]
Quelle di seguito sono delle semplici linee guida che abbiamo scritto per sfruttare al meglio le potenzialit di MediaWiki e per rendere pi facilmente gestibile il wiki in maniera collettiva.
==Modificare una pagina==
Cliccando sul tasto modifica di una pagina (provate su questa pagina di prova: [[XGL+Beryl su KDE con schede ATI]]) vederete un box con del testo. Modificando quel testo modificherete la pagina, cliccando sul tasto salva.
===Sintassi===
La sintassi usata molto semplice e per certi versi simile al testo semplice non formattato. Puoi trovare uno specchietto con i principali elementi di formattazione qui:
* [[Help:Editing]]
===Altre Regole===
Alcune regole che rendono pi facile la gestione del wiki:
* Quando modificate una pagina scrivete sempre un sommario prima di salvare. Basta inserire una piccola descrizione delle modifiche nella casella "Oggetto" (in basso sotto il riquadro che contiene l'articolo). L'oggetto della modifica apparir nella history e render pi facile seguire come stata modificata la pagina nel corso del tempo. Per banali correzioni ortografiche o di battitura spuntare la casella ''Questa una modifica minore''. Nella history della pagina le modifiche minori possono essere nascoste.
* Usate sempre il tasto '''Anteprima''' prima di salvare le modifiche in modo da vedere il risultato ed effettuare eventuali correzioni subito. In tal modo si evita anche di allungare inutilmente la history della pagina.
* Le pagine in genere non dovrebbero mai essere rinominate. Se avete dato un titolo errato, potete rinominare la pagina ma ricordatevi di aggiornare anche tutti i link alla pagina stessa (guardate l'apposito link nella toolbox a sinistra). Quando una pagina viene rinominata la vecchia pagina conterr un redirect alla nuova pagina. Tuttavia la nuova pagina non conterr la storia delle modifiche precedenti allo spostamento e questo rende molto pi difficile controllare le modifiche.
* Scegliete accuratamente il titolo, in modo che si capisca subito di cosa tratta la guida, ma evitate titoli troppo lunghi.
==Creare una pagina==
Il modo pi comodo per creare una pagina quella di creare un link (che sarebbe il titolo racchiuso tra <nowiki>[[ ]]</nowiki>) alla pagina che si vuole creare. Potete usare a questo scopo la vostra pagina personale. Ad esempio se scriviamo:
<pre>
[[Condivisioni di stampanti in reti miste Linux - Windows]]
</pre>
comparir un link ad una pagina inesistente:
[[Condivisioni di stampanti in reti miste Linux - Windows]]
(i link a pagine inesistenti hanno colore rosso), cliccando su questo link non compari una pagina vuota bens un pagina in cui potrete inserire il testo dell'articolo.
Per approfondimenti su come creare link:
* [[Help:Editing#Creazione_Link]]
==Convenzioni==
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.
* Tutte le volte che riportate un comando, un pezzo di un file di configurazione, od in genere dei dati ascii racchiudeteli in un riquadro (racchiudendo tra <nowiki><pre></nowiki> e <nowiki></pre></nowiki>).
* Se riportate un comando usate come primo carattere $ se il comando deve essere lanciato da utente normale e # se il comando deve essere lanciato da root. Lasciate anche uno spazio dopo questo carattere, in modo che il comando non risulti attaccato al $ o # e quindi poco leggibile.
* 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 una tavola dei contenuti iniziale che render molto pi facile la navigazione nella vostra guida.
* Usate, quando necessario, i vari [[Help:Editing|elementi di formattazione]] (descrizioni, riquadro di warning, esempio ecc...): la guida risulter pi leggibile.
* Cercate di rendere leggibile e pulito il codice della pagina, evitando ad esempio di lasciare tante righe vuote consecutive.
* Cercate il pi possibile di fare link ad altre pagine del wiki, in modo da aumentare le interconnessioni e rendere pi facile la ricerca delle informazioni.
==Firmare una guida==
L'autore di una guida pu, se vuole, firmarla, preferibilmente alla fine. Per inserire la firma basta scrivere:
<pre>
: ~~~
</pre>
ottenendo questo (c' il mio nome perch l'ho scritto io):
: [[User:TheNoise|TheNoise]]
se si vuole inserire anche il nome reale e la data basta usare quattro tilde (~) al posto di tre. Cliccando sul nome si accede alla pagina personale di ogni iscritto nella quale potrete scrivere, se volete, informazioni su di voi.
Per separare la firma dal corpo della guida consigliabile inserire una linea con quattro trattini (segno meno):
<pre>
----
</pre>
che nell'output diventano una linea continua come questa:
----
==Evoluzione delle guide==
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:
* '''Stub''': una guida in questo stato se ancora incompleta. Queste guide sono caratterizzate dal seguente box iniziale:
<CENTER>
{| width=50% bgcolor=white align=center style=border-style:dotted;border-width:1mm;border-color:lightblue
|''Attenzione questo articolo ancora incompleto. <br>Sentiti libero di contribuire cliccando sul tasto edit.''
|}
</CENTER>
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 cominit.
* '''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: http://guide.debianizzati.org/images/swirl.png. 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, perfavore, inserisci alla fine della guida, dopo il nome dell'autore una nota come questa:
{{Box|Esempio firme in calce ad un articolo|:Autore: [[Utente:TheNoise|The_Noise]]
:Verificato: [[Utente: keltik|Keltik]]
}}
In tal modo si pu tenere tracci della maturit della guida. Analogamente per correzioni od estensioni di un certo rilievo (non certo per una correzione ortografica) consigliabile inserire una nota come nell'esempio:
{{Box|Esempio firme in calce ad un articolo|:Autore: [[Utente:TheNoise|The_Noise]]
:Verificato da [[Utente: keltik|Keltik]]
:Esteso da [[Utente:hanska|Hanska]]
:Verificato da [[Utente:MaXeR|MaXeR]]
}}
Con questi piccoli accorgimenti che richiedono un piccolo aiuto da parte della community, speriamo di poter '''tracciare''' e '''mantere''' lo "stato di salute" delle guide, sperando che un numero sempre maggiore di esse diventi [[Template:Debianized|Debianized]] ;-).
==Ripristinare versioni precedenti di una pagina==
Il wiki tiene traccia completa della storia di tutte le modifiche effettuate su ogni pagina. &Egrave; possibile accedere allo storico delle modifiche cliccando sul link '''revisioni''' in alto. Dalle revisioni di una pagina possibile ripristinare una qualsiasi versione precedente se il suo contenuto stato danneggiato o cancellato. Ecco perch importante loggarsi sempre e scrivere un chiaro sommario per ogni modifica.
==Monitorare una pagina==
Se hai scritto una guida probabilmente vorrai controllare anche le modifiche successive che vengono fatte da altri. Questo molto facile, basta premere su link '''watch''' in alto in ogni pagina e quella pagina verr aggiunta alla tua lista di ''Osservati Speciali'' (anche questo link in alto).
==Discussioni==
Ad ogni pagina del wiki associata una pagina di discussione nella quale si pu parlare di come estendere o modificare un particolare articolo. Per accedere alla pagina delle discussioni basta cliccare su link '''discussion''', in alto. Nella pagina di discussione devono essere discussi e risolti eventuali disaccordi su come modificare una pagina.
La pagina di discussione anche un utile strumento per chiedere chiarimenti o estensioni su un articolo, ed in genere per parlare di tutto ci che riguarda una particolare pagina.
==Pagine protette==
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 (come ad es. i [[Usare i Template|template]]). 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.
==Licenze==
Ogni articolo pubblicato da considerarsi rilasciato secondo una [[Some Right Reserved|licenza Creative Commons]]. Ti preghiamo di non inserire nel wiki contenuti coperti da diritti d'autore. Qualora si scoprano violazioni di copyright gli articoli interessati verranno rimossi.
Alcuni articoli saranno firmati da [[Utente:Guide @ Debianizzati.org]]. Questi l'articoli possono nascere da una discussione sul [http://www.debianizzati.org/modules/newbb/ forum], in [[chat]] o in genere dallo sforzo collaborativo di pi persone della community.

Versione delle 16:31, 17 nov 2006