Aiuto:Sintassi Wiki

Nella scrittura degli articoli e delle altre pagine di Wikivoyage, oltre al testo normale, si utilizza anche uno specifico linguaggio di markup, detto wikitesto o wikisintassi o anche wikicodice, con il quale si ottengono effetti di formattazione (del testo e della pagina) e di strutturazione (della singola pagina e ipertestuale).

Nel testo che segue vedrete prima il codice e poi subito dopo cosa si ottiene. In altre parole, per rendere il testo simile a quello che vedete dovrete scriverlo così come riportato immediatamente prima.

Si potrebbe tenere questa pagina aperta in una finestra separata del browser per avere un riferimento. Se si vogliono fare delle prove senza pericolo di far danni, si può usare la pagina delle prove. NB: Il wikitesto non va invece utilizzato quando si edita con VisualEditor, la nuova interfaccia di modifica che da luglio 2013 affianca quella classica. Per imparare a utilizzare VE, si veda il manuale relativo. Il sistema rileva, ad esempio, se si stanno inserendo delle parentesi quadre o graffe e avvisa l'utente, ma se si ignora il messaggio e si salva ugualmente, negli articoli compariranno dei tag <nowiki> che andranno poi corretti.

Esempi modifica

Sezioni modifica

In Wikivoyage l'organizzazione in sezioni è un tantino più rigida che in Wikipedia, in quanto le sezioni maggiori che compongono lo scheletro vero e proprio dell'articolo sono definite da appositi modelli. Tuttavia può capitare che tu voglia suddividere il testo in sezioni minori, specie se l'articolo che stai scrivendo è diventato molto corposo; Per le sezioni si usa il seguente codice:

Sintassi:

==Sezione==
===Sottosezione===
====Sotto-sottosezione====

Effetto:

Sezione
Sottosezione
Sotto-sottosezione
Gli uguali corrispondono ai tag HTML <h2></h2>...<h2></h3> e così via.

Attenzione: La sintassi =Intestazione= (con un solo "=") è riservata al titolo e viene gestita automaticamente dal software MediaWiki: gli utenti non devono quindi usarla negli articoli.

Andare a capo modifica

Sintassi:

Andare a capo non ha effetto
sulla formattazione.
Si può usare
per separare le frasi all'interno di
un paragrafo.

Lasciando una linea vuota invece si inizia un
nuovo paragrafo.

Effetto: Andare a capo non ha effetto sulla formattazione. Si può usare per separare le frasi all'interno di un paragrafo.

Lasciando una linea vuota invece si inizia un nuovo paragrafo.

Andare a capo con l'HTML modifica

Sintassi:

Si può andare a capo<br />
senza iniziare un nuovo paragrafo,<br />
utilizzando il tag HTML <br />

Effetto: Si può andare a capo
senza iniziare un nuovo paragrafo,
utilizzando il tag HTML <br />.

ATTENZIONE: questo elemento è utile nella redazione di tabelle, elenchi e template. Nella stesura del normale testo degli articoli non dovrebbe essere utilizzato affatto.

Indentazione modifica

Sintassi:

: I due punti indentano una linea o un paragrafo.
:: Usandoli più volte si indenta ancora.
::: È comodo indentare nelle discussioni.
Andando a capo si inizia un nuovo paragrafo.

Effetto:

I due punti indentano una linea o un paragrafo.

Usandoli più volte si indenta ancora.

È comodo indentare nelle discussioni.

Andando a capo si inizia un nuovo paragrafo.

Elenco puntato modifica

Sintassi:

* Le liste sono facili da fare:
** iniziare ogni linea con un asterisco
*** altri asterischi fanno iniziare altri livelli

Effetto:

Le liste sono facili da fare:
- iniziare ogni linea con un asterisco
  - altri asterischi fanno iniziare altri livelli

Liste numerate modifica

Sintassi:

# Le liste numerate sono utili
## molto ordinate
## facili da seguire

Effetto:

Le liste numerate sono utili
1. molto ordinate e
2. facili da seguire

Elenchi misti modifica

Sintassi:

* Si possono anche mescolare le liste
*# e annidarle
*#* così

Effetto:

Si possono anche mescolare le liste
1. e annidarle
  - così

Continuare una numerazione modifica

Sintassi:

# Può capitare di dover continuare
#:una numerazione
# dopo averla interrotta
# oppure scrivere<br />su più<br />righe
# mantenendo anche l'indentazione

Effetto:

