• AiutoSuCollegamenti

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

Guida veloce

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

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 NomePagina 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 <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

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 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 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/

• Pagina iniziale di MoinMoin

• InterWiki

  • InterWiki

  • InterWiki

  • Pagine InterWiki su MeatBall

  • Pagina con spazi(non esiste)

• email

  • user@example.com

  • mailto:user@example.com?subject=Prova

  • Scrivimi

• Pagine InterWiki in questo wiki

• Collegamento a un'ancora in questa pagina

• Collegamento a un'ancora in un'altra pagina di questo wiki con un'etichetta (non esiste)

• 

• 

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 <<NomeMacro(...)>>.

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