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.

Descrizione

Sintassi

Note

collegamento interno

NomeWiki

Pagina con un nome 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 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: <<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 "NomePagina" è 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 [[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]] 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: [[http://moinmo.in/|MoinMoin Wiki|class=green dotted,accesskey=1]]

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

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