## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnLinking
##master-date:2008-10-29 04:21:06
#acl -All:write Default
#format wiki
#language it

= 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 [[CamelCaseIt|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 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 ||

<<BR>>

||'''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 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://...}}}`.

== 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: [[http://moinmo.in/|MoinMoin Wiki|class=green dotted,accesskey=1]]

(!) 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:MoinMoinWiki|MoinMoin Wiki|&action=diff,&rev1=1,&rev2=2]]

(!) 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 ==
<<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).