Può capitare di dover continuare
una numerazione
dopo averla interrotta
oppure scrivere
su più
righe
mantenendo anche l'indentazione

Iniziare una lista da un numero x modifica

Sintassi:

<ol>
<li value=3>Si può iniziare una lista da un numero diverso da 1</li>
<li>e continuarla</li>
<li value=6>o saltare dei numeri</li>
<li value=2>o anche tornare indietro</li>
<li>o ripetere dei numeri già usati</li>
# ma non usare <nowiki><li></nowiki> e <nowiki>#</nowiki> nella stessa lista
</ol>

Effetto:

Si può iniziare una lista da un numero diverso da 1
e continuarla
o saltare dei numeri
o anche tornare indietro
o ripetere dei numeri già usati

ma non usare <li> e # nella stessa lista

Lista descrittiva modifica

Sintassi:

; lista di descrizioni
: un modo semplice per strutturare un elenco di concetti da spiegare
; prima voce : testo della descrizione o definizione della prima voce o termine
; seconda voce : seconda descrizione
; altra voce
: prima descrizione dell'altra voce
: seconda descrizione, stavolta necessariamente in un'altra linea che cominci con i due punti
: terza descrizione, come sopra

Effetto:

lista di descrizioni: un modo semplice per strutturare un elenco di concetti da spiegare
prima voce: testo della descrizione o definizione della prima voce o termine
seconda voce: seconda descrizione
altra voce: prima descrizione dell'altra voce; seconda descrizione, stavolta necessariamente in un'altra linea che cominci con i due punti; terza descrizione, come sopra

Testo non formattato modifica

Sintassi:

Ci sono vari modi di inserire un testo
  non formattato.
Uno è come nel rigo precedente, inserire uno spazio a inizio rigo
oppure racchiudere il testo tra tag <nowiki><pre></pre> o <code></code>
in <code>questa [[maniera]]</code></nowiki>

Effetto:

Ci sono vari modi di inserire un testo

 non formattato.

Uno è come nel rigo precedente, inserire uno spazio a inizio rigo oppure racchiudere il testo tra tag <pre></pre> o <code></code> in questa [[maniera]]

Allineamenti modifica

Centrato modifica

Sintassi:

<div style="text-align: center;">Testo centrato.</div>

Effetto:

Testo centrato.

A destra modifica

Sintassi:

<div style="text-align:center;">Testo centrato.</div>

Effetto:

Testo allineato a destra.

Linea orrizontale modifica

Sintassi:

Una linea di divisione orizzontale: ''qui'' è sopra la linea
----
e ''qui'' sotto la linea.

Effetto: Una linea di divisione orizzontale: qui è sopra la linea

e qui è sotto la linea.

Link modifica

Per approfondire, vedi: Aiuto:Link.

Sintassi:

