(:Summary:PmWiki's default InterMaplinks, and how to can create additional InterMap links:)
%audience% administrator (intermediate)
This page describes PmWiki's default InterMap links, and how a wiki administrator can create additional InterMap links.
An intermap entry takes the following format:
->
MapPrefix: http://example.com/partial/url/
PmWiki is distributed with the following InterMap entries in scripts/intermap.txt
:
->
PmWiki: http://www.pmwiki.org/wiki/PmWiki/ Cookbook: http://www.pmwiki.org/wiki/Cookbook/ Wiki: http://www.c2.com/cgi/wiki? UseMod: http://www.usemod.com/cgi-bin/wiki.pl? Meatball: http://www.usemod.com/cgi-bin/mb.pl? Wikipedia: http://www.wikipedia.com/wiki/ PITS: http://www.pmwiki.org/PITS/ Path:
You can create your own InterMap links by doing one or more of the following:
Do not edit the file scripts/intermap.txt directly! If you do, you'll
lose your changes when you upgrade PmWiki.
It's possible to use variables within your InterMap entries. The following
entries create ThisWiki:
and ThisPage:
shortcuts:
->
ThisWiki: $ScriptUrl ThisPage: {$PageUrl}
You can also define InterMap entries where the text of the entry is
substituted into the middle of the URL. Just include '$1' in the URL where
you want the substitution to take place. For example:
->Jargon: http://catb.org/~esr/jargon/html/$1.html
would cause Jargon:F/feature-creep
to be converted to http://catb.org/~esr/jargon/html/F/feature-creep.html
.
It is possible to document your intermap prefixes directly in the page
Site.InterMap. The extra text will not cause a performance penalty, nor
will it break the definition of prefixes. However, be aware that anything
matching a line starting with a word and a colon (:) will be
considered to define a prefix.
The order in which various sources are checked for definitions of prefixes
is controlled by the variable $InterMapFiles. Currently the precedence
(highest to lowest is as follows):
%trail%<<|Documentation Index|>>
Q: Are InterMap names case sensitive?
A: Yes, thus eAdmin:
is a different InterMap link than EAdmin:
.
Q: How can I achieve a localmap.txt mapping with the effect of Pics: Path:/somepathto/pics/
?
A: Use the following:
->Pics: /somepathto/pics/