Help:Editing (Italiano)
Registrazione ed accesso
Si possono leggere le pagine senza creare un account o loggarsi. Per creare una account (gratuito), basta cliccare il collegamento "create an account or log in" sul lato in alto a destra di questa pagina. Basta un solo login per tutti i documenti del wiki.
Editare
Come tutti i wiki, può essere editata ogni pagina non protetta. I cambiamenti sono visibili immediatamente. Basta cliccare edit che si trova in alto su ogni pagina.
Spiegare il motivo delle modifiche nel box "Summary" che si trova tra la fine della pagina di modifica e i pulsante "Save Page" e "Show preview"
Utilizzare il bottone [[Help:Show preview|show preview] per vedere se la formattazione è soddisfacente prima di salvare. Ricordarsi di salvare l'anteprima prima di uscire.
Se si è eseguito il login, si può indicare una modifica come minor spuntando la casella This is a minor edit per fare in modo che gli altri sappiano che ciò che avete modificato non è qualcosa di sostanziale.
Per provare a modificare, aprire una nuova finestra e andare a sandbox (è un area dedicata alle ai test di editing), cliccare su edit. Aggiungere qualcosa e cliccare "Save page"
Aggiungere una nuova pagina
Per aggiungere una nuova pagina ad una nuova categoria basta semplicemente:
- "Editare" una pagina con il nuovo titolo semplicemente andando su https://wiki.archlinux.org/title/My_new_page
- Aggiungere una categoria con il tag [[Category:la categoria scelta]] all'inizio della pagina.
Layout
Sebbene il contenuto della pagine wiki vari da topic a topic, la linea generale raccomanda di mantenere la consistenza tra gli articoli. Questo sotto è un buon esempio di come organizzare un articolo:
- Introduzione -- Un riassunto sul tema dell'articolo
- Installazione -- Se necessario, le istruzioni su come installare il software
- Configurazione -- Se necessario, come configurare il software installato
- Risoluzione dei problemi -- Domande frequenti riguardanti il software
- Tips & Tricks -- Se necessario, suggerimenti o trucchi avanzati sull'utilizzo del software
- Altre Risorse -- Il posto per indicare ulteriori riferimenti
Ok, ogni sottotitolo può "e deve" essere messo "sotto" ognuno di questi titoli. Guardare Capitoli e Sottocapitoli più in basso.
Formattazione
Molta della formattazione del testo viene fatta attraverso i wiki markup, quindi non occorre imparare HTML.
Grassetto e Corsivo
Grassetto e Corsivo si ottengono mettendo la parola o la frase tra apostrofi(') multipli:
- con ''corsivo'' si ottiene corsivo. (2 apostrofi all'inizio e alla fine della parola)
- con '''grassetto''' si ottiene grassetto. (3 apostrofi all'inizio e alla fine della parola)
- con '''''grassetto e corsivo''''' si ottiene bolded italics. (2 + 3 = 5 apostrofi all'inizio e alla fine della parola)
Titoli e sottotitoli
I titoli e i sottotitoli rappresentano un modo semplice per organizzare un articolo. Se si possono distinguere due o più argomenti distinti questi possono essere separati con l'inserimento dei titoli per ogni sezione.
I Titoli possono essere creati così come segue:
- =Titolo di Primo livello= (1 segno uguale)
- ==Sottotitolo== (2 segni uguale)
- ===Un ulteriore livello sotto=== (3 segni uguale)
- ====Un ulteriore livello sotto==== (4 segni uguale)
- =====Un ulteriore livello sotto===== (5 segni uguale)
Se un articolo ha almeno tre titoli, viene generata automaticamente una tabella dei contenuti (TOC). Se non si vuole usare una TOC, bisogna inserire un
__NOTOC__ nell'articolo.
Si provi a creare qualche titolo nel sandbox e a vedere l'effetto della TOC.
Indentare
Per indentare il testo, mettere i due punti (:) all'inizio della riga. Più due punti si mettono, più il testo sarà indentato. Un newline (la pressione di Enter or Return) indica la fine del paragrafo indentato.
Per Esempio:
Questo è allineato tutto a destra.
:Questo è indentato leggermente. ::Questo è più indentato. viene mostrato come: Questo è allineato tutto a destra.
- Questo è indentato leggermente.
- Questo è più indentato.
Elenco puntato
Per inserire un punto si usa l'asterisco (*). Come per quando si indenta, più asterischi davanti al paragrafo rappresentano più livello di indentazione.
Un breve esempio:
*Primo elemento della lista *Secondo elemento della lista **Sub-list elemento sotto al secondo *Non è divertente?
Che viene mostrato come:
- Primo elemento della lista
- Secondo elemento della lista
- Sub-list elemento sotto al secondo
- Non è divertente?
Liste numerate
Si possono creare inoltre delle liste numerate. Per queste va usato il cancelletto (#). Usando più cancelletti # si avrà l'effetto di indentazione.
Esempio:
#Primo elemento #Secondo elemento ##Sub-item sotto il secondo elemento #Terzo elemento
Che viene mostrato come:
- Primo elemento
- Secondo elemento
- Sub-item sotto il secondo elemento
- Terzo elemento
Codice
Per aggiungere del codice al wiki basta anteporre ad ogni riga uno spazio bianco.
Collegamenti
I collegamenti sono importanti nelle pagine wiki per aiutare i lettori a visitare il sito.
Collegamenti interni
Ci si può riferire alle pagine del wiki usando i collegamenti interni. Si possono aggiungere collegamenti a titoli già esistenti ed anche a titoli che voi pensate possano esistere in futuro.
Per inserire un link ad un'altra pagina dello stesso wiki basterà inserire il titolo tra le doppie parentesi quadre.
Per esempio, se si vuole creare un link alla pagina "Wikia", basterà inserire:
[[Wikia]]
Se si volesse indicare il link con delle parole diverse da quelle del titolo dell'articolo a cui si punta, si può aggiungere un nome alternativo dopo una pipe "|". (SHIFT + BACKSLASH).
Per esempio, se si vuole creare un link a Arch Linux, ma si vuole visualizzare "home page" basterà scrivere:
Andate all' [[Arch Linux|home page]]...
che viene visualizzato come:
- Andate all' home page...
Quando si vuole usare il plurale di un titolo di un articolo (o aggiungere qualche suffisso) per un link, si possono aggiungere le lettere extra fuori dalle parentesi quadre.
Per esempio, si può scrivere:
Add questions to the Arch Linux for [[quiz]]zes.
che viene visualizzato come:
- Add questions to the Arch Linux for quizzes.
Collegamenti a sezioni di un documento
Per creare un collegamento ad una sezione di un documento basta aggiungere un cancelletto # seguito dal titolo della sezione.
[[ArchWiki_Tutorial_(Italiano)#Collegamenti_a_sezioni_di_un_documento|Sezioni]]
verrà mostrato come Sezioni.
Collegamenti a traduzioni
ArchWiki permette di scrivere gli articoli in più linguaggi. Il "soggetto" deve essere lo stesso per ogni lingua, questo aiuta a collegare le stesse pagine che esistono nei vai linguaggi. Se un articolo esiste in più di un linguaggio, ArchWiki ha un "i18n-box", che va aggiungo all'articolo, che contiene il link allo stesso articolo ma in un'altra lingua.
Per aggiungere questo i18n-box ad un articolo, basta mettere all'inizio dell'articolo:
{{i18n_links_start}} {{i18n_entry|Deutsch|German Title of the Article}} {{i18n_entry|Français|French Title of the Article}} {{i18n_links_end}}
Se il titolo è uguale per tutti allora il titolo sarà differenziato come segue
Titolo (Lingua)
Per esempio:
Gnome Gnome (Deutsch) Gnome (Français) Gnome (Italiano)
Collegamenti esterni
Se si vuole mostrare un collegamento ad un sito fuori dai wiki, basterà inserire l' URL completo della pagina da collegare.
https://www.google.com/
Se si volesse mostrare un testo diverso dall'URL per il collegamento basterà mettere l'URL tra parentesi quadre e indicare il nome alternativo separato da uno spazio (non una pipe). Quindi se si vuole un link come Il motore di ricerca Google , basterà scrivere:
[http://www.google.com/ Il motore di ricerca Google]
Redirects
Per re-direzionare in maniera automatica da una pagina ad un altra basta inserire #REDIRECT e inserire tra parentesi il nome della pagina dove si vuole passare in automatico.
Per esempio si potrebbe re-direzionare da "Cats" a "Cat":
#REDIRECT [[Cat]]
In questo modo chiunque inserisce una delle due versioni nel box di ricerca arriverà automaticamente a "Cat".
Richieste
Volete una guida per qualcosa? Volete sapere qualcosa? Basterà mettere una richiesta nella pagina wiki Requests!
Le variabili Wiki e i templates
Si usa {{SITENAME}} per indicare il documento wiki corrente. Se si scrive, {{SITENAME}} in questo sito verrà visualizzato ArchWiki.
Si possono creare anche dei template personalizzati. Dopo aver creato la pagina Template:XXX, basterà usare il comando {{XXX}} che ne includerà il contenuto nella pagina corrente. Quindi, se si ha qualcosa che va incluso in molte pagine, allora si dovrà utilizzare un template.
Pagine di discussione
Le pagine di discussione servono a comunicare con gli altri utenti dell' Arch Wiki.
Per commentare ogni pagine basterà andare sulla pagina e cliccare sul tab "discussion" in cima alla pagina. Aggiungere un nuovo commento alla fine, o sotto al commento al quale si vuole rispondere.
Firmare il proprio commento digitando ~~~~ per inserire il proprio username e la data.
Si utilizza indenting per formattare una discussione. Si usa indentare di un livello in più la propria risposta rispetto al commento al quale si va a rispondere.
Provare editando talk page of the sandbox.
Pagina utente
Ognuno ha una pagina utente, dove ogni persona può lasciare un messaggio pubblico. Se qualcuno ci lascia un messaggio, si vedrà una nota "You have new messages" con un collegamento alla propria pagina utente.
Si potrà rispondere al messaggio nella pagina utente della persona o nella propria pagina sotto al messaggio originale. Se si risponde nella pagina utente della persona che vi ha lasciato il commento, essa riceverà una notifica.
Categorie speciali
Esistono delle categorie speciale che aiutano a lavorare con ArchWiki.
L'articolo non è finito per essere usato
La Categoria Stub[link interrotto 2020-08-06] contiene tutti gli articoli che sono marcati con il flag
{{stub}}. Le ragioni per cui questi articoli si trovano nella categoria stub sono:
- che sono troppo corti
- non spiegano nulla
- contengono parti non finite
Gli articoli non sono tradotti
La Categoria "Translation Requested"[link interrotto 2020-08-06] contiene tutti gli articoli che sono marcati con il flag
{{translateme}}. Le ragioni per cui gli articoli si devono trovare in questa particolare categoria sono:
- parte di essi non sono nel linguaggio in cui dovrebbero essere
- il contenuto non è tutto tradotto ma semplicemente copiato dall'inglese o altra lingua
- la pagina originale è stata aggiornata e mancano delle parti alla traduzione.
Gli articoli che contengono delle informazioni confuse o potenzialmente sbagliate
La Categoria "Accuracy Disputes"[link interrotto 2020-08-06] contiene tutti gli articoli che sono marcati con il flag
{{accuracy}}. Le ragioni per cui gli articoli si devono trovare in questa particolare categoria sono:
- gli utenti si sono accorti di informazioni potenzialmente sbagliate o confuse e stanno discutendo per correggerle
- la pagina contiene delle informazioni non aggiornate.
Questo flag è spiegato in dettaglio nell'articolo Accuracy_dispute.