## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnLinking
##master-date:2010-10-12T20:50:54Z
#acl -All:write Default
#format wiki
#language it
= Regole sui collegamenti =
<<TableOfContents>>
In !MoinMoin ci sono due tipi fondamentali di collegamenti:

 * Le parentesi quadre (`[[  ]]`) che sono utilizzate per creare un ''collegamento'' (a una pagina di wiki locale, una URL esterna, un file, etc).
 * Le parentesi graffe (`{{  }}`) che sono utilizzate per ''inglobare'' (trasformare/includere/mostrare) un oggetto (solitamente un'immagine, ma potrebbe anche essere del testo).

Gli obiettivi di destinazione sono molto versatili e supportano virtualmente ogni stile possibile con il normale HTML (percorsi relativi o assoluti, anchor, etc).

== Collegamenti ==
URL formattate correttamente (come {{{http://example.net}}}), pagine InterWiki, indirizzi email e nomi di pagina [[CamelCaseIt|CamelCase]] vengono riconosciuti automaticamente, anche senza parentesi quadre.
||<tablewidth="100%"rowbgcolor="#ffffcc"25%>'''Descrizione''' ||'''Sintassi''' ||'''Note''' ||
||collegamento interno ||`NomeWiki` ||Pagina con un nome [[CamelCaseIt|CamelCase]] ||
||collegamento interno libero ||`[[collegamento libero]]` ||Qualsiasi nome di pagina ||
||collegamento interno a una sotto pagina ||`/SottoPagina` o `[[/Sotto pagina]]` || ||
||collegamento interno a una pagina sorella ||`../PaginaSorella` o `[[../sorella|testo collegamento]]` || ||
||collegamento interno con testo ||`[[UnaPagina|una pagina]]` || ||
||collegamento interno ad una sezione ||`[[UnaPagina#sottosezione|sottosezione di Una Pagina]]` || consultare la sezione [[#Anchors]] più sotto ||
||collegamento interno con testo & parametri ||`[[UnaPagina|una pagina|target="_blank"]]` || consultare più sotto per i parametri di configurazione ||
||collegamento interno usando un'immagine come bottone ||`[[UnaPagina|{{attachment:imagefile.png}}]]` || ||
||collegamento interno usando un bottone grafico, apre in una nuova finestra ||`[[UnaPagina|{{attachment:samplegraphic.png}}|target="_blank"]]` || ||
||collegamento a un allegato ||`[[attachment:immagine.png]]` ||collega a un'immagine allegata ||
||collegamento a un allegato di un'altra pagina ||`[[attachment:UnaPagina/immagine.png]]` ||collega a un'immagine allegata in un'altra pagina ||
||collegamento interwiki ||`Altrowiki:UnaPagina` ||richiede il nome del wiki con la maiuscola ||
||collegamento interwiki libero ||`[[altrowiki:unapgina]]` ||funziona con qualsiasi nome del wiki nella mappa ||
||collegamento esterno ||`http://example.net/` || ||
||collegamento esterno con testo ||`[[http://example.net/|Sito di esempio]]` || ||
||collegamento esterno con test, apre in una nuova finestra ||`[[http://example.net/|Sito di esempio|target="_blank"]]` ||consultare più sotto per i parametri di configurazione ||
||collegamento esterno usando un'immagine come bottone ||`[[http://example.net/|{{attachment:samplegraphic.png}}]]` || ||
||collegamento esterno usando un bottone grafico, apre in una nuova finestra ||`[[http://example.net/|{{attachment:samplegraphic.png}}|target="_blank"]]` || ||
||collegamento 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 ||
||Collegamenti IBM / Lotus Notes ||`[[Notes://GunganCen/CA256992000B94BF/BC4B9A3C3F7C5458CA256A6C001A64F1/B0558F2B9DDB41C3CA25741900006827 | TA Branch Meeting]]` ||consultare la sotto pagina [[/CollegamentiNotes]] ||


== Inclusioni ==
Si utilizza l'Inclusione/Accorpamento quando si desidera includere un file esterno all'interno del wiki. Normalmente, questo è una immagine. Ma può trattarsi anche di un file di testo o qualsiasi altro file che il wiki sia in grado di comprendere compresi i vieo. Le opzioni aggiuntive possono essere combinate (per esempio, si possono inserire collegamenti per il download ''ed inoltre'' visualizzare il contenuto di quel file nella pagina!).


||<tablewidth="100%"rowbgcolor="#ffffcc"25%>'''Descrizione''' ||'''Sintassi''' ||'''Note''' ||
||includere un'immagine allegata ||`{{attachment:immagine.png}}` ||Mostra il file dell'immagine allegata `immagine.png` ||
||includere un'immagine allegata con un testo alternativo ||`{{attachment:immagine.png|testo}}` ||Mostra il file dell'immagine allegata `immagine.png` con un testo alternativo che visualizza `alt text` (utile per l'accessibilità) ||
||includere un'immagine allegata definendo l'allineamento ||`{{attachment:immagine.png|testo|align="position"}}` ||Mostra il file dell'immagine allegata `immagine.png` con un testo alternativo `alt text` e allineata alla ''posizione'' (può essere '''top''', '''middle''', '''bottom''', '''right''' oppure '''left''')  (non omettere il testo alternativo) ||
||includere un'immagine allegata ridimensionandola ||`{{attachment:immagine.png|alt text|width=100 height=150}}` ||Mostra il file dell'immagine allegata `immagine.png` con un testo alternativo che visualizza `alt text` e la ridimensiona a 100px di larghezza per 150px di altezza (non omettere il testo) ||
||includere un'immagine esterna ||`{{http://example.net/image.png}}` ||Mostra l'immagine inserita ||
||includere un'immagine esterna con un testo alternativo ||`{{http://example.net/image.png|alt text}}` ||Mostra l'immagine inserita con un testo alternativo che visualizza `alt text` (utile per l'accessibilità) ||
||includere un'immagine esterna definendo l'allineamento ||`{{http://example.net/image.png|alt text|align="position"}}` ||Mostra l'immagine inserita con un testo alternativo `alt text` e allineata alla ''posizione'' (può essere '''top''', '''middle''', '''bottom''', '''right''' oppure '''left''')  (non omettere il testo alternativo) ||
||includere un'immagine esterna ridimensionandola ||`{{http://example.net/image.png|alt text|width=100}}` ||Mostra l'immagine inserita con un testo alternativo `alt text` ridimensionandola a 100px di larghezza (non omettere il testo alternativo) ||


''Consultare anche gli esempi su AiutoSuImmagini''

== 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 HelpOnConfiguration).

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 (o doppie graffe) per inserire un collegamento ad una pagina o file con spazi nel nome. Questo funziona anche con i collegamenti interwiki, se il wiki di destinazione è in grado di comprendere la quotatura standard degli URL (gli spazi diventano {{{%20}}}).

Comunque è buona norma cercare di evitare gli spazi nelle URL, perchè in seguito si potrebbero scoprire ulteriori problemi. Per esempio, cercando di copiare e inviare tale URL tramite mail, il destinatario potrebbe avere problemi nell'accedere alla pagina specificata.

<<Anchor(Anchors)>>
=== Ancore ===
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.



=== Evitare che i collegamenti funzionino automaticamente ===

Per evitare che una parola tipo NomePagina divenga un collegamento automaticamente, 
si può sopprimere il collegamento [[CamelCaseIt|CamelCase]] inserendo un punto esclamativo ({{{!}}}) prima della parola, cioè `!NomePagina`. Questo metodo non influenzerà in maniera significativa le ricerche (con l'esclusione di alcune frasi ''quotate'' ed espressioni regolari).

In alternativa, si possono inserire due apici inversi {{{Nome``Pagina}}}. In questo caso però viene impedito che una semplice ricerca per la parola "!NomePagina" trovi {{{Nome``Pagina}}}, a causa dei caratteri inseriti.

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]]`).

Per esempio, un collegamento diretto al download si può ottenere con `param &do=get` `[[attachment:HelpOnImages/pineapple.jpg|un ananas|&do=get]]` [[attachment:HelpOnImages/pineapple.jpg|un ananas|&do=get]]

==== 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 per la URL obiettivo ====
Cosa è possibile fare dipende dal sito di destinazione.

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 funziona per i collegamenti alle pagine o agli allegati)
 * se viene fornito un URL come obiettivo, è possibile includere una stringa di interrogazione direttamente 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 insieme alla sintassi per i collegamenti, portando alla visualizzazione di un'immagine di dimensioni ridotte collegata all'immagine stessa alle dimensioni originarie:

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