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.

• Riquadro di testo: racchiudi il testo tra tre parentesi graffe di apertura e tre di chiusura:

  {{{
  ''Testo'' di '''esempio'''
  }}}

  al loro interno la sintassi del wiki non viene riconoscita:

  ''Testo'' di '''esempio'''

Frasi di uso comune

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

• Digitare nel terminale il seguente comando:

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

• 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 Firefox

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

• Aprire con i privilegi di amministrazione e con un editor di testo il file /etc/fstab

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

• Creare con i privilegi di amministrazione la cartella /usr/local/share/locale/it/LC_MESSAGES.

   [[AmministrazioneSistema/ComandiBase#mkdir|Creare]] con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|privilegi di amministrazione]] la cartella `/usr/local/share/locale/it/LC_MESSAGES`.

• Assegnare i permessi di esecuzione con i privilegi di amministrazione al file install.sh.

  [[AmministrazioneSistema/PermessiFile#Assegnare_i_permessi_di_esecuzione|Assegnare i permessi di esecuzione]] con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|privilegi di amministrazione]] al file `install.sh`.

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

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

• 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

• Aggiornare la lista dei pacchetti

  [[AmministrazioneSistema/InstallareProgrammi/Apt#Aggiornamento_del_sistema|Aggiornare]] la lista dei pacchetti.

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