Dimensione: 4452
Commento:
|
Dimensione: 9522
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 4: | Linea 4: |
<<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 14: |
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 16: |
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 18: |
= In generale = | 0. '''Scrivi in lingua italiana''': utilizza al meglio le regole della lingua italiana, evitando quando possibile termini inglesi. |
Linea 12: | Linea 20: |
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 22: |
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'', come creare collegamenti e via dicendo. ||<rowstyle="background-color:#cccccc;" :15%>'''Oggetto''' ||<:>'''Come si scrive''' ||<:46%>'''Esempio''' || ||<#f7f7f7> '''Grassetto''' || apice singolo tre volte, prima e dopo il testo || {{{'''Grassetto'''}}} || ||<#f7f7f7> ''Corsivo'' || apice singolo due volte, prima e dopo il testo || {{{''Corsivo''}}} || ||<#f7f7f7> '''''Grassetto+Corsivo''''' || apice singolo cinque volte, prima e dopo il testo || {{{'''''Grassetto+Corsivo'''''}}} || ||<#f7f7f7> '''''G'''rassetto Cor``'''siv'''o '''Misto'''''|| apice singolo cinque volte prima e dopo il testo, lettera grassetto tra apice singolo tre volte nel testo || {{{'''''G'''rassetto Cor``'''siv'''o '''Misto'''''}}} || ||<#f7f7f7> `Larghezza fissa` || accento grave ('''Alt Gr + ' '''), prima e dopo il testo || {{{`Larghezza fissa`}}} || ||<-3 style="border:none;">|| ||<#f7f7f7> [[https://www.ubuntu-it.org/|Collegamento a sito in rete]] || racchiudi collegamento e testo tra parentesi quadre doppie, separati dal carattere pipe "|" || {{{[[https://www.ubuntu-it.org/|Collegamento a sito in rete]]}}} || ||<#f7f7f7> [[Hardware|Collegamento ad un'altra pagina]] || racchiudi !NomeDellaPagina e testo tra parentesi quadre doppie, separati dal carattere pipe "|" || {{{[[Hardware|Collegamento ad un'altra pagina]]}}} || ||<#f7f7f7> [[#nome|Collegamento dentro la pagina]] || racchiudi #nomeAnchor e testo tra parentesi quadre doppie, separati dal carattere pipe "|", e ponendo Anchor al punto desiderato|| {{{[[#nome|Collegamento dentro la pagina]]}}} {{{<<Anchor(nome)>>}}}|| ||<-3 style="border:none;">|| ||<#f7f7f7> Elenco puntato || usa il carattere asterisco "*" preceduto da uno o più spazi || {{{ * I elemento}}}<<BR>>{{{ * II elemento}}}<<BR>>{{{ * I elemento indentato}}}<<BR>>{{{ * II elemento indentato}}}<<BR>>{{{ * III elemento}}} || ||<#f7f7f7> 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 elemento indentato}}}<<BR>> {{{ 0. II elemento indentato}}}<<BR>> {{{ 0. III elemento}}} || ||<-3 style="border:none;">|| ||<#f7f7f7> Titolo di capitolo || racchiudi il testo tra due caratteri uguale "=" (non lasciare spazi all'inizio della riga) || {{{= Titolo di capitolo =}}} || ||<#f7f7f7> Titolo di paragrafo || racchiudi il testo tra due coppie di caratteri uguale "=" (non lasciare spazi all'inizio della riga) || {{{== Titolo di paragrafo ==}}} || ||<-3 style="border:none;">|| ||<#f7f7f7> Ritorno <<BR>>a capo || usa il tag break {{{<<BR>>}}} || {{{Ritorno <<BR>>a capo}}} || * '''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''' }}} ||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">Per maggiori informazioni su questo paragrafo consulta la pagina [[GuidaWiki/Editor|GuidaWiki/Editor]].|| |
Linea 21: | Linea 69: |
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 71: |
== Installare un programma == Esempio: [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://amule-adunanza | amule-adunanza]]. {{{ [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://amule-adunanza | amule-adunanza]]. |
* [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://gimp|gimp]] {{{ [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://gimp|gimp]] |
Linea 33: | Linea 76: |
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'''''. |
* Selezionare il menù '''''Strumenti → Macro → Esegui''''' {{{ Selezionare il menù '''''Strumenti → Macro → Esegui''''' |
Linea 44: | Linea 81: |
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]]: |
* [[AmbienteGrafico/AvviareProgrammi|Avviare]] il browser '''Chromium''' {{{ [[AmbienteGrafico/AvviareProgrammi|Avviare]] il browser '''Chromium''' |
Linea 59: | Linea 86: |
== 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` |
* Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando: {{{ Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando: |
Linea 68: | Linea 91: |
* Aprire con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|privilegi di amministrazione]] e con un [[Ufficio/EditorDiTesto|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` }}} * [[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''' }}} * Aprire un [[AmbienteGrafico/FileManager|file manager]] con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]] {{{ Aprire un [[AmbienteGrafico/FileManager|file manager]] con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]] }}} * [[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 }}} <<Anchor(nome)>> |
|
Linea 70: | Linea 119: |
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 121: |
== Nomi dei programmi == | ||<tablestyle="width:100%;" rowstyle="background-color:#cccccc;" :15%>'''Nomi di..''' ||<:>'''Come si scrive''' ||<:46%>'''Esempio''' || ||<#f7f7f7> '''Programmi''' || '''Firefox''' (grassetto) || {{{'''Firefox'''}}} || ||<#f7f7f7> '''Pacchetti''' || ''bcmwl-kernel-source'' (corsivo) || {{{''bcmwl-kernel-source''}}} || ||<#f7f7f7> '''File e cartelle''' || `/usr/share/doc` (larghezza fissa) || {{{`/usr/share/doc`}}} || ||<#f7f7f7> '''Voce di menù''' || '''Modifica''' (grassetto) || {{{'''Modifica'''}}} || ||<#f7f7f7> '''Percorso dei menù''' || '''''Mostra → Nome ''''' (grassetto + corsivo) || {{{'''''Mostra → Nome '''''}}} || ||<#f7f7f7> '''Estensioni''' || `.deb` (larghezza fissa) || {{{`.deb`}}} || ||<#f7f7f7> '''Iniziali acronimi''' ||'''sudo''' ('''''s'''uper``'''u'''ser '''do''''') (grassetto corsivo misto) || {{{'''sudo''' ('''''s'''uper``'''u'''ser '''do''''') }}} || |
Linea 74: | Linea 130: |
'''Grassetto''', esempio: | <<Anchor(note)>> = Note, avvisi e suggerimenti = |
Linea 76: | Linea 133: |
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 139: |
== Nomi dei pacchetti == | {{{{ {{{#!wiki note Questa è una nota. }}} }}}} |
Linea 83: | Linea 145: |
''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 150: |
{{{{ {{{#!wiki important Questo è un avviso/avvertimento. }}} }}}} |
|
Linea 91: | Linea 156: |
== 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 161: |
{{{{ {{{#!wiki tip Questo è un suggerimento. }}} }}}} |
|
Linea 101: | Linea 167: |
== 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, 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 |
'''''Grassetto+Corsivo''''' |
Grassetto Corsivo Misto |
apice singolo cinque volte prima e dopo il testo, lettera grassetto tra apice singolo tre volte nel testo |
'''''G'''rassetto Cor``'''siv'''o '''Misto''''' |
Larghezza fissa |
accento grave (Alt Gr + ' ), prima e dopo il testo |
`Larghezza fissa` |
racchiudi collegamento e testo tra parentesi quadre doppie, separati dal carattere pipe "|" |
[[https://www.ubuntu-it.org/|Collegamento a sito in rete]] |
|
racchiudi NomeDellaPagina e testo tra parentesi quadre doppie, separati dal carattere pipe "|" |
[[Hardware|Collegamento ad un'altra pagina]] |
|
racchiudi #nomeAnchor e testo tra parentesi quadre doppie, separati dal carattere pipe "|", e ponendo Anchor al punto desiderato |
[[#nome|Collegamento dentro la pagina]] <<Anchor(nome)>> |
|
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 di capitolo = |
Titolo di paragrafo |
racchiudi il testo tra due coppie di caratteri uguale "=" (non lasciare spazi all'inizio della riga) |
== Titolo di paragrafo == |
Ritorno |
usa il tag break <<BR>> |
Ritorno <<BR>>a capo |
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'''
|
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.
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.
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` |
Iniziali acronimi |
sudo (superuser do) (grassetto corsivo misto) |
'''sudo''' ('''''s'''uper``'''u'''ser '''do''''') |
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!