## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnLinking
##master-date:2007-12-22 23:03:05
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language it
= 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`''')
* 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 Nome``Wiki ||
||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 Wiki: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 [[AiutoSuMacro|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 "Nome``Pagina" è 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 Nome``Pagina 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 ==
<<Anchor(#nomeancora)>>
{{{
* 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 ==
* 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}}
== 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).