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://www.somehost.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:
- Modify the page called
Site.InterMap
and place entries like the
ones above in it.
- Create a file called
local/localmap.txt
and place entries like the
ones above in it.
- In a WikiFarm installation you can create a file called
local/farmmap.txt
and there place entries like the ones above in it.
These prefixes will be common to all the wikis in the farm.
Do not edit the file
scripts/intermap.txt
directly! If you do, you'll
lose your changes when you
upgrade PmWiki.
Variables and InterMap Links
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://www.catb.org/~esr/jargon/html/$1.html
would cause
Jargon:F/feature-creep
to be converted to
http://www.catb.org/~esr/jargon/html/F/feature-creep.html
.
Tips and tricks
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):
<< Wiki Farms | Documentation Index | Custom markup >>