1 rizwank 1.1 %META:TOPICINFO{author="PeterThoeny" date="1093419603" format="1.0" version="1.8"}%
 2             ---+!! Interwiki Plugin
 3             
 4             The <nop>%TOPIC% links ==ExternalSite:Page== text to external sites based on aliases defined in the %TWIKIWEB%.InterWikis topic. This plugin is inspired by <nop>UseMod Wiki's inter-wiki links, http://www.usemod.com/cgi-bin/wiki.pl?InterWiki.
 5             
 6             %TOC%
 7             
 8             ---++ Syntax Rules
 9             
10             	* Enter ==ExternalSite:Page== to create a link that points to the ==Page== on the ==ExternalSite== server.
11             	* All ==ExternalSite== aliases are defined in the %TWIKIWEB%.InterWikis topic.
12             	* Add and edit aliases in %TWIKIWEB%.InterWikis.
13             	* %H% For TWiki sites, both the *web* and the *topic* have to be specified: ==<nop>TWikisite:Webname/<nop>SomePage==
14             		* TWiki:Plugins/InterwikiPlugin or TWiki:Plugins.InterwikiPlugin
15             
16             ---++ <nop>%TOPIC% Settings
17             
18             Plugin settings are stored as Preferences variables. To reference
19             a plugin setting write ==%<nop>&lt;plugin&gt;_&lt;setting&gt;%==, for example, ==%<nop>INTERWIKIPLUGIN_SHORTDESCRIPTION%==
20             
21             	* One-line description, shown in the %TWIKIWEB%.TextFormattingRules topic:
22 rizwank 1.1 		* Set SHORTDESCRIPTION = Link ==ExternalSite:Page== text to external sites based on aliases defined in the %WEB%.InterWikis topic
23             
24             	* Link rules topic name: (default is %TWIKIWEB%.InterWikis)
25             		* Set RULESTOPIC = 
26             
27             	* Suppress tooltip help for links: (==0== or ==1==, default is ==0==)
28             		* Set SUPPRESSTOOLTIP = 0
29             
30             	* Debug plugin: (See output in =data/debug.txt=)
31             		* Set DEBUG = 0
32             
33             ---++ Plugin Installation Instructions
34             
35             %X% *NOTE:* This Plugin is included in the TWiki distribution package. You do not need to install it unless you want to upgrade to a newer version.
36             
37             	* *Download* the ZIP file from the TWiki:Plugins web (see below)
38             	* *Unzip* ==%TOPIC%.zip== in your TWiki installation directory. Content:
39             	  | *File:* | *Description:* |
40             	  | ==data/TWiki/%TOPIC%.txt== | Plugin topic |
41             	  | ==data/TWiki/InterWikis.txt== | Link rules topic for inter-site links |
42             	  | ==lib/TWiki/Plugins/%TOPIC%.pm== | Plugin Perl module |
43 rizwank 1.1 	* *Test:* If the Plugin is correctly installed, this Wiki:InterWiki link should point to http://c2.com/cgi/wiki?InterWiki topic - try it out.
44             
45             ---++ Plugin Info
46             
47             |  Plugin Author: | TWiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny |
48             |  Plugin Version: | 25 Aug 2004, 1.005 |
49             |  Change History: | <!-- versions below in reverse order -->&nbsp; |
50             |  25 Aug 2004: | Updated InterWikis link rules (no code change) |
51             |  09 Mar 2004: | Internal changes: Use only official TWiki::Func Plugin API; for increased speed, moved Interwiki link handling from outsidePREHandler to startRenderingHandler |
52             |  16 Feb 2004: | Support =[<nop>[Site:Page][label]]= Interwiki links (PTh); use TWiki::Func interface for I18N regular expressions (Walter Mundt) |
53             |  18 Jan 2003: | Allow number sign =#= in Page name (PTh) |
54             |  31 Aug 2002: | Allow percent sign =%= in page name (PTh) |
55             |  27 Jul 2001: | Allow numbers =0-9= in site name |
56             |  26 Jul 2001: | Fixed alternating missed link bug due to greedy $postfixPattern (fix by Richard Donkin) |
57             |  14 Jul 2001: | Changed to plug & play |
58             |  16 Jun 2001: | Made tooltips optional; prevent ==Module::Sub== type of link |
59             |  12 Jun 2001: | Added optional tool tips (IE only); added the link rules topic name variable; added flexible link patterns; optional ==$page== in URL |
60             |  10 Jun 2001: | Changed rules topic to table-based syntax |
61             |  20 Feb 2001: | Initial version |
62             |  CPAN Dependencies: | none |
63             |  Other Dependencies: | none |
64 rizwank 1.1 |  Perl Version: | 5.0 |
65             |  Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% (TWiki:Plugins/%TOPIC%) |
66             |  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev (TWiki:Plugins/%TOPIC%Dev) |
67             
68             __Related Topics:__ %TWIKIWEB%.InterWikis, %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins
69             
70             -- TWiki:Main.AndreaSterbini - 20 Oct 2000 <br />
71             -- TWiki:Main.MikeMannix - 01 Oct 2001 <br />	
72             -- TWiki:Main.PeterThoeny - 25 Aug 2004 <br />
73