PmWiki.CustomInterMap 3.0 KB

1234567891011
  1. version=pmwiki-2.1.6 ordered=1 urlencoded=1
  2. agent=
  3. author=chr
  4. csum=
  5. host=213.132.111.229
  6. name=PmWiki.CustomInterMap
  7. rev=30
  8. targets=PmWiki.InterMap,PmWiki.WikiAdministrator,PmWiki.WikiFarms,PmWiki.Upgrades,Site.InterMap,PmWiki.DocumentationIndex
  9. 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]]|>>
  10. time=1148848934
  11. title=Custom InterMap