Un’importante caratteristica dei Wiki Wiki Web è la facilità di creare collegamenti (anche detti “link” o “hyperlink”) nel testo di un documento. PmWiki mette a disposizione più meccanismi per inserirli.
Per creare un link a un’altra pagina, bisogna scrivere il nome di tale pagina tra doppie parentesi quadre. Esempi: [[wiki sandbox]]
o [[installation]]
diventano rispettivamente wiki sandbox? e installation?.
PmWiki crea un link usando il testo che si trova tra le doppie parentesi. Lo spazio tra le parole viene rimosso, e ciascuna parola dopo uno spazio o un segno di interpunzione (ad es. ~) viene scritta con la lettera maiuscola. Perciò [[Wiki sandbox]]
, [[wiki sandbox]]
e [[WikiSandbox]]
appaiono in maniera diversa, ma tutti creano un link alla pagina WikiSandbox.
In altre parole, PmWiki considera la pagina di destinazione mettendo opportunamente le lettere maiuscole; il testo del link, invece, viene deciso dall’utente.
Ai link si può aggiungere un suffisso, che diventerà parte del testo visualizzato, ma non dell’indirizzo di destinazione. Questa funzione è molto utilizzata per le pagine in Inglese; per esempio, [[wiki sandbox]]es
è un link a WikiSandbox ma appare così: wiki sandboxes?.
Se alcune parti del testo di un link vengono messe tra parentesi tonde, PmWiki le nasconde. Per esempio: [[(wiki) sandbox]]
è un collegamento a WikiSandbox e appare così: sandbox?.
In alternativa, è possibile specificare il testo di un link utilizzando una barra verticale; per esempio, [[WikiSandbox | un posto per fare prove]]
è un link a WikiSandbox e appare così: un posto per fare prove?. Si può anche usare una freccia (->
) per invertire l’ordine di testo e destinazione del collegamento; per esempio: [[un posto per fare prove -> WikiSandbox]]
diventa un posto per fare prove?.
Alcuni siti trattano anche le WikiWord come collegamenti: una parola formata da una serie di parole unite, ciascuna delle quali inizia con la lettera maiuscola, viene automaticamente trattata come un link ad una pagina con lo stesso nome.
I caratteri speciali non dovrebbero essere mai usati nei titoli delle pagine: PmWiki non ha problemi a gestirli, ma altri utenti, magari di altre lingue, potrebbero non visualizzarli correttamente. Il charset più problematico da questo punto di vista sembra essere l’UTF-8. È buona norma, dunque, utilizzare nei nomi delle pagine soltanto caratteri ASCII, cioè appartenenti all’alfabeto inglese, senza lettere accentate. Dopodiché, a ciascuna pagina si può dare un titolo qualunque attraverso la direttiva (:title <titolo>:); per quest’ultimo titolo non valgono le limitazioni appena descritte. In questo caso, il consiglio che segue è molto utile.
[[NomePagina|+]]
crea un link a NomePagina utilizzando come testo il titolo di tale pagina. Per esempio: [[PmWikiIt/Links|+]] appare Links? perché all’interno di questa pagina è presente la direttiva: (:title Collegamenti:).
[[NomePagina|#]]
crea un link al riferimento come mostrato qui sottoLink numerati.
Per definire all’interno di una pagina un punto al quale sia possibile collegarsi direttamente, bisogna usare il markup [[#nome]]
. Questo nome, che deve iniziare con una lettera, definisce un “riferimento” che identifica il punto dove si trova nella pagina. Per collegarsi direttamente a quel punto:
[[#nome|testo del link]]
se la destinazione si trova nella stessa pagina, oppure
[[NomePagina#nome]]
o [[NomePagina#nome|testo del link]]
se la destinazione è in un’altra pagina.
[[NomePagina(#nome)]]
può essere utile per nascondere il link al riferimento, mostrando solo il nome della pagina.
Per esempio, questo è un link alla sezione Intermaps di questa pagina.
Note:
[[#robots]]
”; questo link: [[#Robots | Robots]]
funziona con Internet Explorer, ma non con Firefox: Robots.
[[#il mio riferimento]]
” non funziona. “[[#ilmioriferimento]]
” funziona.
I link ad altri siti vengono riconosciuti a partire dal prefisso: ‘http:’, ‘ftp:’, ecc. Perciò http://google.com/
e [[http://google.com/]]
sono entrambi link a Google. Come detto sopra, è possibile specificare il testo dei collegamenti usando la barra verticale oppure la freccia; esempi: [[http://google.com/ | Google]]
e [[Google -> http://google.com]]
.
Se nel link sono presenti parentesi tonde, queste vanno sostituite con codici numerici: ( al posto della parentesi aperta ‘(’ e ) al posto di quella chiusa ‘)’.
Per inserire link a file locali bisogna utilizzare il prefosso 'file:///'
(questo, per lo meno, funziona con Internet Explorer). Perciò: file:///S:\ProjPlan.mpp
e [[Unità condivisa S->file:///S:\]]
sono entrambi link validi. Su sistemi Windows, si possono anche utilizzare percorsi di rete, come \\server1\rootdirectory\subdirectory — questi sono da preferire alle lettere di unità, perché sono sicuramente validi per tutti gli utenti della rete.
I collegamenti possono anche essere specificati sotto forma di riferimenti, per associare a ciascun collegamento un numero anziché un testo. Il testo che segue è un esempio di come funziona questo meccanismo:
Il link [[http://google.com |#]]
viene visualizzato così: [1].
Agli ulteriori collegamenti numerati verrà associato un numero diverso: [[http://pmwiki.com |#]]
diventa [2], [[#intermaps |#]]
diventa intermaps not found e così via. Nota bene: un secondo collegamento alla stessa destinazione non viene riconosciuto come tale, ma viene associato a un numero diverso; per esempio: [[http://google.com |#]]
, inserito di nuovo qui, viene visualizzato così: [3].
Per far sì che un collegamento venga aperto in una nuova finestra del browser, bisogna usare la direttiva %newwin%
:
%newwin% http://pmichaud.com
diventa http://pmichaud.com
%newwin% [[http://google.com/ | Google]]
diventa Google
%newwin% Main.WikiSandbox
diventa Main.WikiSandbox
In alternativa, si può usare l’attributo target
dei collegamenti:
%target=_blank% Tutti i link su questa linea, come http://pmichaud.com saranno mostrati in una nuova finestra. | Tutti i link su questa linea, come http://pmichaud.com saranno mostrati in una nuova finestra. |
Quando un link è preceduto da %rel=nofollow%, allora esso non viene controllato da robot e sistemi di controllo dei collegamenti.
PmWiki associa automaticamente classi CSS a tipi di link diversi. Questo permette, ad esempio, di cambiare la formattazione di link differenti.
Note: Questa lista potrebbe essere incompleta.
Si può usare il markup mailto:
. Esempi:
* mailto:myaddress@example.com * [[mailto:myaddress@example.com]] * [[mailto:myaddress@example.com | email me]] * [[mailto:myaddress@example.com?subject=Oggetto del messaggio&body=Testo del messaggio | scrivimi]] |