THE EARTH - Online Monthly Newspaper of the Ringing Cedars movement

Dec 22, 2024

Sign up for the e-mail issue

Ctrl+Enter

administrator (intermediate) This page describes PmWiki's default InterMap links, and how a wiki administrator can create additional InterMap links.

An intermap entry takes the following format:

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

PmWiki is distributed with the following InterMap 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 InterMap 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 PmWiki.

Variables and InterMap Links

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

ThisWiki:        $ScriptUrl
ThisPage:        {$PageUrl}

You can also define InterMap 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.InterMap
$FarmD/local/farmmap.txt
$FarmD/scripts/intermap.txt

<< Wiki Farms | Documentation Index | Custom markup >>

DISCLAIMER

The information contained in this mail is presented for educational purposes only. The information should not be considered complete, nor should it be relied on to suggest a course of treatment for a particular individual. Always consult with your physician, Doctor or other qualified health care provider before embarking on a new treatment, diet or fitness program. You should never disregard medical advice or delay in seeking it because of something you have read in this email. The information contained in this mail is compiled from a variety of sources ("Information Providers") and experiences. Neither this email nor Information Providers directly or indirectly practice medicine or dispense medical services, and so all information should be treated as thus. You hereby hold RingingCedarsofRussia.org, or ANY companies/individuals associated with RingingCedarsofrussia.org and it's affiliates NOT responsible for any injury that may occur either directly or indirectly by use or misuse of the information or ideas contained within.

The content of "The Earth - Online Newspaper" is copyrighted by http://www.ringingcedarsofrussia.org, and, occasionally, other rights holders. You may forward this Newsletter by e - mail an unlimited number of times, provided you do not alter the content in any way and that you include all applicable notices and disclaimers. You may print a single copy of each issue of E - News for your own personal, noncommercial use only, provided you include all applicable notices and disclaimers. Any other use of the content is strictly prohibited without the prior written permission of http://www.ringingcedarsofrussia.org, and any other applicable rights holders.