# %TOPIC% The %TOPIC% links **ExternalSite:Page** text to external sites based on aliases defined in the [[InterWikis]] topic. This plugin is inspired by UseMod Wiki's inter-wiki links, .
## Syntax Rules - Enter **ExternalSite:Page** to create a link that points to the **Page** on the **ExternalSite** server. - All **ExternalSite** aliases are defined in the [[InterWikis]] topic. - Add and edit aliases in [[InterWikis]]. - %H% For TWiki sites, both the **web** and the **topic** have to be specified: **TWikisite:Webname/SomePage** - TWiki:Plugins/InterwikiPlugin ## %TOPIC% Settings Plugin settings are stored as Preferences variables. To reference a plugin setting write **%<plugin>\_<setting>%**, for example, **%INTERWIKIPLUGIN\_SHORTDESCRIPTION%** - One-line description, shown in the [[TextFormattingRules]] topic: - Set SHORTDESCRIPTION = Link **ExternalSite:Page** text to external sites based on aliases defined in the [[InterWikis]] topic. - Link rules topic name: (default is [[InterWikis]]) - Set RULESTOPIC = - Suppress tooltip help for links: (**** or **1**, default is ****) - Set SUPPRESSTOOLTIP = 0 - Debug plugin: (See output in `data/debug.txt`) - Set DEBUG = 0 ## Plugin Installation Instructions %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. - **Download** the ZIP file from the TWiki:Plugins web (see below) - **Unzip** **%TOPIC%.zip** in your TWiki installation directory. Content:
File: Description:
data/TWiki/%TOPIC%.txt Plugin topic
data/TWiki/InterWikis.txt Link rules topic for inter-site links
lib/TWiki/Plugins/%TOPIC%.pm Plugin Perl module
- **Test:** If the Plugin is correctly installed, this Wiki:InterWiki link should point to topic - try it out. ## Plugin Info
Plugin Author: [[TWiki/AndreaSterbini]], [[TWiki/PeterThoeny]]
Plugin Version: 1.0.2
Change History: 27 Jul 2001 Allow numbers in site name
26 Jul 2001 Fixed alternating missed link bug due to greedy $postfixPattern (fix by Richard Donkin)
14 Jul 2001 Changed to plug & play
16 Jun 2001: Made tooltips optional; prevent Module::Sub type of link
12 Jun 2001: Added optional tool tips (IE only); added the link rules topic name variable; added flexible link patterns; optional $page in URL
10 Jun 2001: Changed rules topic to table-based syntax
20 Feb 2001: Initial version
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.0
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% (TWiki:Plugins/%TOPIC%)
Feedback: http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev (TWiki:Plugins/%TOPIC%Dev)
**_Related Topics:_** [[InterWikis]], [[TWikiPreferences]], [[TWikiPlugins]] -- [[AndreaSterbini]] - 20 Oct 2000
-- [[PeterThoeny]] - 27 Jul 2001
-- [[MikeMannix]] - 01 Oct 2001