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 CamelCase vengono riconosciuti automaticamente, anche senza parentesi quadre.

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

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 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 macro Anchor: ``, dove "nomeanchor" è l'identificativo dell'ancora.

Per collegare un'ancora nella stessa pagina wiki, usare `#nomeancora` o `testo`.

Per collegare un'ancora in un'altra pagina wiki, usare `NomePagina#nomeancora` o `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 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 `testo`).

Per esempio, un collegamento diretto al download si può ottenere con `param &do=get` `un ananas` un ananas

Impostare gli attributi del tag <a>

Attributi disponibili: class, title, target, accesskey (per un loro significato, consultare una qualsiasi documentazione di HTML).

Esempio: `MoinMoin Wiki`

Viene reso come: MoinMoin Wiki

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 Wiki`

Viene reso come: MoinMoin Wiki

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}}]]