Dimensione: 4452
Commento:
|
← Versione 51 del 14/06/2024 10.15.33 ⇥
Dimensione: 9482
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 4: | Linea 4: |
## PAGINA ADATTATA PER VISIONE DA SMARTPHONE, NON AGGIUNGERE STRINGHE TROPPO LUNGHE ALTRIMENTI SALTA L'IMPOSTAZIONE DELLA PAGINA <<Include(GruppoDocumentazione/Header)>> <<Include(GruppoDocumentazione/Header3)>> <<BR>> <<Indice(depth=1)>> <<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?f=46&t=633028")>> |
|
Linea 6: | Linea 16: |
All'interno del wiki sono state introdotte alcune regole per uniformare lo stile delle pagine che compongono la documentazione. Nella seguente pagina è presente un breve elenco delle regole più frequenti. | 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. |
Linea 8: | Linea 18: |
Se si ha la necessità di trovare informazioni più dettagliate sul frasario o sui formati del testo, può essere consultata la pagina [[GuidaWiki/RegoleStilistiche|RegoleStilistiche]], un grande archivio di informazioni raccolte e aggiornate negli anni dagli editori del wiki. | = Prima di iniziare! = |
Linea 10: | Linea 20: |
= In generale = | 0. '''Scrivi in lingua italiana''': utilizza al meglio le regole della lingua italiana, evitando quando possibile termini inglesi. |
Linea 12: | Linea 22: |
Alcune indicazioni sul come scrivere una pagina: | 0. '''Scrivi in modo impersonale''': evita espressioni come "''installa'' il programma", "''copiate'' il testo"; utilizza invece espressioni come "''installare'' il programma", "''copiare'' il testo". |
Linea 14: | Linea 24: |
0. '''Scrivere in italiano''': utilizzare al meglio delle proprie possibilità le regole della lingua italiana. 0. '''Scrivere in modo impersonale''': evitare espressioni come "installa il programma", "copia il testo", "scarica il file". Bensì utilizzare espressioni come "installare il programma", "copiare il testo", "scaricare il file". 0. '''Scrivere in modo conciso''': trattandosi di documentazione tecnica, per fare in modo che i passaggi da eseguire risultino quanto più chiari, è preferibile evitare periodi eccessivamente lunghi. Spesso può essere utile l'utilizzo di elenchi [[Wiki10Passi#Elenchi_puntati|puntati/numerati]] per schematizzare i passaggi. 0. '''Sfruttare le guide esistenti''': piuttosto che duplicare sulla propria guida una procedura presente in un'altra pagina, è preferibile inserire un link alla guida esistente. |
0. '''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. 0. '''Sfrutta le guide esistenti''': piuttosto che duplicare sulla tua guida una procedura presente in un'altra pagina, è preferibile inserire un link alla guida esistente. 0. '''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ù ;) 0. '''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. ||<:15%>'''Oggetto''' ||<:>'''Come si scrive''' ||<:46%>'''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__}}} || || [[http://www.ubuntu.it/|Collegamento esterno]] || racchiudi collegamento e testo tra parentesi quadre doppie, separati dal carattere pipe "|" || {{{[[http://www.ubuntu.it/|Coll.esterno]]}}} || || [[Server|Collegamento interno]]<<BR>> [[#Formato_dei_nomi|Collegamento capitolo]] || racchiudi !NomeDellaPagina e testo tra parentesi quadre doppie, separati dal carattere pipe "|";<<BR>>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}}}<<BR>>{{{ * II elemento}}}<<BR>>{{{ * I elem. indentato}}}<<BR>>{{{ * II elem. indentato}}}<<BR>>{{{ * III elemento}}} || || Elenco numerato || usa il carattere zero seguito da un punto, preceduti da uno o più spazi || {{{ 0. I elemento}}}<<BR>> {{{ 0. II elemento}}}<<BR>> {{{ 0. I elem. indentato}}}<<BR>> {{{ 0. II elem. indentato}}}<<BR>> {{{ 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 <<BR>>a capo || usa il tag break {{{<<BR>>}}} || {{{Ritorno <<BR>>a capo}}} || * '''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''' }}} {{{#!wiki tip Per maggiori informazioni su questo paragrafo consulta la pagina [[GuidaWiki/Editor|GuidaWiki/Editor]]. }}} |
Linea 21: | Linea 67: |
Segue un elenco di esempi riguardanti le frasi più frequentemente utilizzate. | Una serie di frasi usate di frequente nelle guide wiki. Usale senza timore adeguandole ai contenuti della tua guida. |
Linea 23: | Linea 69: |
== Installare un programma == Esempio: [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://amule-adunanza | amule-adunanza]]. {{{ [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://amule-adunanza | amule-adunanza]]. |
* Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando: {{{ Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando: |
Linea 33: | Linea 74: |
Utilizzando questa forma si mettono a disposizione le comode funzionalità di [[AmministrazioneSistema/InstallareProgrammi/AptUrl|AptURL]] e si offre un link alle diverse [[AmministrazioneSistema/InstallareProgrammi|modalità]] di installazione dei programmi senza doverle rispiegare. == Avviare un programma == Esempio: Avviare il programma dal menù '''''Applicazioni → Internet → Broser web Chromium'''''. {{{ Avviare il programma dal menù '''''Applicazioni → Internet → Broser web Chromium'''''. |
* [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://gimp|gimp]] {{{ [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://gimp|gimp]] |
Linea 44: | Linea 79: |
oppure: Il programma sarà disponibile nel menù '''''Applicazioni → Internet → Broser web Chromium'''''. Ovviamente le frasi possono essere riadattate a seconda del contesto. == Comandi da terminale == Esempio: Digitare i seguenti comandi in una finestra di [[AmministrazioneSistema/RigaDiComando|terminale]]: {{{ Digitare i seguenti comandi in una finestra di [[AmministrazioneSistema/RigaDiComando|terminale]]: |
* Selezionare il menù '''''Strumenti → Macro → Esegui''''' {{{ Selezionare il menù '''''Strumenti → Macro → Esegui''''' |
Linea 59: | Linea 84: |
== Editor di testo == Esempio: Aprire con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]] e con un [[Ufficio/EditorDiTesto|editor di testo]] il file `/etc/security/limits.conf` {{{ Aprire con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]] e con un [[Ufficio/EditorDiTesto|editor di testo]] il file `/etc/security/limits.conf` |
* [[AmbienteGrafico/AvviareProgrammi|Avviare]] il browser '''Firefox''' {{{ [[AmbienteGrafico/AvviareProgrammi|Avviare]] il browser '''Firefox''' |
Linea 68: | Linea 89: |
* Aprire con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|privilegi di amministrazione]] e con un [[Ufficio/EditorDiTesto|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` }}} * [[AmministrazioneSistema/ComandiBase#mkdir|Creare]] con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|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`. }}} * [[AmministrazioneSistema/PermessiFile#permessi|Assegnare i permessi di esecuzione]] con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|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`. }}} * [[AmministrazioneSistema/FormatiDiCompressione#decomprimere|Estrarre]] il contenuto dell'archivio `.tar.gz` nella propria '''Home''' {{{ [[AmministrazioneSistema/FormatiDiCompressione#decomprimere|Estrarre]] il contenuto dell'archivio `.tar.gz` nella propria '''Home''' }}} * [[AmministrazioneSistema/ComandiBase#cp|Copiare]] il file `/etc/security/limits.conf` nella propria '''Home''' {{{ [[AmministrazioneSistema/ComandiBase#cp|Copiare]] il file `/etc/security/limits.conf` nella propria '''Home''' }}} * [[AmministrazioneSistema/ComandiBase#cd|Spostarsi]] nella cartella dove è stato copiato il file {{{ [[AmministrazioneSistema/ComandiBase#cd|Spostarsi]] nella cartella dove è stato copiato il file }}} * [[AmministrazioneSistema/InstallareProgrammi/Apt#Aggiornamento_del_sistema|Aggiornare]] la lista dei pacchetti {{{ [[AmministrazioneSistema/InstallareProgrammi/Apt#Aggiornamento_del_sistema|Aggiornare]] la lista dei pacchetti. }}} <<Anchor(nome)>> |
|
Linea 70: | Linea 127: |
Segue un elenco dei formati utilizzati per indicare nomi di programmi, file, pacchetti, ecc.. | Tabella esplicativa dei "formati" con cui scrivere i nomi nella documentazione. |
Linea 72: | Linea 129: |
== Nomi dei programmi == | ||<tablestyle="width:100%;" :15%>'''Nomi di..''' ||<:>'''Come si scrive''' ||<:46%>'''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__}}} || |
Linea 74: | Linea 138: |
'''Grassetto''', esempio: | <<Anchor(note)>> = Note, avvisi e suggerimenti = |
Linea 76: | Linea 141: |
In questa guida viene spiegato come modificare '''Firefox'''. {{{ In questa guida viene spiegato come modificare '''Firefox'''. |
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. |
Linea 81: | Linea 147: |
== Nomi dei pacchetti == | {{{{ {{{#!wiki note Questa è una nota. }}} }}}} |
Linea 83: | Linea 153: |
''Corsivo'', esempio: il pacchetto ''bcmwl-kernel-source'' può essere reperito nella cartella... {{{ il pacchetto ''bcmwl-kernel-source'' può essere reperito nella cartella... |
<<BR>> {{{#!wiki important Questo è un avviso/avvertimento. |
Linea 90: | Linea 158: |
{{{{ {{{#!wiki important Questo è un avviso/avvertimento. }}} }}}} |
|
Linea 91: | Linea 164: |
== Nomi di file/cartelle == `Larghezza fissa`, esempio: spostarsi nella cartella `/usr/share/doc` {{{ spostarsi nella cartella `/usr/share/doc` |
<<BR>> {{{#!wiki tip Questo è un suggerimento. |
Linea 100: | Linea 169: |
{{{{ {{{#!wiki tip Questo è un suggerimento. }}} }}}} |
|
Linea 101: | Linea 175: |
== Voce di menù == '''Grassetto''', esempio: Selezionare il menù '''Modifica'''. {{{ Selezionare il menù '''Modifica'''. }}} == Percorso dei menù == '''''Corsivo + grassetto''''', esempio: Selezionare il menù '''''Visualizza → Disponi oggetti → Per nome '''''. {{{ Selezionare il menù '''''Visualizza → Disponi oggetti → Per nome '''''. }}} == Nomi delle estensioni == `Larghezza fissa`, esempio: Salvare il pacchetto `.deb` {{{ Salvare il pacchetto `.deb` }}} |
<<BR>> '''Buon divertimento e buon lavoro!''' |
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!
Scrivi in lingua italiana: utilizza al meglio le regole della lingua italiana, evitando quando possibile termini inglesi.
Scrivi in modo impersonale: evita espressioni come "installa il programma", "copiate il testo"; utilizza invece espressioni come "installare il programma", "copiare il testo".
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.
Sfrutta le guide esistenti: piuttosto che duplicare sulla tua guida una procedura presente in un'altra pagina, è preferibile inserire un link alla guida esistente.
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ù
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__ |
racchiudi collegamento e testo tra parentesi quadre doppie, separati dal carattere pipe "|" |
[[http://www.ubuntu.it/|Coll.esterno]] |
|
racchiudi NomeDellaPagina e testo tra parentesi quadre doppie, separati dal carattere pipe "|"; |
[[Server|Coll.interno]] |
|
Elenco puntato |
usa il carattere asterisco "*" preceduto da uno o più spazi |
* I elemento |
Elenco numerato |
usa il carattere zero seguito da un punto, preceduti da uno o più spazi |
0. I 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 |
usa il tag break <<BR>> |
Ritorno <<BR>>a capo |
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'''
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.
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.
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.
{{{#!wiki note Questa è una nota. }}}
Questo è un avviso/avvertimento.
{{{#!wiki important Questo è un avviso/avvertimento. }}}
Questo è un suggerimento.
{{{#!wiki tip Questo è un suggerimento. }}}
Buon divertimento e buon lavoro!