De kk2011

PmWiki: Custom InterMap

This page describes Pm Wiki's default InterMap links, and how a wiki administrator can create additional Inter Map links.

An intermap entry takes the following format:

MapPrefix:      http://example.com/partial/url/

The Inter Map entry can be for any of the link schemes supported by Pm Wiki.
You can create your own Inter Map links by doing one or more of the following:

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://catb.org/~esr/jargon/html/$1.html

would cause Jargon:F/feature-creep to be converted to http://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):

Pm Wiki Inter Maps?

The default intermap.txt distributed with Pm Wiki (in the scripts/ directory) includes the following Inter Map entries:

 Pm Wiki:     http://www.pmwiki.org/wiki/PmWiki/ 
 Cookbook:   http://www.pmwiki.org/wiki/Cookbook/ 
 Wiki:       http://www.c2.com/cgi/wiki? 
 Use Mod?:     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/ 
 Pm L10n?:     http://www.pmwiki.org/wiki/Localization/
 Path:

You can map your own prefixes in your local page Site.InterMap?.

Are Inter Map names case sensitive?

Yes, thus eAdmin: is a different Inter Map link than EAdmin:.

How can I achieve a localmap.txt mapping with the effect of Pics: Path:/somepathto/pics/?

Use the following:

Pics: /somepathto/pics/

How can I define an Inter Map in PHP?

Use the following:

      $LinkFunctions['PmWikiHome:'] = 'LinkIMap';
      $IMap['PmWikiHome:'] = 'http://pmwiki.org/wiki/$1';
Originįrio de http://kk2011.confabulando.org/index.php/PmWiki/CustomInterMap
Pagina modificada em 13 de July de 2009, ąs 23h06