version=pmwiki-2.1.6 ordered=1 urlencoded=1
agent=
author=chr
csum=
host=213.132.111.229
name=PmWiki.CustomInterMap
rev=30
targets=PmWiki.InterMap,PmWiki.WikiAdministrator,PmWiki.WikiFarms,PmWiki.Upgrades,Site.InterMap,PmWiki.DocumentationIndex
text=(:title Custom InterMap:)%0a%25audience%25 administrator (intermediate)%0aThis page describes PmWiki's default [[InterMap]] links, and how a [[wiki administrator]] can create additional InterMap links.%0a%0aAn intermap entry takes the following format:%0a%0a-> [@%0aMapPrefix:      http://www.somehost.com/partial/url/%0a@]%0a%0aPmWiki is distributed with the following InterMap entries in @@scripts/intermap.txt@@:%0a%0a-> [@%0aPmWiki:         http://www.pmwiki.org/wiki/PmWiki/%0aCookbook:       http://www.pmwiki.org/wiki/Cookbook/%0aWiki:           http://www.c2.com/cgi/wiki?%0aUseMod:         http://www.usemod.com/cgi-bin/wiki.pl?%0aMeatball:       http://www.usemod.com/cgi-bin/mb.pl?%0aWikipedia:      http://www.wikipedia.com/wiki/%0aPITS:           http://www.pmwiki.org/PITS/%0aPath:%0a@]%0a%0aYou can create your own InterMap links by doing one or more of the following:%0a%0a* Modify the page called [@Site.InterMap@] and place entries like the%0a  ones above in it.%0a* Create a file called @@local/localmap.txt@@ and place entries like the%0a  ones above in it.%0a* In a [[WikiFarm(s)]] installation you can create a file called%0a  @@local/farmmap.txt@@ and there place entries like the ones above in it.%0a  These prefixes will be common to all the wikis in the farm.%0a%0aDo not edit the file @@scripts/intermap.txt@@ directly!  If you do, you'll%0alose your changes when you [[PmWiki/upgrade(s)]] PmWiki.%0a%0a%0a!! Variables and InterMap Links%0a%0aIt's possible to use variables within your InterMap entries.  The following%0aentries create [@ThisWiki:@] and [@ThisPage:@] shortcuts:%0a%0a-> [@%0aThisWiki:        $ScriptUrl%0aThisPage:        {$PageUrl}%0a@]%0a%0aYou can also define InterMap entries where the text of the entry is%0asubstituted into the middle of the URL.  Just include '$1' in the URL where%0ayou want the substitution to take place.  For example:%0a%0a->[@Jargon:          http://www.catb.org/~esr/jargon/html/$1.html@]%0a%0awould cause [@Jargon:F/feature-creep@] to be converted to [@http://www.catb.org/~esr/jargon/html/F/feature-creep.html@].%0a%0a%0a!! Tips and tricks%0a%0aIt is possible to document your intermap prefixes directly in the page%0a[[Site.InterMap]]. The extra text will not cause a performance penalty, nor%0awill it break the definition of prefixes. However, be aware that anything%0amatching a line starting with a word and a colon (''':''') will be%0aconsidered to define a prefix.%0a%0aThe order in which various sources are checked for definitions of prefixes%0ais controlled by the variable $InterMapFiles. Currently the precedence%0a(highest to lowest is as follows):%0a* @@local/localmap.txt@@%0a* @@$SiteGroup.InterMap@@%0a* @@$FarmD/local/farmmap.txt@@%0a* @@$FarmD/scripts/intermap.txt@@%0a%0a%0a%25trail%25%3c%3c|[[Documentation Index]]|>>
time=1148848934
title=Custom InterMap
