##master-page:HelpOnLinking ##master-date:2010-10-12T20:50:54Z #acl -All:write Default #format wiki #language it = Regole sui collegamenti = <> 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. ||'''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!). ||'''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. <> === Ancore === 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. === 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 ==== 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}}]] }}}