= Interwiki support =

== Description ==

= !InterWiki links =

!InterWiki is a way to specify links to other wiki w/o specifying cryptic url.  [http://moinmoin.wikiwikiweb.de/InterWiki 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 [wiki:TracLinks 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 
[report:9?COMPONENT=InterWikiPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=InterWikiPlugin&owner=akhavr new ticket].

== Download ==

Download the zipped source from [download:interwikiplugin 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:

{{{
#!html
Text <code>link:wiki:Foo</code> renders as 
<a class="ext-link" href="http://c2.com/cgi/wiki?Foo"><span class="icon"></span>wiki:Foo</a>.<br/>
Text <code>link:WIKI:Foo</code> renders as 
<a class="ext-link" href="http://c2.com/cgi/wiki?Foo"><span class="icon"></span>WIKI:Foo</a> (note that wiki lookup is case insensitive but case is preserved on link text).<br/>
Text <code>[link:wiki:page title text]</code> renders as <a class="ext-link" href="http://c2.com/cgi/wiki?page"><span class="icon"></span>wiki:title text</a>.<br/>
Text <code>link:wikipedia:Wiki</code> renders as 
<a class="ext-link" href="http://en.wikipedia.org/wiki/Wiki"><span class="icon"></span>wikipedia:Wiki</a>.<br/>
Text <code>link:wikipudia:Wiki</code> renders as is (unknown wiki ref wikipudia).<br/>
Text <code>link:wikipedia</code> renders as is (no page specified).<br/>
}}}


== Author/Contributors ==

'''Author:''' [wiki:akhavr] [[BR]]
'''Contributors:'''

[[TagIt(plugin,akhavr,0.9)]]