Problemi in questa pagina? Segnalali in questa discussione

Introduzione

Questa guida rapida ti insegnerà ad usare il wiki di Ubuntu-it. Ti consigliamo di aggiungerla ai preferiti del tuo browser, per averla sempre a portata di mano.

Prima di iniziare!

  1. Scrivi in lingua italiana: utilizza al meglio le regole della lingua italiana, evitando quando possibile termini inglesi.

  2. Scrivi in modo impersonale: evita espressioni come "installa il programma", "copiate il testo"; utilizza invece espressioni come "installare il programma", "copiare il testo".

  3. Less is more: per fare in modo che i passaggi da eseguire risultino chiari, evita periodi eccessivamente lunghi, utilizzando quando possibile elenchi puntati o numerati. Cerca di limitare il più possibile l'utilizzo di immagini, che col tempo andranno aggiornate.

  4. Sfrutta le guide esistenti: piuttosto che duplicare sulla tua guida una procedura presente in un'altra pagina, è preferibile inserire un link alla guida esistente.

  5. Copiare è una virtù: le comunità di Software Libero condividono i codici sorgenti di tutto ciò che producono: programmi, disegni, testi, presentazioni. Lo stesso vale per il wiki! Se navigando nel wiki vedi uno stile grafico che ti piace guarda il codice e copialo! Nel menu a tendina Altre azioni che trovi in alto seleziona Mostra il testo grezzo, verrà visualizzato il sorgente della pagina da copiare a volontà! Non siamo a scuola, qua copiare è una virtù ;)

  6. Niente superfluo: la nostra documentazione wiki è scritta per spiegare gli aspetti più complessi legati ad Ubuntu, per guidare chi la legge nell'esecuzione di procedure più o meno complicate e per aiutare nella risoluzione dei problemi. Non serve scrivere guide sull'utilizzo di programmi che già dispongono di documentazione o scrivere guide su procedure banali che non necessitano di spiegazioni ;)

Formattazione del testo

Come scrivere in grassetto, in corsivo, sottolineato, come creare collegamenti e via dicendo.

Oggetto

Come si scrive

Esempio

Grassetto

apice singolo tre volte, prima e dopo il testo

'''Grassetto'''

Corsivo

apice singolo due volte, prima e dopo il testo

''Corsivo''

Grassetto+Corsivo

apice singolo cinque volte, prima e dopo il testo

'''''Gras+Corsivo'''''

Larghezza fissa

accento grave (Alt Gr + ' ), prima e dopo il testo

`Larghezza fissa`

Sottolineato

due lineette (Maius.+-) , prima e dopo il testo

__Sottolineatura__

Collegamento esterno

racchiudi collegamento e testo tra parentesi quadre doppie, separati dal carattere pipe "|"

[[http://www.ubuntu.it/|Coll.esterno]]

Collegamento interno
Collegamento capitolo

racchiudi NomeDellaPagina e testo tra parentesi quadre doppie, separati dal carattere pipe "|";
per inserire collegamenti a capitoli/paragrafi sostituisci NomeDellaPagina con #NomeDelCapitolo

[[Server|Coll.interno]]

Elenco puntato

usa il carattere asterisco "*" preceduto da uno o più spazi

 * I elemento
 * II elemento
  * I elem. indentato
  * II elem. indentato
 * III elemento

Elenco numerato

usa il carattere zero seguito da un punto, preceduti da uno o più spazi

 0. I elemento
 0. II elemento
  0. I elem. indentato
  0. II elem. indentato
 0. III elemento

Titolo di capitolo

racchiudi il testo tra due caratteri uguale "=" (non lasciare spazi all'inizio della riga)

= Titolo capitolo =

Titolo di paragrafo

racchiudi il testo tra due coppie di caratteri uguale "=" (non lasciare spazi all'inizio della riga)

== Titolo paragrafo ==

Ritorno
a capo

usa il tag break <<BR>>

Ritorno <<BR>>a capo

Per maggiori informazioni su questo paragrafo consulta la pagina GuidaWiki/Editor.

Frasi di uso comune

Una serie di frasi usate di frequente nelle guide wiki. Usale senza timore adeguandole ai contenuti della tua guida.

Formato dei nomi

Tabella esplicativa dei "formati" con cui scrivere i nomi nella documentazione.

Nomi di..

Come si scrive

Esempio

Programmi

Firefox (grassetto)

'''Firefox'''

Pacchetti

bcmwl-kernel-source (corsivo)

''bcmwl-kernel-source''

File e cartelle

/usr/share/doc (larghezza fissa)

`/usr/share/doc`

Voce di menù

Modifica (grassetto)

'''Modifica'''

Percorso dei menù

Mostra → Nome (grassetto + corsivo)

'''''Mostra → Nome'''''

Estensioni

.deb (larghezza fissa)

`.deb`

Testo inciso

è raccomandato (sottolineatura)

__è raccomandato__

Note, avvisi e suggerimenti

Per segnalare al lettore alcune particolarità che possono essere escluse dal testo principale della guida o per porre l'attenzione su un aspetto, è possibile utilizzare rispettivamente una nota, un avviso/avvertimento o un suggerimento.

Questa è una nota.


Questo è un avviso/avvertimento.


Questo è un suggerimento.


Buon divertimento e buon lavoro!


CategoryComunita

GuidaWiki/Standard (l'ultima modifica è del 14/06/2024 10.15.33, fatta da andreas-xavier)