| | Interwiki Plugin |
|
>
> | <--
Contributions to this TWiki plugin are appreciated. Please update the plugin page
at http://twiki.org/cgi-bin/view/Plugins/InterwikiPlugin or provide feedback
at http://twiki.org/cgi-bin/view/Plugins/InterwikiPluginDev.
If you are a TWiki contributor please update the plugin in the SVN repository.
-->
Write ExternalSite:Page to link to a page on an external site based on aliases defined in a rules topic |
| | |
|
<
< | 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. |
>
> | Introduction |
| | |
|
<
< | |
>
> | 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
- Enter
ExternalSite:Page to create a link that points to the Page on the ExternalSite server.
- Enter
[[ExternalSite:Page][any label]] to specify a custom label.
|
|
<
< | |
>
> | |
| |
- 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
$page variables; 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 |
>
> | Plugin settings are stored as Preferences variables. To reference a plugin setting write %<plugin>_<setting>%, for example, %INTERWIKIPLUGIN_SHORTDESCRIPTION% |
|
<
< | a plugin setting write %<plugin>_<setting>%, for example, %INTERWIKIPLUGIN_SHORTDESCRIPTION% |
| | |
|
<
< | |
>
> | |
| |
-
- Set SHORTDESCRIPTION = Link
ExternalSite:Page text to external sites based on aliases defined in a rules topic
|
|
<
< | |
>
> | |
| |
- 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 |
Plugin Installation Instructions |
|
<
< |  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. |
>
> | 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
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, this Wiki:InterWiki link should point to http://c2.com/cgi/wiki?InterWiki topic - try it out.
Plugin Info |
|
<
< |
|
>
> |
|
| |
|
|
<
< |
| Plugin Version: |
28 Feb 2009 17852 (02 Sep 2009) |
|
>
> |
| Plugin Version: |
2010-05-15 18695 (2010-05-29) |
|
| |
| Change History: |
<-- versions below in reverse order --> |
|
|
>
> |
|
| |
| 28 Feb 2009: |
17851 - TWikibug:Item5025 - Added = and & to page regex, allowing links such as Site:ID=1234&sel=56 |
| 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 InterWikis 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 |
|
|
<
< |
|
>
> |
|
| |
|
|
<
< | Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences, InterWikis |
>
> | Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences, InterWikis |
| |
-- TWiki:Main.PeterThoeny - 28 Feb 2009 |
Copyright © 1999-2025 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.