Interwiki support

Description

InterWiki links

InterWiki is a way to specify links to other wiki w/o specifying cryptic url. Read more on this.

Note: As of 0.10, Trac has built-in support for InterWiki links.

InterWiki syntax specification

InterWiki links are defined as an extension to TracLinks syntax, using link type prefix:

link:wikiname:pagename

Here link tells that the InterWiki link is being defined, wikiname refers to external wiki name as defined in trac.ini (see configuration section below) and pagename refers to name of the wiki page on the linked wiki. Custom link titles like this one are also supported.

InterWiki configuration

In order for interwiki links to work, configuration need to be provided in trac.ini.

To configure interwiki links add [interwiki] section to the site's trac.ini file. Each setting under this section defines single interwiki entry where key specifies wiki name and value specifies base URL to prefix wiki page with.

Bugs/Feature Requests

Existing bugs and feature requests for InterWikiPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out the source for InterWikiPlugin from Subversion at http://trac-hacks.org/svn/interwikiplugin.

Example

Examples

link:c2:FooName -- refer to FooName page on c2 wiki

link:wikipedia:WikiWikiWeb -- refer to WikiWikiWeb page on wikipedia

[link:wikipedia:WikiWikiWeb about wiki] -- refer to WikiWikiWeb page on wikipedia with different link text

Configuration Example

c2=http://c2.com/cgi/wiki?
WikiPedia=http://en.wikipedia.org/wiki/

Tests

Given the following configuration of the InterWiki module:

wiki=http://c2.com/cgi/wiki?
WikiPedia=http://en.wikipedia.org/wiki/

next sentences must hold true:

Text link:wiki:Foo renders as wiki:Foo.
Text link:WIKI:Foo renders as WIKI:Foo (note that wiki lookup is case insensitive but case is preserved on link text).
Text [link:wiki:page title text] renders as wiki:title text.
Text link:wikipedia:Wiki renders as wikipedia:Wiki.
Text link:wikipudia:Wiki renders as is (unknown wiki ref wikipudia).
Text link:wikipedia renders as is (no page specified).

Author/Contributors

Author: akhavr
Contributors: