Regole sui collegamenti

Gli obiettivi possono essere:
- Pagine locali
  - sia assolute: il nome di una pagina o pagina principale/sotto pagina
  - che relative: /qualche sotto pagina oppure ../una pagina figlia
- Pagine interwiki: AltroWiki:nome della pagina
- URL: http://server/percorso
- Le pagine e gli URL possono contenere un anchor (...#nomeancora)
Usare [[obiettivo]] per collegare un oggetto.
Usare {{obiettivo}} per inglobare/mostrare un oggetto (solitamente un'immagine).
Usare obiettivo|testo al posto del solo obiettivo per usare un particolare testo (come il testo per un collegamento o il testo alternativo per le immagini).
Usare obiettivo|testo|parametri al posto del solo obiettivo per aggiungere altri parametri.
Usare obiettivo|{{immagineobiettivo}} per mostrare un'immagine al posto del testo.

URL, pagine interwiki, indirizzi email e nomi di pagina CamelCase vengono riconosciuti automaticamente, anche senza parentesi quadre.

Guida veloce

Collegamento	Sintassi	Note
Interno	`NomeWiki`	Pagina con un nome NomeWiki
Interno libero	`[[collegamento libero]]`	Qualsiasi nome di pagina
Interno a una sotto pagina	`/SottoPagina` o `[[/Sotto pagina]]`
Interno a una pagina figlia	`../PaginaFiglia` o `[[../figlia\|testo collegamento]]`
Interno con testo	`[[UnaPagina\|Una pagina]]`
Interno con testo e parametri	`[[UnaPagina\|Una pagina\|target="_blank"]]`	Consultare più sotto per i parametri di configurazione
Interno usando un'immagine	`[[UnaPagina\|{{attachment:immagine.png}}]]`
Interno usando un'immagine e apre in una nuova finestra	`[[UnaPagina\|{{attachment:immagine.png}}\|target="_blank"]]`
Allegato	`[[attachment:immagine.png]]`	Collega a un'immagine
Allegato di un'altra pagina	`[[attachment:UnaPagina/immagine.png]]`	Collegamenti a un'immagine allegata in un'altra pagina
Interwiki	`Altrowiki:UnaPagina`	Richiede il nome del wiki con la maiuscola
Interwiki libero	`[[altrowiki:unapgina]]`	Qualsiasi nome wiki
Esterno	`http://example.net`
Esterno con testo	`[[http://example.net\|Sito di esempio]]`
Esterno con testo, apre in una nuova finestra	`[[http://example.net\|Sito di esempio\|target="_blank"]]`	Consultare più sotto per i parametri di configurazione
Esterno usando un'immagine	`[[http://example.net/\|{{attachment:immagine.png}}]]`
Esterno usando un'immagine, apre in una nuova finestra	`[[http://example.net/\|{{attachment:immagine.png}}\|target="_blank"]]`
Interno delimitato	Un``NomeWiki	2 apici inversi, da usarsi quando un NomeWiki finisce a metà di una parola
Evitare un collegamento interno	`!NomeWiki`	Funzione configurabile

Includere	Sintassi	Commento
Un'immagine allegata	`{{attachment:un'immagine.png}}`	Mostra l'immagine
Un'immagine allegata	`{{attachment:un'immagine.png\|testo}}`	Mostra l'immagine con un testo alternativo (utile per l'accessibilità)
Un'immagine allegata definendo l'allineamento	`{{attachment:un'immagine.png\|testo\|align="posizione"}}`	Mostra l'immagine allegata con un testo alternativo e allineata alla posizione (può essere top, middle, bottom, right o left)
Un'immagine allegata ridimensionandola	`{{attachment:an image.png\|testo\|width=100}}`	Mostra l'immagine allegata con un testo alternativo e la ridimensiona a 100px di larghezza (non omettere il testo!)
Un'immagine esterna	`{{http://example.net/image.png}}`	Mostra l'immagine
Un'immagine esterna con testo alternativo	`{{http://example.net/image.png\|testo alternativo}}`	Mostra l'immagine con un testo alternativo (utile per l'accessibilità)
Un'immagine esterna definendo l'allineamento	`{{http://example.net/image.png\|testo alternativo\|align="posizione"}}`	Mostra l'immagine, posizione può essere top, middle, bottom, right o left
Un'immagine esterna ridimensionandola	`{{http://example.net/image.png\|testo alternativo\|width=100}}`	Mostra l'immagine con un testo alternativo e la ridimensiona a 100px di larghezza (non omettere il testo!)

Spiegazioni

URL

Se vengono inseriti URL nel testo normale, si verifica il problema di determinare cosa appartenga all'URL e cosa no. Ci sono quattro modi per forzare la fine di un URL:

inserire uno spazio dopo l'URL,
usare la sequenza di escape SixSingleQuotes,
usare la sintassi con le doppie parentesi quadre.

Gli schemi di URL supportati sono: http, https, ftp, file e altri. L'amministratore del wiki può estendere questi schemi usando la variabile url_schemas (consultare AiutoSuConfigurazione).

Oltre ai normali schemi, esistono quelli specifici di MoinMoin: attachment e drawing servono per allegare file e vengono descritti in AiutoSuAzioni/AllegaFile.

Spazi

È sempre possibile utilizzare le doppie parentesi quadre per inserire pagine o file con spazi nel nome.

Questo funziona anche con i collegamenti interwiki, se il wiki obiettivo comprende la quotatura standard degli URL (gli spazi diventano %20).

Anchor

Per inserire ancore in una pagina serve la macro Anchor: <<Anchor(nomeanchor)>>, dove "nomeanchor" è l'identificativo dell'ancora.

Per collegare un'ancora nella stessa pagina wiki, usare [[#nomeancora]] o [[#nomeancora|testo]].

Per collegare un'ancora in un'altra pagina wiki, usare è[:NomePagina#nomeancora]] o [[:NomePagina#nomeancora|etichetta di testo]], dove "NomePagina" è il nome dell'altra pagina e "nomeancora" è l'identificativo dell'ancora in quella pagina.

$/!\$ In alcuni Wiki, un collegamento alla pagina ModificheRecenti può fare riferimento alla stessa pagina del collegamento: modificherecenti. Questo può verificarsi su sistemi Windows e Mac Os X perché, solitamente, non fanno differenza tra maiuscole e minuscole.

Evitare che i collegamenti funzionino automaticamente

Per evitare che una parola tipo NomePagina divenga un collegamento automaticamente, utilizzare Nome``Pagina (Il problema in questo caso è che una ricerca per la parola NomePagina non ritornerà un risultato per Nome``Pagina per i doppi apici inversi inseriti).

È possibile evitare che un NomeWiki divenga un collegamento anche inserendo un punto esclamativo (bang) prima del NomeWiki, cioè !NomeWiki. Questo comportamento è disponibile in modo predefinito, ma può essere disabilitato con l'opzione di configurazione bang_meta = False. Usando questo metodo non influenzerà le ricerche per i NomiWiki disabilitati, con l'esclusione di alcune frasi quotate ed espressioni regolari.

Per evitare che un URL diventi un collegamento, è possibile utilizzare `http://...` o {{{http://...}}}.

Usare parametri con i collegamenti

Può essere utile, a volte, usare dei parametri aggiuntivi per un collegamento, influenzandone la resa grafica, il comportamento e come si collega all'obiettivo (questo riguarda il parametri in [[obiettivo|testo|parametri]]).

Impostare gli attributi del tag <a>

Attributi disponibili: class, title, target, accesskey (per un loro significato, consultare una qualsiasi documentazione di HTML).

Esempio: [[http://moinmo.in/|MoinMoin Wiki|class=green dotted,accesskey=1]]

Viene reso come: MoinMoin Wiki

Premendo il tasto accessibile si dovrebbe essere portati all'obiettivo puntato dal collegamento (per Firefox 2.x e superiori, la combinazione di tasti è Alt-Maiusc-1).

Creare una stringa di interrogazione

Questo dipende da cosa è possibile fare col il sito puntato dall'obiettivo.

Esempio: [[MoinMoin:MoinMoinWiki|MoinMoin Wiki|&action=diff,&rev1=1,&rev2=2]]

Viene reso come: MoinMoin Wiki

Ricordarsi che:

se si vuole fornire una chiave=valore per la stringa di interrogazione, non dimenticarsi la e commerciale (&)
fornire una stringa di interrogazione non funziona se viene fornito un URL come obiettivo (ma per i collegamenti alle pagine o agli allegati)
se viene fornito un URL come obiettivo, è possibile includere una stringa di interrogazione in quell'obiettivo, senza la necessità di parametri
non è necessario codificare e quotare la stringa di interrogazione, moin lo fa automaticamente

Immagini

È possibile usare:

{{attachment:fileimmagine.png|testo descrittivo dell'immagine|width=100}}

affinché il file allegato fileimmagine.png sia visualizzato con una larghezza di 100px, l'altezza dell'immagine verrà ridimensionata proporzionalmente (se l'immagine era larga 200px e alta 400px, l'altezza diventerebbe di 200px in questo esempio). È anche possibile usare:

{{attachment:fileimmagine.png|testo descrittivo dell'immagine|height=100}}

affinché il file allegato sia visualizzato con un'altezza di 100px, la larghezza verrà ridimensionata proporzionalmente. Usare:

{{attachment:fileimmagine.png|testo descrittivo dell'immagine|width=100 height=150}}

affinché il file allegato sia visualizzato con una larghezza di 100px e un'altezza di 150px. Non omettere il testo descrittivo in entrambi i casi.

Questo non altera l'immagine allegata, fa solo in modo che il browser scali l'immagine al valore corrispondente fornito.

Miniature

È possibile usare l'inclusione con la sintassi per i collegamenti, portando alla visualizzazione di un'immagine di dimensioni ridotte collegata all'immagine originale:

[[attachment:fileimmagine.png|{{attachment:fileimmagine.png|testo descrittivo dell'immagine|width=100}}]]

Altre informazioni

Per maggiori informazioni sulle possibilità di utilizzo della marcatura, consultare AiutoSuModificaPagina. Per maggiori dettagli su come collegare le sotto-pagine, consultare AiutoSuModificaPagina/SottoPagine.

Esempi

Marcatura

 * http://moinmo.in/
 * [[http://moinmo.in/]]
 * [[http://moinmo.in/|Pagina iniziale di MoinMoin]]
 * InterWiki
  * Self:InterWiki
  * MeatBall:InterWiki
  * [[MeatBall:InterWiki|Pagine InterWiki su MeatBall]]
  * [[MoinMoin:Pagina con spazi]](non esiste)
 * email
  * user@example.com
  * mailto:user@example.com?subject=Prova
  * [[mailto:user@example.com?subject=Prova|Scrivimi]]
 * [[InterWiki|Pagine InterWiki in questo wiki]]
 * [[#nomeancora|Collegamento a un'ancora in questa pagina]]
 * [[AltraPagina#anchorname|Collegamento a un'ancora in un'altra pagina di questo wiki con un'etichetta]] (non esiste)
 * {{http://moinmo.in/moin_static/common/moinmoin.png}}
 * {{http://moinmo.in/moin_static/common/moinmoin.png|moinmoin logo}}

Diventano

Se si usava Moin da prima...

Ora è molto più facile:

Ora sono due parentesi quadre (per i collegamenti) o due parentesi graffe (per l'inclusione).
Per questo, le macro ora usano la sintassi <<NomeMacro(...)>>.
Usare le parentesi quadre o graffe se l'obiettivo ha degli spazi bianchi, basta con _ e %20!
Usare il carattere pipe (|) per separare l'obiettivo dal testo (e dai parametri)
wiki: non viene più usato, basta usare gli interwiki senza di esso.
inline è ora {{attachment:...}}.
I collegamenti interwiki ora usano solo NomeWiki:NomePagina (non: NomeWiki/NomePagina).
C'è meno magia dietro tutto e ora fa esattamente quello che dici:
- Il trattino basso (_) è un carattere normale e diverso dallo spazio bianco.
- Se ne vuoi fare uno, usalo e basta! Se vuoi uno spazio bianco, metti uno spazio bianco!
- Se crei un collegamento a un'immagine, si creerà un collegamento a un'immagine, non verrà mostrata o inclusa!
Per i nuovi utenti di Moin 1.6: non citate con le doppie virgolette, usate le doppie parentesi quadre/graffe.

Questa marcatura è ispirata dal quella del wiki creolo standard (ed è molto simile a quella di mediawiki).