[[Baviera]] è un wikilink allo stato federato della Germania, il cui sito ufficiale è [http://bayern.de]. Il sito possiamo visualizzarlo anche con un'etichetta a nostro piacimento così: [http://bayern.de Baviera]

Effetto:

Baviera è un wikilink allo stato federato della Germania, il cui sito ufficiale è [1]. Il sito possiamo visualizzarlo anche con un'etichetta a nostro piacimento così: Baviera

Redirect modifica

E se una città o un posto è conosciuto con due nomi? Semplice! La pagina sarà sotto il nome più diffuso in Italia e in corrispondenza dell'altro nome creeremo un redirect.

Un esempio: la meravigliosa città iraniana di Isfahan è conosciuta anche come Esfahan, perché noi occidentali non ci mettiamo ancora d'accordo se quella lettera persiana si scriva "E" o "I" nel nostro alfabeto. Allora, noi wikiviaggiatori, risolviamo il problema creando entrambe le pagine ma, dato che non avrebbe senso avere due pagine uguali, facciamo sì che una rimandi all'altra con il nome più diffuso (qui Esfahan). In Isfahan scriveremo

#RINVIA [[Esfahan]]

e il gioco è fatto!

Link Speciali modifica

Ci sono alcune pagine speciali dei progetti Wikimedia. Alcune sono per veri esperti, che ci auguriamo tu diventi presto, altre invece possono tornarti utili sin da subito:

Sintassi:

[[Speciale:Whatlinkshere/Aiuto:Sintassi Wiki]] 
[[Speciale:Recentchangeslinked/Aiuto:Sintassi Wiki]]

Effetto: Speciale:Whatlinkshere/Aiuto:Sintassi Wiki

Speciale:Recentchangeslinked/Aiuto:Sintassi Wiki

Immagini modifica

Per approfondire, vedi: Aiuto:Immagini.

Sintassi:

Un'immagine [[Immagine:Wikivoyage-logo-v3-laurel.svg|70px|Wikivoyage logo]] si 
inserisce facilmente in Wikivoyage.

Effetto:

Un'immagine si inserisce facilmente in Wikivoyage. Il nome del file lo troverai sul database Wikimedia contenente tutti i file multimediali. Quello che vedi qui si trova in questa pagina

Template modifica

Per approfondire, vedi: Aiuto:Template.

Sui template c'è molto da dire e per informazioni più dettagliate ti raccomandiamo di leggere la pagina di aiuto corrispondente. Qui in breve possiamo dire che su quasi la totalità delle pagine c'è bisogno di inserire particolari effetti di formattazione o informazioni che devono essere strutturate in maniera omogenea su tutte le pagine del sito che contengono le stesse informazioni. Come fare evitando il più possibile errori? A volte, poi questi effetti che è necessario rendere, si rivelano molto complicati da scrivere in wikicodice. I template suppliscono anche a questo. Sono delle pagine speciali, contenente wikicodice, ciascuno creato per una speciale funzione. I template possono essere creati per gli usi più diversi.

C'è anche da dire che qui su Wikivoyage, troverai una particolare classe di template, chiamati listing. Essi servono per inserire informazioni sui PoI, o punti di interesse e sono un pezzo fondamentale dei nostri articoli. Su di loro potrai imparare di più nelle pagine Wikivoyage:listing e Aiuto:Template

Tabelle modifica

Per approfondire, vedi: Aiuto:Tabelle.

Pensaci su due volte prima di aggiungere una tabella su Wikivoyage. Molte delle tabelle necessarie sono già previste da Template preparati ad hoc e non dovrai costruirla tu. Inoltre, esse complicano di parecchio il codice di un articolo e potrebbe diventare difficile leggerlo per un utente senza competenze informatiche avanzate.

**Elementi di una tabella su progetti wiki:**
{\|	table start -- aggiungi class="wikitable" per rendere le celle visibili e creare le linee
\|+	titolo della tabella opzionale;
\|-	inizio riga opzionale per la prima riga
!	titolo della cella, opzionale. Se vuoi metterne più d'uno, per diverse celle puoi andare a capo e mettere ogni volta un (`!`) o inserirne due su uno stesso rigo (`!!`)
\|	contenuto obbligatorio! Ogni volta che si presenta questo segno il testo che segue diventa il contenuto della cella. Per celle su una stessa riga puoi semplicemente separare il contenuto con due (`\|\|`) o iniziare una nuova linea, ciascuna con un nuovo indicatore (`\|`).
\|}	fine tabella

Sintassi:

{| class="wikitable" |+ TITOLO ! titolo cella !! titolo cella 2 |- | contenuto 1 || contenuto 2 |}

equivalente a questo:

{| class="wikitable" |+ TITOLO ! titolo cella ! titolo cella 2 |- | contenuto 1 | contenuto 2 |}

Effetto:

TITOLO
titolo cella	titolo cella 2
contenuto 1	contenuto 2

Formattazione dei caratteri modifica

Come viene visualizzato	Cosa si scrive
enfatizzato, maggiormente enfatizzato, molto enfatizzato. Sono doppi e tripli apostrofi, non virgolette. Notare che su quasi tutti i browser, queste hanno la stessa funzione del corsivo e del grassetto.	''enfatizzato'', '''maggiormente enfatizzato''', '''''molto enfatizzato'''''.
Un font typewriter per i `termini tecnici`. per motivi semantici, <code> dovrebbe essere usato quando si scrivono programmi per computer	Un font typewriter per i <code>termini tecnici</code>.
Si può usare del testo piccolo per le didascalie.	Si può usare del <small>testo piccolo</small> per le didascalie.
Si può ~~barrare del materiale cancellato~~ e sottolineare nuovo materiale.	Si può <s>barrare del materiale cancellato</s> e <u>sottolineare nuovo materiale</u>.
Diacritici: À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ò Ó Ô Õ Ö Ø Œ Ù Ú Û Ü Ý Ÿ à á â ã ä å æ ç è é ê ë ì í î ï ò ó ô õ ö ø œ ù ú û ü ý ÿ ß Ñ ñ Š š Ma per questi hai anche la sezione "Caratteri speciali" nell'interfaccia di modifica.	À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ò Ó Ô Õ Ö Ø &OElig; Ù Ú Û Ü Ý &Yuml; à á â ã ä å æ ç è é ê ë ì í î ï ò ó ô õ ö ø &oelig; ù ú û ü ý ÿ ß Ñ ñ &Scaron; &scaron;
Punteggiatura: ¿ ¡ « » § ¶ † ‡ • —	¿ ¡ « » § ¶ &dagger; &Dagger; • —
Simboli commerciali: ™ © ® ¢ € ¥ £ ¤	™ © ® ¢ € ¥ £ ¤
Pedice e apice: Pedice: x₂ Apice: x² o x² ε₀ = 8,85 × 10⁻¹² C² / J m.	Pedice: x<sub>2</sub> Apice: x<sup>2</sup> o x² ε<sub>0</sub> = 8.85 × 10<sup>−12</sup> C² / J m.
Caratteri greci: Α Β Γ Δ Ε Ζ Η Θ Ι Κ Λ Μ Ν Ξ Ο Π Ρ Σ Τ Υ Φ Χ Ψ Ω α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ ς σ τ υ φ χ ψ ω ϑ ϒ ϖ	Α Β Γ Δ Ε Ζ Η Θ Ι Κ Λ Μ Ν Ξ Ο Π Ρ Σ Τ Υ Φ Χ Ψ Ω α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ &sigmaf; σ τ υ φ χ ψ ω &thetasym; &upsih; ϖ
Caratteri matematici: ∫ ∑ ∏ √ − ± ∞ ∼ ≅ ≈ ∝ ≡ ≠ ≤ ≥ × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ∅ ∈ ∉ ∋ ∩ ∪ ⊂ ⊃ ⊄ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ← ↑ → ↓ ↔ ℘ ⇐ ⇑ ⇒ ⇓ ⇔ ℑ ℜ	∫ ∑ ∏ √ − ± ∞ &sim; &cong; ≈ &prop; &equiv; ≠ ≤ ≥ × · ÷ ∂ ′ ″ ∇ &permil; ° &there4; &alefsym; ∅ ∈ ∉ &ni; ∩ ∪ ⊂ ⊃ &nsub; &sube; &supe; ¬ &and; &or; ∃ ∀ ← ↑ → ↓ ↔ &weierp; ⇐ &uArr; ⇒ &dArr; ⇔ &image; &real;
x² ≥ 0 true. Per aggiungere spazi, usare i non-breaking spaces - ` `. ` ` evitano anche che la linea si interrompa in mezzo al testo, utile per le formule.	<i>x</i><sup>2</sup>  ≥  0 true.
Formule complicate: $\sum _{n=0}^{\infty }{\frac {x^{n}}{n!}}$	<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

Nowiki e testo nascosto modifica

In tutta questa pagina abbiamo avuto bisogno di farti vedere il testo che scrivevamo, perché tu visualizzassi il codice. Ma come si fa? Ecco svelato il mistero:

Sintassi:

<nowiki>Collegamento &rarr; (<s>alla</s>) [[Aiuto:FAQ]]</nowiki>

Effetto Collegamento → (<s>alla</s>) [[Aiuto:FAQ]]

E se invece abbiamo bisogno di nascondere del testo? Può, infatti capitare, di dover inserire un commento in un testo perché sia visibile solo a chi modifica il testo e non a chi semplicemente lo legge. Per nascondere un testo si fa così:

Sintassi:

''in questa frase c'è <!--eh eh eh--> qualcosa di nascosto''

Effetto:

in questa frase c'è qualcosa di nascosto

WikEd modifica

Per approfondire, vedi: Aiuto:Accessori/WikEd.

WikEd è un editor di testo in formato rich text format (RTF), utilizzabile su Wikivoyage e su tutti i siti che girano su piattaforma Wikimedia. Rispetto alla barra delle modifiche standard, aggiunge altre e più articolate funzioni.

Vedi anche modifica

Mi sembra di aver capito, ma...

Se non riesci ad afferrare qualche concetto o non capisci il perché di tale procedura, ci metti cinque secondi a chiederlo e avere risposta. Se pensi invece di avere una proposta, piccola o grande che sia, siamo tutti pronti ad ascoltarti.

L'elenco di tutte le pagine riguardanti Wikivoyage si trova nella pagina Aiuto:Aiuto.