Changes between Version 1 and Version 2 of InterWiki


Ignore:
Timestamp:
08/02/11 11:44:45 (7 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InterWiki

    v1 v2  
    1 ## Please edit system and help pages ONLY in the moinmaster wiki! For more 
    2 ## information, please see MoinMaster:MoinPagesEditorGroup. 
    3 ##master-page:Unknown-Page 
    4 ##master-date:Unknown-Date 
    5 #acl MoinPagesEditorGroup:read,write,delete,revert All:read 
    6 #format wiki 
    7 #language en 
    8 InterWiki links are a quick way to refer to information in other wikis, without having to remember 
    9 cryptic URLs. To write an InterWiki link, just use the InterWiki moniker of the foreign wiki,  
    10 followed by a page name on that wiki.  
    11 Of course, InterWiki links are not rendered differently when the remote page does not exist, and 
    12 MoinMoin cannot check whether you followed the rules for WikiName``s of the other wiki. 
    13 So double-check what you type. 
    14 See the wiki:MeatBall/InterWiki page on wiki:MeatBall:MeatballWiki for further details. 
     1= Support for InterWiki links = 
    152 
    16 List of valid InterWiki names this wiki knows of (the master copy of this list is at MoinMaster:InterWikiMap): 
    17 [[InterWiki]] 
     3''(since [trac:milestone:0.10 0.10])'' 
    184 
    19 MoinMoin marks the InterWiki links in a way that works for the MeatBall:ColourBlind and also is MeatBall:LynxFriendly by using a little icon with an ALT attribute. If you hover above the icon in a graphical browser, you'll see to which Wiki it refers. BTW, the reasoning behind the icon used is based on the idea that a Wiki:WikiWikiWeb is created by a team effort of several people. 
     5== Definition == 
     6 
     7An InterWiki link can be used for referring to a Wiki page 
     8located in another Wiki system, and by extension, to any object 
     9located in any other Web application, provided a simple URL  
     10mapping can be done. 
     11 
     12At the extreme, InterWiki prefixes can even be used to simply introduce 
     13links to new protocols, such as `tsvn:` used by [trac:TortoiseSvn TortoiseSvn]. 
     14 
     15== Link Syntax == 
     16 
     17{{{ 
     18<target_wiki>(:<identifier>)+ 
     19}}} 
     20 
     21The link is composed by the targeted Wiki (or system) name, 
     22followed by a colon (e.g. `MeatBall:`), 
     23followed by a page specification in the target. 
     24Note that, as for InterTrac prefixes, '''InterWiki prefixes are case insensitive'''. 
     25 
     26The target Wiki URL is looked up in the InterMapTxt wiki page,  
     27modelled after MeatBall:InterMapTxt. 
     28 
     29In addition to traditional InterWiki links, where the target 
     30is simply ''appended'' to the URL,  
     31Trac supports parametric InterWiki URLs: 
     32identifiers `$1`, `$2`, ... in the URL 
     33will be replaced by corresponding arguments. 
     34The argument list is formed by splitting the page identifier 
     35using the ":" separator. 
     36 
     37== Examples == 
     38 
     39If the following is an excerpt of the InterMapTxt page: 
     40 
     41{{{ 
     42= InterMapTxt = 
     43== This is the place for defining InterWiki prefixes == 
     44 
     45Currently active prefixes: [[InterWiki]] 
     46 
     47This page is modelled after the MeatBall:InterMapTxt page. 
     48In addition, an optional comment is allowed after the mapping. 
     49---- 
     50{{{ 
     51PEP      http://www.python.org/peps/pep-$1.html           # Python Enhancement Proposal $1  
     52Trac-ML  http://thread.gmane.org/gmane.comp.version-control.subversion.trac.general/$1  # Message $1 in Trac Mailing List 
     53 
     54tsvn     tsvn:                                            # Interact with TortoiseSvn 
     55... 
     56MeatBall http://www.usemod.com/cgi-bin/mb.pl? 
     57MetaWiki http://sunir.org/apps/meta.pl? 
     58MetaWikiPedia http://meta.wikipedia.org/wiki/ 
     59MoinMoin http://moinmoin.wikiwikiweb.de/ 
     60... 
     61}}} 
     62}}} 
     63 
     64Then,  
     65 * `MoinMoin:InterWikiMap` should be rendered as MoinMoin:InterWikiMap 
     66   and the ''title'' for that link would be "!InterWikiMap in !MoinMoin" 
     67 * `Trac-ML:4346` should be rendered as Trac-ML:4346 
     68   and the ''title'' for that link would be "Message 4346 in Trac Mailing List" 
     69 
     70---- 
     71See also: InterTrac, InterMapTxt