Codex

autori (base)

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.

Collegamenti ad altre pagine del wiki

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.

Scorciatoie

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.

Collegamenti a punti specifici di altre pagine

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.
  • La forma [[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:

  • il nome del riferimento deve iniziare con una lettera, non un numero
  • il collegamento ad un punto deve utilizzare le stesse maiuscole e minuscole del riferimento. I collegamenti in Internet Explorer potrebbero funzionare indipendentemente dalle maiuscole, ma in Firefox no. Per esempio, questa pagina ha un riferimento che si chiama "[[#robots]]"; questo link: [[#Robots | Robots]] funziona con Internet Explorer, ma non con Firefox: Robots.
  • Non si devono inserire spazi nel nome di un riferimento. "[[#il mio riferimento]]" non funziona. "[[#ilmioriferimento]]" funziona.

Collegamenti a pagine esterne al wiki

Link a siti esterni (URLs)

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: &#40; al posto della parentesi aperta '(' e &#41; al posto di quella chiusa ')'.

Link a siti locali o su intranet

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.

Caratteristiche dei collegamenti

Link numerati

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

Intermap

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.

Link a pagine in altri wiki group

Ved. Wiki Group.

Link che aprono una nuova finestra

Per far sì che un collegamento venga aperto in una nuova finestra del browser, bisogna usare la direttiva %newwin%:

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.

Link che non vengono seguiti dai robot

Quando un link è preceduto da %rel=nofollow%, allora esso non viene controllato da robot e sistemi di controllo dei collegamenti.

Links e classi CSS

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.

.selflink
Un link alla pagina corrente. È utile nelle barre laterali, per segnalare "voi siete qui".
.wikilink
Un link a una pagina interna al wiki.
.urllink
Un link a una pagina esterna al wiki.

È 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')");

Note

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:

Come faccio a creare un link che si apra in una nuova finestra?

Usa lo stile %newwin%. Esempio:

%newwin%http://example.com/

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?

Vedi Cookbook:Add Url schemes

Come posso collegare una pagina esterna a una WikiWord, anziché una pagina dello stesso sito?

Usa il markup. Ci sono due modi possibili:

Come posso trovare tutte le pagine che si collegano a una pagina data (backlinks)?

Usa l'opzione link= della direttiva (:pagelist:). Esempi:

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?

Vedi Cookbook:External links

Come si fa per utilizzare un'immagine come un link?

Vedi Images#links


Traduzione di PmWiki.Links - Pagina originale: PmWikiIt.Links - Links de retorno
Ultime modifiche:
PmWikiIt.Links: 10 de setembro de 2011, às 12:52
PmWiki.Links: 21 de fevereiro de 2016, às 06:00