# Custom InterMap

An intermap entry takes the following format:

MapPrefix:      http://www.somehost.com/partial/url/


Pm Wiki is distributed with the following Inter Map 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 Inter Map 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 Pm Wiki.

## Variables and Inter Map Links

It's possible to use variables within your Inter Map entries. The following entries create ThisWiki: and ThisPage: shortcuts:

ThisWiki:        $ScriptUrl ThisPage: {$PageUrl}


You can also define Inter Map 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): • local/localmap.txt • $SiteGroup.Inter Map
• $FarmD/local/farmmap.txt • $FarmD/scripts/intermap.txt