netfrag.org > TWiki > InterwikiPlugin ( vs. r1.2)
TWiki . { Home? | Welcome | Register | Changes | Index | Search | Go }

 <<O>>  Difference Topic InterwikiPlugin (r1.2 - 02 Oct 2001 - MikeMannix?)

 <<O>>  Difference Topic InterwikiPlugin (r1.1 - 27 Jul 2001 - PeterThoeny?)
Line: 1 to 1
Added:
>
>

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


Topic InterwikiPlugin . { View | Diffs | r1.2 | > | r1.1 | More }    output as: { }
Revision -
Revision r1.2 - 02 Oct 2001 - 06:35 - MikeMannix?