netfrag.org . TWiki . InterwikiPlugin

netfrag.org . TWiki . InterwikiPlugin

InterwikiPlugin

The InterwikiPlugin 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, http://www.usemod.com/cgi-bin/wiki.pl?InterWiki .

Syntax Rules

Write ExternalSite:Page to create automatically a link that points to the Page on the ExternalSite server.
All ExternalSite aliases are defined in the InterWikis topic.
To add new aliases just follows the instructions in InterWikis.

InterwikiPlugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %INTERWIKIPLUGIN_SHORTDESCRIPTION%

One line description, is 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: (0 or 1, default is 0)
- Set SUPPRESSTOOLTIP = 0

Debug plugin: (See output in data/debug.txt)
- Set DEBUG = 0

Plugin Installation Instructions

Note: This plugin is pre-installed 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 Plugin web (see below)

Unzip InterwikiPlugin.zip in your twiki installation directory. Content:

File:	Description:
`data/TWiki/InterwikiPlugin.txt`	Plugin topic
`data/TWiki/InterWikis.txt`	Link rules topic for inter-site links
`lib/TWiki/Plugins/InterwikiPlugin.pm`	Plugin Perl module

Test if the plugin is correctly installed: Wiki:InterWiki should point to Wiki's http://c2.com/cgi/wiki?InterWiki topic.

Plugin Info

Plugin Author:	AndreaSterbini, 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 tool tips 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/InterwikiPlugin (TWiki:Plugins/InterwikiPlugin)
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginDev (TWiki:Plugins/InterwikiPluginDev)

Related Topics: InterWikis, TWikiPreferences, TWikiPlugins

-- AndreaSterbini - 20 Oct 2000
-- PeterThoeny - 27 Jul 2001

----- Revision r1.1 - 27 Jul 2001 - 06:43 - PeterThoeny^?