Regole sui collegamenti
- Gli obiettivi possono essere:
- Pagine locali
sia assoluti: il nome di una pagina o pagina principale/sotto pagina
che relativi: /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)
- Pagine locali
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 |
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]] |
|
Allegato |
[[attachment:un'immagine.png]] |
Collega a un'immagine |
Esterno |
http://example.net |
|
Esterno con testo |
[[http://example.net|Sito di esempio]] |
|
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 |
Un'immagine allegata |
{{attachment:un'immagine.png|testo|align="posizione"}} |
Mostra l'immagine, posizione può essere top, middle, bottom, right o left |
Un'immagine esterna |
{{http://example.net/image.png}} |
Mostra l'immagine |
Un'immagine esterna |
{{http://example.net/image.png|testo alternativo}} |
Mostra l'immagine con un testo alternativo |
Un'immagine esterna |
{{http://example.net/image.png|alt text|align="posizione"}} |
Mostra l'immagine, posizione può essere top, middle, bottom, right o left |
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://...}}}.
Altre informazioni
Per maggiori informazioni sulle possibilità di utilizzo della marcatura, consultare AiutoSuModificaPagina. Per maggiori dettagli su come collegare le sottopagine, 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
Collegamento a un'ancora in un'altra pagina di questo wiki con un'etichetta (non esiste)
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).