InterMap提供了一个让你快速的创建站外wiki链接功能,可以方便的输入其它wiki链接。自定义新的链接规则,请使用wiki名:wiki路径
的格式,编辑“intermap.txt” 和“localmap.txt”文件。
这是默认的 intermap.txt
默认的“intermap.txt”文件在“scripts/”文件夹里,下面是一个精简过的,将维基百科替换为中文版,剔除对中文用户无用链接。在实际使用中PITS和PmL10n也是可以考虑删除的内容,此处演示不做处理。演示:
PmWiki: http://www.pmwiki.org/wiki/PmWiki/ Cookbook: http://www.pmwiki.org/wiki/Cookbook/ Wiki: http://www.c2.com/cgi/wiki? Wikipedia: http://en.wikipedia.org/wiki/ PITS: http://www.pmwiki.org/wiki/PITS/ PmL10n: http://www.pmwiki.org/wiki/Localization/ Path:
Thus, "PmWiki:Variables" becomes "http://www.pmwiki.org/wiki/PmWiki/" + "Variables," a link to the PmWiki.Variables page on the official PmWiki web site, Wiki:FrontPage is a link to the front page of the first WikiWikiWeb, and Wikipedia:Stonehenge takes you to the Wikipedia article about the famous megaliths in England.
使用方法
你可以通过在双方括号的方式增加一个链接:
* [[Meatball:StartingPoints | starting points]] over at Meatball * [[starting points -> Meatball:StartingPoints]] over at Meatball |
|
If you want to link just to what the intermap says (e.g. http://www.wikipedia.com/wiki/ for Wikipedia), then do [[Wikipedia:. | Wikipedia's main page]]
, which produces Wikipedia's main page. Note the . (period) after the Map: reference.
The special Path:
InterMap entry can be used to create "relative urls" in links.
Custom IneterMap prefixes
The actual set of InterMap links at any site is defined by the site administrator via the Site.InterMap? page and the local/localmap.txt file.
An intermap entry takes the following format:
MapPrefix: http://example.com/partial/url/
The InterMap entry can be for any of the link schemes supported by PmWiki.
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.
- Ensure that there is a space after the colon.
注意:不建议直接编辑scripts/intermap.txt文件,如果你编辑过,别忘了升级时备份还原。
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://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
.
小贴士
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