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 Collegamenti perché all'interno di questa pagina è presente la direttiva: (:title Collegamenti:).
[[NomePagina|#]] crea un link al riferimento come mostrato qui sotto[1].
[[!NomePagina]] crea un link a NomePagina nel gruppo chiamato Category. Vedi Categories.
[[~Author]] crea un link alla pagina chiamata Author nel gruppo Profiles. PmWiki genera automaticamente questo link per l'autore corrente quando incontra tre tildi (~) di seguito (~~~). Se si aggiunge una quarta tilde, allora vengono aggiunte anche la data e l'ora della modifica.
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ì: [2].
Agli ulteriori collegamenti numerati verrà associato un numero diverso: [[http://pmwiki.com |#]] diventa [3], [[#intermaps |#]] diventa [4] 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ì: [5].
PmWiki supporta anche collegamenti Inter Map. In particolare, è possibile usare il markup Path: per creare collegamenti a path relativi o assoluti sul sito corrente. Per esempio: Path:../../somedir/foo.html or Path:/dir/something.gif.
Ved. Wiki Group.
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.
È possibile creare la classe .anchor per i link a riferimenti[[#target]], aka <A name='target'></A>
inserendo queste righe nel file config.php :
Markup('[[#','<[[','/(?>\\[\\[#([A-Za-z][-.:\\w]*))\\]\\]/e',
"Keep(TrackAnchors('$1') ? '' : \"<a name='$1' id='$1' class='anchor'></a>\", 'L')");
Nota: Il comportamento di "+" visto sopra può essere alterato in modo da mostrare il titolo con spazi, piuttosto che senza; per fare ciò bisogna aggiungere le seguenti righe al file config.php:
## [[target |+]] title links
Markup('[[|+', '<[[|',
"/(?>\\[\\[([^|\\]]+))\\|\\s*\\+\\s*]]/e",
"Keep(MakeLink(\$pagename, PSS('$1'),
PageVar(MakePageName(\$pagename,PSS('$1')), '\$Titlespaced')
),'L')");
Come faccio a creare un link che si apra in una nuova finestra?
Usa lo stile %newwin%. Esempio:
%newwin%http://example.com/ |
Come faccio a creare un link che si apra in una nuova finestra, configurando quest'ultima?
Per questo è necessario Javascript. Vedi Cookbook:PopupWindow.
Come posso inserire un collegamento a un indirizzo e-mail?
Usa il markup mailto:. Esempi:
* mailto:[email protected] * [[mailto:[email protected]]] * [[mailto:[email protected] | email me]] * [[mailto:[email protected]?subject=Oggetto del messaggio&body=Testo del messaggio | scrivimi]] |
Vedere anche Cookbook:EProtect o Cookbook:ProtectEmail per informazioni su come proteggere gli indirizzi e-mail dagli spammer.
Come faccio ad abilitare link ad altri protocolli, come nntp:, ssh:, xmpp:, etc?
Come posso collegare una pagina esterna a una WikiWord, anziché una pagina dello stesso sito?
Usa il markup. Ci sono due modi possibili:
[[http://example.com/ | WikiWord]] [[WikiWord -> http://example.com/]]
Come posso trovare tutte le pagine che si collegano a una pagina data (backlinks)?
Usa l'opzione link= della direttiva (:pagelist:). Esempi:
(:pagelist link=PaginaQualunque list=all:) -- mostra tutti i link a PaginaQualunque
(:pagelist link={$FullName} list=all:) -- mostra tutti i link alla pagina corrente
Che tipi di link sono supportati da PmWiki?
Vedi Link schemes Link schemes supported by PmWiki
Come posso far sì che tutti i link a siti esterni si aprano in una nuova finestra, oppure siano indicati con un'icona?
Come si fa per utilizzare un'immagine come un link?
Vedi Images#links
Traduzione di PmWiki.Links -
Pagina originale: PmWikiIt.Links -
Backlinks
Ultime modifiche:
PmWikiIt.Links: September 10, 2011, at 03:52 PM
PmWiki.Links: November 06, 2019, at 09:22 AM