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, come creare collegamenti e via dicendo.

• Riquadro di testo: si ottiene con l'utilizzo di tre parentesi graffe di apertura e di chiusura disposte in questo modo intorno al testo desiderato:

  {{{
  Testo di esempio
  }}}

  Al suo interno la sintassi del wiki non viene riconosciuta. Inserendo alcuni degli esempi precedenti, verranno mostrati senza formattazione:

  ''Corsivo''
  '''Grassetto'''

Frasi di uso comune

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

• Installare il pacchetto gimp

  [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://gimp|gimp]]

• Selezionare il menù Strumenti → Macro → Esegui

  Selezionare il menù '''''Strumenti → Macro → Esegui'''''

• Avviare il browser Chromium

  [[AmbienteGrafico/AvviareProgrammi|Avviare]] il browser '''Chromium'''

• Digitare nel terminale il seguente comando:

  Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:

• Aprire con i privilegi di amministrazione e con un editor di testo il file /etc/security/limits.conf

   Aprire con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|privilegi di amministrazione]] e con un [[Ufficio/EditorDiTesto|editor di testo]] il file `/etc/security/limits.conf`

• Estrarre il contenuto dell'archivio .tar.gz nella propria Home

  [[AmministrazioneSistema/FormatiDiCompressione#decomprimere|Estrarre]] il contenuto dell'archivio `.tar.gz` nella propria '''Home'''

• Aprire un file manager con i privilegi di amministrazione

  Aprire un [[AmbienteGrafico/FileManager|file manager]] con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]]

• Copiare il file /etc/security/limits.conf nella propria Home

  [[AmministrazioneSistema/ComandiBase#cp|Copiare]] il file `/etc/security/limits.conf` nella propria '''Home'''

• Spostarsi nella cartella dove è stato copiato il file

  [[AmministrazioneSistema/ComandiBase#cd|Spostarsi]] nella cartella dove è stato copiato il file

Formato dei nomi

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

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.

• {{{#!wiki note
  Questa è una nota.
  }}}

• {{{#!wiki important
  Questo è un  avviso/avvertimento.
  }}}

• {{{#!wiki tip
  Questo è un suggerimento.
  }}}

Buon divertimento e buon lavoro!

CategoryComunita