## 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 ||
<
>
||'''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'': `<>`, 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 ===
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 ==
<>
{{{
* 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 '''`<>`'''.
* 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).