version=pmwiki-2.2.0-beta52 ordered=1 urlencoded=1
agent=Mozilla/5.0 (X11; U; Linux i686 (x86_64); en-US; rv:1.8.1.2) Gecko/20061023 SUSE/2.0.0.2-1.1 Firefox/2.0.0.2
author=Pm
charset=ISO-8859-1
csum=cleanups
host=76.183.97.54
name=PmWiki.CustomInterMap
rev=41
targets=PmWiki.InterMap,PmWiki.WikiAdministrator,PmWiki.WikiFarms,PmWiki.Upgrades,Site.InterMap,PmWiki.DocumentationIndex
text=(:Summary:PmWiki's default InterMaplinks, and how to can create additional InterMap links:)%0a(: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://example.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 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* Ensure that there is a space after the colon%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://catb.org/~esr/jargon/html/$1.html@]%0a%0awould cause [@Jargon:F/feature-creep@] to be converted to [@http://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%25trail%25%3c%3c|[[Documentation Index]]|>>%0a%0a>>faq%3c%3c [[#faq]]%0a%0aQ: Are InterMap names case sensitive?%0a%0aA: Yes, thus [@eAdmin:@] is a different InterMap link than [@EAdmin:@].%0a%0aQ: How can I achieve a ''localmap.txt'' mapping with the effect of [@Pics: Path:/somepathto/pics/@]?%0a%0aA: Use the following:%0a->[@Pics:     /somepathto/pics/@]%0a%0a
time=1180216109
title=Custom InterMap
