Dimensione: 6107
Commento:
|
Dimensione: 2863
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 1: | Linea 1: |
[[TableOfContents]] | #format wiki #LANGUAGE it |
Linea 3: | Linea 4: |
= Da dove comincio ? = | <<Include(GruppoDocumentazione/Header2)>> |
Linea 5: | Linea 6: |
'''Iscrizione al Wiki''' Per scrivere sul Wiki devi essere iscritto ! quindi per prima cosa apri la [http://wiki.ubuntu-it.org/Home HomePage] del Wiki e clicca in alto a destra su "Login". Verrai inviato ad una pagina che contiene un form, inserisci il tuo nome, la password e l'indirizzo e-mail. E' preferibile scegliere un nome in questo formato "NomeCognome" (con due maiuscole), perchè il Wiki lo riconoscerà come un WikiName (più avanti ti spiegheremo cos'è). Quando hai inserito i dati clicca su "Crea profilo"...ti verrà inviata un'email all'indirizzo indicato con un link per l'attivazione del tuo profilo ed i dati. |
<<Include(GruppoDocumentazione/Header3)>> |
Linea 9: | Linea 8: |
'''Login''' Adesso sei dei nostri ! ritorna sulla Homepage e clicca su "Login" specificando Nome e Password, ora che sei iscritto puoi modificare le pagine. | <<BR>> <<Indice(depth=2 align=right)>> |
Linea 11: | Linea 11: |
'''User Preferences''' Quando fai il Login ed entri nel Wiki, in alto a destra appaiono questi tre link: {{{ Help UserPreferences NomeCognome }}} |
= Guida wiki = |
Linea 16: | Linea 13: |
il primo è un help in inglese sul funzionamento del Wiki, il secondo ti porta alla pagina delle impostazioni del tuo profilo (email, lingua, password, firme, etc...), infine il terzo ti porta alla tua pagina personale sul Wiki. Infatti, se hai attivato un profilo NomeCognome, avrai una pagina come questa: http://wiki.ubuntu-it.org/NomeCognome su cui potrai scrivere chi sei, quali sono i tuoi interessi o quali sono le pagine del Wiki di cui ti stai occupando |
In questa pagina sono raccolti link a pagine con informazioni utili per editare pagine wiki e per compiere operazioni di diverso genere. |
Linea 19: | Linea 15: |
= Modificare le pagine = | = Per chi inizia = |
Linea 21: | Linea 17: |
Come si fa a modificare una pagina ? è molto semplice, ogni pagina porta in alto a sinistra questi links: | Per l'editazione delle pagine è consigliabile aiutarsi con le seguenti guide: * [[Wiki10Passi|Guida al wiki in 10 passi più uno]]: concisa panoramica sulle funzioni base per l'editazione delle pagine. * [[/GlossarioRapido|Glossario rapido]]: breve presentazione delle impostazioni stilistiche delle guide. Quanto più un utente riesce a seguire queste linee guida, tanto meglio è. Sarà poi cura degli [[http://wiki.ubuntu-it.org/GruppoDocumentazione/Organizzazione#Editori|editori]] correggere le imperfezioni. |
Linea 23: | Linea 22: |
{{{ Edit - Show Changes - Get Info - Subscribe - More Acrtions }}} |
== A proposito di stile == |
Linea 27: | Linea 24: |
Cliccando su "Edit" aprite una nuova pagina che contiene una finestra grigia col testo che voi volete modificare...in pratica nella finestra potete scrivere come in un qualunque editor di testo. Al di sotto della finestra si trovano dei tasti: {{{ Save Changes - Preview - Check Spelling - Cancel }}} |
Come di sicuro avrai notato la maggior parte delle pagine hanno uno stile simile, per esempio: medesime frasi per indicare l'installazione di un pacchetto, medesima formattazione del testo per indicare le voci di menù, medesima struttura dei capitoli, uso di frasi impersonali e così via. Questo al fine di ottenere una documentazione '''concisa''', '''omogenea''' e '''ben ordinata'''. |
Linea 33: | Linea 26: |
Per salvare il testo che avete introdotto cliccare su "Save Changes", per avere un'anteprima senza salvare "Preview". | Nel corso degli anni sono state catalogate e aggiornate le espressioni di uso comune per descrivere i vari passaggi all'interno delle guide e le formattazioni del testo (grassetti, corsivi, elenchi, altro). Buona parte dei link in questa pagina possono essere di aiuto per chiunque desideri approfondire questi aspetti, in particolar modo la pagina [[GuidaWiki/RegoleStilistiche|RegoleStilistiche]] approfondisce tematiche di tipo generale sulla documentazione. |
Linea 35: | Linea 28: |
== Formattare il testo == | == Trucchi del mestiere == |
Linea 37: | Linea 30: |
Nella finestra o intorno ad essa non ci sono tasti di formattazione o menu come in un wordprocessor, ed allora come si fa a formattare il testo, per avere, per esempio, il grassetto, il corsivo etc... E' necessario racchiudere il testo in alcuni tag speciali, i più importanti sono questi: {{{ ''corsivo'' (due virgolette singole) '''grassetto''' (tre virgolette singole) '''''corsivo grassetto''''' (5 virgolette singole) }}} |
Ovviamente imparare tutto a memoria è impresa per pochi, ma soprattutto non è necessario! |
Linea 45: | Linea 32: |
quando dovete specificare un comando del terminale, è d'uso inserire il testo all'interno di una cornice colorata, che si ottiene digitando 3 parentesi graffe prima e 3 parentesi graffe dopo il testo. Le parentesi si ottengonno con questa sequenza di tasti: AltGr+7 => { AltGr+0 => } |
Prendendo a modello una pagina esistente avrai già visivamente uno spunto per creare la tua. In più una volta effettuato il login, in cima ad ogni pagina è disponibile il menù a tendina '''Altre azioni''' nel quale è possibile selezionare la voce '''Mostra il testo grezzo'''. In questo modo se su di una guida non ti è chiaro come sia stata ottenuta una qualsiasi formattazione, potrai controllare di persona e copiare i codici utilizzati. |
Linea 50: | Linea 35: |
== Titoli == | = In caso di dubbi = |
Linea 52: | Linea 37: |
I titoli dei paragrafi si ottengono inserendo il testo tra i segni uguale (=), a seconda del numero dei segni, il titolo sarà di primo, secondo o terzo livello: {{{ = Titolo 1 = == Titolo 2 == === Titolo 3 === ==== Titolo 4 ==== ===== Titolo 5 ===== }}} == Elenchi puntati e numerati == La creazione di elenchi puntati è numerati è molto semplice, digitate all'inizio della riga un asterisco (*) oppure un numero o una lettera maiuscola o minuscola seguita da un punto (1., a., A.), il Wiki creerà l'elenco. {{{ 1. 2. A. B. a. b. }}} == Tabella dei contenuti == Avrete notato che all'inizio di questa pagina c'è una tabella che riassume i titoli del documento, ottenerla è molto semplice, basta inserire questo tag compreso tra due parentesi quadre {{{ [[TableOfContents]] }}} == Testo a capo == Il testo a capo si ottiene inserendo questo tag: {{{ [[BR]] }}} = Creare una nuova pagina = Per creare una nuova pagina è necessario dapprima creare il link ad essa. Infatti, il Wiki è un sistema enciclopedico di documentazione in cui tutti gli articoli devono essere correlati tra loro, non possono esistere pagine "orfane".[[BR]] Se, per esempio, vogliamo creare un nuovo articolo sull'installazione di un componente hardware, dobbiamo prima creare il link in una pagina già esistente, per esempio in ToDo (pagina dei documenti in corso d'opera), oppure nella nostra pagina personale NomeCognome. '''Nomi di Pagina''' Il Wiki riconosce automaticamente come links a pagine i nomi che presentano due maiuscole non consecutive, come: NomeCognome, NuovoHardware, PaginaLinks, etc...[[BR]] '''Nomi di pagina deprecabili''' Anche se è deprecabile l'uso, talvolta ci si trova costretti a far riconoscere come link una pagina come questa "pagina", cioè un nome di pagina che non viene riconosciuto come WikiName dal Wiki. Lo si può fare inserendo il nome tra due parentesi quadre e due doppie virgolette: {{{ ["pagina"] }}} Ora clicchiamo sul NomePagina che abbiamo ideato, verremo indirizzati ad un Tutorial sulla creazione della nuova pagina. Possiamo scegliere tra i modelli di pagina (template), oppure cliccare in alto a sinistra su "Create new empty page" per iniziare a scrivere una pagina in bianco. Una volta conclusa la scrittura sarà sufficiente cliccare su "Save Changes" in basso e la pagina sarà creata. == Inserire un nuovo documento nel Wiki: regole di netiquette == I documenti del Wiki vengono consultati da molti utenti, sia esperti che principianti. Sebbene non esista una regola ferrea per la pubblicazione delle pagine, è bene iniziare a scrivere con un a certa "prudenza" perchè le pagine inserite, se errate, possono danneggiare altri utenti.[[BR]] Per questo motivo '''si consiglia''' di iniziare a scrivere il documento e di inserire il relativo link nella pagina ToDo, dove gli amministratore del Wiki possono vederla ed eventualmente correggerla. In seguito il link sarà inserito nell'indice generale della documentazione dove altri utenti potranno eventualmente fare aggiunte o ulteriori modifiche. = I Links = Come abbiamo già detto tutte le pagine del Wiki devono essere facilmente rintracciabili. |
I link in cima a questa pagina sono a portata di mano per risolvere buona parte delle problematiche relative all'editing delle pagine wiki. Tuttavia in caso di ulteriori dubbi '''non esitare''' a chiedere aiuto nei canali di supporto: [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]], [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|Mailing List|mailing list]] e canale IRC [[http://webchat.freenode.net/?channels=ubuntu-it-doc|#ubuntu-it-doc]]. ---- CategoryComunitaDocumentazione |
Guida wiki
In questa pagina sono raccolti link a pagine con informazioni utili per editare pagine wiki e per compiere operazioni di diverso genere.
Per chi inizia
Per l'editazione delle pagine è consigliabile aiutarsi con le seguenti guide:
Guida al wiki in 10 passi più uno: concisa panoramica sulle funzioni base per l'editazione delle pagine.
Glossario rapido: breve presentazione delle impostazioni stilistiche delle guide.
Quanto più un utente riesce a seguire queste linee guida, tanto meglio è. Sarà poi cura degli editori correggere le imperfezioni.
A proposito di stile
Come di sicuro avrai notato la maggior parte delle pagine hanno uno stile simile, per esempio: medesime frasi per indicare l'installazione di un pacchetto, medesima formattazione del testo per indicare le voci di menù, medesima struttura dei capitoli, uso di frasi impersonali e così via. Questo al fine di ottenere una documentazione concisa, omogenea e ben ordinata.
Nel corso degli anni sono state catalogate e aggiornate le espressioni di uso comune per descrivere i vari passaggi all'interno delle guide e le formattazioni del testo (grassetti, corsivi, elenchi, altro). Buona parte dei link in questa pagina possono essere di aiuto per chiunque desideri approfondire questi aspetti, in particolar modo la pagina RegoleStilistiche approfondisce tematiche di tipo generale sulla documentazione.
Trucchi del mestiere
Ovviamente imparare tutto a memoria è impresa per pochi, ma soprattutto non è necessario!
Prendendo a modello una pagina esistente avrai già visivamente uno spunto per creare la tua. In più una volta effettuato il login, in cima ad ogni pagina è disponibile il menù a tendina Altre azioni nel quale è possibile selezionare la voce Mostra il testo grezzo. In questo modo se su di una guida non ti è chiaro come sia stata ottenuta una qualsiasi formattazione, potrai controllare di persona e copiare i codici utilizzati.
In caso di dubbi
I link in cima a questa pagina sono a portata di mano per risolvere buona parte delle problematiche relative all'editing delle pagine wiki. Tuttavia in caso di ulteriori dubbi non esitare a chiedere aiuto nei canali di supporto: forum, Mailing List e canale IRC #ubuntu-it-doc.