This page describes an internal function in PmWiki's engine called LinkIMap(). The contents are not intended for those with a weak heart ;-)
Admins (advanced)
Also see: PmWiki.Functions#LinkIMap, PmWiki.MakeLink
- Syntax
-
LinkIMap($pagename,$imap,$path,$title,$text,$fmt=NULL)
The function LinkIMap() handles links of the form scheme:path, which
includes http:, https:, ftp: as well as the inter map links
such as Cookbook:, PmWiki: etc.
The basic markup behind the eventual invocations of this function is as follows:
[[ <target>"<title>" | <link-text> ]]
[[ <link-text> -> <target>"<title>" ]]
https://<URI>"<title>"
The arguments to the function are as follows:
$pagename — a string with the name of the page context in which the
link is created, this is typically simply the name of the current page.
For example, $pagename could be "Group.SomePage".
- $imap — a string denoting the scheme, i.e. the index into
$LinkFunctions. For example, $imap could be
"https:".
- $path — a string with the part of the target after the scheme
- $title — a string with the optional part after the target within
quotes
- $text — a string with the link text, from
MakeLink()
- $fmt — a string with the format string, from
MakeLink()
The array $IMap is the primary array used by LinkIMap(). It says how
to format a URL according to the given scheme. By default, this array is
generally set as follows:
$IMap['http:'] = 'http:$1';
$IMap['https:'] = 'https:$1';
$IMap['ftp:'] = 'ftp:$1';
$IMap['mailto:'] = 'mailto:$1';
...
$IMap['Cookbook:'] = 'https://www.pmwiki.org/wiki/Cookbook/$1';
$IMap['PmWiki:'] = 'https://www.pmwiki.org/wiki/PmWiki/$1';
$IMap['Wikipedia:'] = 'https://www.wikipedia.com/wiki/$1';
Note that the $1 in each case is used as a placeholder for the path
component.
LinkIMap() then uses the value of $UrlLinkFmt to generate the link.
Then there is also the array $IMapLinkFmt that allows each scheme to have
its own custom formatting default. The vanilla version of PmWiki doesn't use
this array yet, although some cookbook recipes probably do.
Examples of custom formats to allow different styling via classes:
- Links to http: standard url links:
$IMapLinkFmt['http:'] =
"<a class='httplink urllink' href='\$LinkUrl'>\$LinkText</a>";
- Links to https: secure pages:
$IMapLinkFmt['https:'] =
"<a class='httpslink urllink' href='\$LinkUrl'>\$LinkText</a>";
- Links to PmWiki: InterMap shortcut:
$IMapLinkFmt['PmWiki:'] =
"<a class='pmwikilink urllink' href='\$LinkUrl'>\$LinkText</a>";
- Links to Cookbook: InterMap shortcut
$IMapLinkFmt['Cookbook:'] =
"<a class='cookbooklink urllink' href='\$LinkUrl'>\$LinkText</a>";
Category: PmWiki Internals
