Interwiki Plugin
The InterwikiPlugin linksExternalSite:Page text to external sites based on aliases defined in the Inter Wikis topic. This plugin is inspired by UseMod Wiki's inter-wiki links, http://www.usemod.com/cgi-bin/wiki.pl?InterWiki.
Syntax Rules
- Enter
ExternalSite:Pageto create a link that points to thePageon theExternalSiteserver. - Enter
[[ExternalSite:Page][any label]]to specify a custom label. - All
ExternalSitealiases are defined in the Inter Wikis topic. - Add and edit aliases in Inter Wikis.
- Each entry must be of format:
| External site alias | URL | Tooltip help text |. - Site aliases must start with an upper case letter and may contain alphanumeric letters.
- The URL and Tooltip Text may contain optional
$pagevariables; the variable gets expanded to the page name. -
For TWiki sites, both the web and the topic have to be specified: TWikisite:Webname/SomePage
InterwikiPlugin 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 Text Formatting Rules topic:
- Set SHORTDESCRIPTION = Link
ExternalSite:Pagetext to external sites based on aliases defined in a rules topic
- Set SHORTDESCRIPTION = Link
- Link rules topic name: (default is Inter Wikis)
- Set RULESTOPIC =
- Inter-link format, with variables:
$site Site alias $page Page (part after colon) $url Site URL (might contain $page) $label Equal to $site:$page $tooltip Tooltip message - Set INTERLINKFORMAT = $label
Plugin Installation Instructions
- Download the ZIP file from the TWiki:Plugins web (see below)
- Unzip
InterwikiPlugin.zipin your TWiki installation directory. Content:File: Description: data/TWiki/InterwikiPlugin.txtPlugin topic data/TWiki/InterWikis.txtLink rules topic for inter-site links lib/TWiki/Plugins/InterwikiPlugin.pmPlugin Perl module - Test: If the Plugin is correctly installed, this Wiki:InterWiki link should point to http://c2.com/cgi/wiki?InterWiki topic - try it out.
Plugin Info
| Plugin Author: | TWiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny |
| Copyright: | © 2001-2007, Andrea Sterbini, Peter Thoeny (TWIKI.NET), TWiki Contributor |
| License: | GPL (GNU General Public License) |
| Plugin Version: | 03 Aug 2008 17387 (11 Aug 2008) |
| Change History: | |
| 03 Aug 2008: | TWiki 4.2.1 release version |
| 22 Jan 2008: | TWiki 4.2.0 release version |
| 25 Nov 2007: | 15752 - TWikibug:Item5006 - Renamed Bugs rule to TWikibug rule (PTh) |
| 13 Aug 2007: | 14545 - TWikibug:Item4451 - Added Bugs: rule (TWiki:Main.CrawfordCurrie) |
| 11 Aug 2007: | 14538 - Fixed broken ISBN link (TWiki:Main.PeterThoeny) |
| 08 Nov 2006: | 11935 - Added css class="interwikiLink" (TWiki:Main.PeterThoeny) |
| 07 Nov 2006: | 11924 - Added INTERLINKFORMAT; removed redundant SUPPRESSTOOLTIP; allow @ signs in page part of interwiki link; support single digit page part (TWiki:Main.PeterThoeny) |
| 26 Feb 2005: | 1.008 TWiki:Main.CrawfordCurrie cleaned up code and made Dakar-ready |
| 25 Aug 2004: | 1.005 TWiki:Main.PeterThoeny updated Inter Wikis link rules (no code change) |
| 09 Mar 2004: | Internal changes: Use only official TWiki::Func Plugin API; for increased speed, moved Interwiki link handling from outsidePREHandler to startRenderingHandler |
| 16 Feb 2004: | Support [[Site:Page][label]] Interwiki links (PTh); use TWiki::Func interface for I18N regular expressions (Walter Mundt) |
| 18 Jan 2003: | Allow number sign # in Page name (PTh) |
| 31 Aug 2002: | Allow percent sign % in page name (PTh) |
| 27 Jul 2001: | Allow numbers 0-9 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: | TWiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny - Initial version |
| CPAN Dependencies: | none |
| Other Dependencies: | none |
| Perl Version: | 5.0 |
| Benchmarks: | Good Style 100%, Formatted Search 98%, Interwiki Plugin 98% |
| Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/InterwikiPlugin |
| Feedback: | http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginDev |
| Appraisal: | http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginAppraisal |
| Topic InterwikiPlugin . { Edit | Attach | Backlinks: Web All webs | Printable | History: r13 < r12 < r11 < r10 < r9 More } |