none
authorPeterThoeny <PeterThoeny>
Fri, 27 Jul 2001 07:28:52 +0000 (07:28 +0000)
committerPeterThoeny <PeterThoeny>
Fri, 27 Jul 2001 07:28:52 +0000 (07:28 +0000)
TWiki/InterWikis.mdwn [new file with mode: 0644]
TWiki/InterwikiPlugin.mdwn [new file with mode: 0644]
TWiki/TWikiSite.mdwn
TWiki/WelcomeGuest.mdwn
TWiki/WikiReferences.mdwn [new file with mode: 0644]

diff --git a/TWiki/InterWikis.mdwn b/TWiki/InterWikis.mdwn
new file mode 100644 (file)
index 0000000..b187a59
--- /dev/null
@@ -0,0 +1,174 @@
+## <a name="Inter-Wiki Link Rules (or Links"></a><a name="Inter-Wiki Link Rules (or Links "></a> Inter-Wiki Link Rules (or Links to other Sites)
+
+This topic lists all aliases needed to map Inter-Site links to external wikis/sites.
+
+Whenever you write <code>**ExternalSite:Page**</code> it will be linked automatically to the page on the external site. The link points to the URL corresponding to the <code>**ExternalSite**</code> alias below, concatenated to the <code>**Page**</code> you choose. Example: Type <code>**Wiki:RecentChanges**</code> to get [Wiki:RecentChanges](http://c2.com/cgi/wiki?RecentChanges), the RecentChanges page at the original Wiki site.
+
+### <a name="How to define Inter-Site links"></a> How to define Inter-Site links
+
+- Inter-Site links are defined in the tables below.
+- Each entry must be of format: <br /><code>**| External site alias | URL | Tooltip help text |**</code>.
+- The URL and Tooltip Text may contain optional <code>**$page**</code> variables; the variable gets expanded to the page name.
+- **_Note:_** The Tooltip Text must not contain any HTML tags (including <code>**&lt;nop&gt;**</code> escape code), no internal [[WikiWord]] links, and no external links. Hint: Escape <code>**'WikiWords'**</code> and <code>**'$page'**</code>.
+
+### <a name="Inter-Wiki Links"></a> Inter-Wiki Links
+
+<table border="1" cellpadding="0" cellspacing="0">
+  <tr>
+    <th bgcolor="#99CCCC"><strong> Alias: </strong></th>
+    <th bgcolor="#99CCCC"><strong> URL: </strong></th>
+    <th bgcolor="#99CCCC"><strong> Tooltip Text: </strong></th>
+  </tr>
+  <tr>
+    <td> Wiki </td>
+    <td><a href="http://c2.com/cgi/wiki" target="_top">http://c2.com/cgi/wiki</a>? </td>
+    <td> '$page' on the original 'WikiWikiWeb' site </td>
+  </tr>
+  <tr>
+    <td> PPR </td>
+    <td><a href="http://c2.com/cgi/wiki" target="_top">http://c2.com/cgi/wiki</a>? </td>
+    <td> '$page' on the original 'PortlandPatternRepository' site </td>
+  </tr>
+  <tr>
+    <td> C2find </td>
+    <td><a href="http://c2.com/cgi/wiki?FindPage&value=" target="_top">http://c2.com/cgi/wiki?FindPage&amp;value=</a></td>
+    <td> Search '$page' on the original 'WikiWikiWeb' site </td>
+  </tr>
+  <tr>
+    <td> ZWiki </td>
+    <td><a href="http://joyful.com/zwiki/" target="_top">http://joyful.com/zwiki/</a></td>
+    <td> '$page' on Zope's Wiki </td>
+  </tr>
+  <tr>
+    <td>[[Main/OrgPatterns]]</td>
+    <td><a href="http://www.bell-labs.com/cgi-user/OrgPatterns/OrgPatterns" target="_top">http://www.bell-labs.com/cgi-user/OrgPatterns/OrgPatterns</a></td>
+    <td> '$page' on Organizational Patterns site </td>
+  </tr>
+  <tr>
+    <td>[[Main/FoxWiki]]</td>
+    <td><a href="http://fox.wikis.com/wc.dll?Wiki~" target="_top">http://fox.wikis.com/wc.dll?Wiki~</a></td>
+    <td> '$page' on Fox Wiki site </td>
+  </tr>
+  <tr>
+    <td>[[Main/PhpWiki]]</td>
+    <td><a href="http://phpwiki.sourceforge.net/phpwiki/index.php3" target="_top">http://phpwiki.sourceforge.net/phpwiki/index.php3</a>? </td>
+    <td> '$page' on Wiki site written in PHP </td>
+  </tr>
+  <tr>
+    <td>[[Main/MuWeb]]</td>
+    <td><a href="http://www.dunstable.com/scripts/MuWebWeb" target="_top">http://www.dunstable.com/scripts/MuWebWeb</a>? </td>
+    <td> '$page' on 'MuWeb' site </td>
+  </tr>
+  <tr>
+    <td>[[Main/PyWiki]]</td>
+    <td><a href="http://www.voght.com/cgi-bin/pywiki" target="_top">http://www.voght.com/cgi-bin/pywiki</a>? </td>
+    <td> '$page' on Wiki site written in Python </td>
+  </tr>
+  <tr>
+    <td> Squeak </td>
+    <td><a href="http://minnow.cc.gatech.edu/squeak/" target="_top">http://minnow.cc.gatech.edu/squeak/</a></td>
+    <td> '$page' on Squeak Smalltalk Wiki </td>
+  </tr>
+  <tr>
+    <td>[[Main/UseMod]]</td>
+    <td><a href="http://www.usemod.com/cgi-bin/wiki.pl" target="_top">http://www.usemod.com/cgi-bin/wiki.pl</a>? </td>
+    <td> '$page' on 'UseMod' Wiki site </td>
+  </tr>
+  <tr>
+    <td>[[Main/MeatBall]]</td>
+    <td><a href="http://www.usemod.com/cgi-bin/mb.pl" target="_top">http://www.usemod.com/cgi-bin/mb.pl</a>? </td>
+    <td> '$page' on 'MeatBall' site, a 'UseMod' Wiki variant </td>
+  </tr>
+  <tr>
+    <td>[[Main/MbTest]]</td>
+    <td><a href="http://www.usemod.com/cgi-bin/mbtest.pl" target="_top">http://www.usemod.com/cgi-bin/mbtest.pl</a>? </td>
+    <td> '$page' on 'UseMod' Wiki variant </td>
+  </tr>
+  <tr>
+    <td>[[Main/HammondWiki]]</td>
+    <td><a href="http://www.dairiki.org/HammondWiki/index.php3" target="_top">http://www.dairiki.org/HammondWiki/index.php3</a>? </td>
+    <td> '$page' on 'HammondWiki' site </td>
+  </tr>
+  <tr>
+    <td> Advogato </td>
+    <td><a href="http://www.advogato.org/" target="_top">http://www.advogato.org/</a></td>
+    <td> '$page' on Advogato community site (with peer review) </td>
+  </tr>
+  <tr>
+    <td>[[Main/MoinMoin]]</td>
+    <td><a href="http://moin.sourceforge.net/cgi-bin/moin/moin/" target="_top">http://moin.sourceforge.net/cgi-bin/moin/moin/</a></td>
+    <td> '$page' on 'MoinMoin' Wiki site </td>
+  </tr>
+  <tr>
+    <td>[[Main/EfnetPythonWiki]]</td>
+    <td><a href="http://www.encrypted.net/~jh/python-wiki/moin.cgi/" target="_top">http://www.encrypted.net/~jh/python-wiki/moin.cgi/</a></td>
+    <td> '$page' on 'EfnetPythonWiki' site </td>
+  </tr>
+  <tr>
+    <td>[[Main/EfnetCppWiki]]</td>
+    <td><a href="http://www.encrypted.net/~jh/cpp-wiki/moin.cgi/" target="_top">http://www.encrypted.net/~jh/cpp-wiki/moin.cgi/</a></td>
+    <td> '$page' on Efnet Cpp Wiki site </td>
+  </tr>
+  <tr>
+    <td>[[Main/EfnetXmlWiki]]</td>
+    <td><a href="http://www.encrypted.net/~jh/xml-wiki/moin.cgi/" target="_top">http://www.encrypted.net/~jh/xml-wiki/moin.cgi/</a></td>
+    <td> '$page' on Efnet XML Wiki site </td>
+  </tr>
+  <tr>
+    <td>[[Main/PolitizenWiki]]</td>
+    <td><a href="http://www.politizen.com/wiki.asp" target="_top">http://www.politizen.com/wiki.asp</a>? </td>
+    <td> '$page' on 'PolitizenWiki' site </td>
+  </tr>
+  <tr>
+    <td>[[Main/DolphinWiki]]</td>
+    <td><a href="http://www.object-arts.com/wiki/html/Dolphin/" target="_top">http://www.object-arts.com/wiki/html/Dolphin/</a></td>
+    <td> '$page' on Dolphin Wiki site </td>
+  </tr>
+  <tr>
+    <td>[[Main/LegoWiki]]</td>
+    <td><a href="http://www.object-arts.com/wiki/html/Lego-Robotics/" target="_top">http://www.object-arts.com/wiki/html/Lego-Robotics/</a></td>
+    <td> '$page' on 'LegoWiki' site </td>
+  </tr>
+  <tr>
+    <td> TWiki </td>
+    <td><a href="http://twiki.org/cgi-bin/view/" target="_top">http://twiki.org/cgi-bin/view/</a></td>
+    <td> '$page' on TWiki site, we know it! </td>
+  </tr>
+  <tr>
+    <td>[[Main/VisualWorks]]</td>
+    <td><a href="http://wiki.cs.uiuc.edu/VisualWorks/" target="_top">http://wiki.cs.uiuc.edu/VisualWorks/</a></td>
+    <td> '$page' on 'VisualWorks' site </td>
+  </tr>
+</table>
+
+### <a name="Miscellaneous Inter-Site Links"></a> Miscellaneous Inter-Site Links
+
+<table border="1" cellpadding="0" cellspacing="0">
+  <tr>
+    <th bgcolor="#99CCCC"><strong> Alias: </strong></th>
+    <th bgcolor="#99CCCC"><strong> URL: </strong></th>
+    <th bgcolor="#99CCCC"><strong> Tooltip Text: </strong></th>
+  </tr>
+  <tr>
+    <td> Acronym </td>
+    <td><a href="http://www.acronymfinder.com/af-query.asp?Acronym=$page&String=exact" target="_top">http://www.acronymfinder.com/af-query.asp?Acronym=$page&amp;String=exact</a></td>
+    <td> Look up $page on Acronym Finder site </td>
+  </tr>
+  <tr>
+    <td>[[Main/DejaNews]]</td>
+    <td><a href="http://www.deja.com/=dnc/getdoc.xp?AN=" target="_top">http://www.deja.com/=dnc/getdoc.xp?AN=</a></td>
+    <td> '$page' on Net News </td>
+  </tr>
+  <tr>
+    <td> ISBN </td>
+    <td><a href="http://service.bfast.com/bfast/click?bfmid=2181&sourceid=38704253&bfpid=" target="_top">http://service.bfast.com/bfast/click?bfmid=2181&amp;sourceid=38704253&amp;bfpid=</a></td>
+    <td> Book with ISBN#$page (One click patent? Say no to Amazon!) </td>
+  </tr>
+  <tr>
+    <td> RFC </td>
+    <td><a href="http://www.faqs.org/rfcs/rfc$page.html" target="_top">http://www.faqs.org/rfcs/rfc$page.html</a></td>
+    <td> IETF RFC #$page </td>
+  </tr>
+</table>
+
+**_Note:_** This topic is powered by the [[InterwikiPlugin]].
diff --git a/TWiki/InterwikiPlugin.mdwn b/TWiki/InterwikiPlugin.mdwn
new file mode 100644 (file)
index 0000000..816215e
--- /dev/null
@@ -0,0 +1,91 @@
+## <a name="%TOPIC%"></a> %TOPIC%
+
+The %TOPIC% links <code>**ExternalSite:Page**</code> 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> .
+
+## <a name="Syntax Rules"></a> Syntax Rules
+
+- Write <code>**ExternalSite:Page**</code> to create automatically a link that points to the <code>**Page**</code> on the <code>**ExternalSite**</code> server.
+- All <code>**ExternalSite**</code> aliases are defined in the [[InterWikis]] topic.
+- To add new aliases just follows the instructions in [[InterWikis]].
+
+## <a name="%TOPIC% Settings"></a> %TOPIC% Settings
+
+Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%&lt;plugin&gt;\_&lt;setting&gt;%**</code>, i.e. <code>**%INTERWIKIPLUGIN\_SHORTDESCRIPTION%**</code>
+
+- One line description, is shown in the [[TextFormattingRules]] topic:
+  - Set SHORTDESCRIPTION = Link <code>**ExternalSite:Page**</code> 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: (<code>****</code> or <code>**1**</code>, default is <code>****</code>)
+  - Set SUPPRESSTOOLTIP = 0
+
+- Debug plugin: (See output in `data/debug.txt`)
+  - Set DEBUG = 0
+
+### <a name="Plugin Installation Instructions"></a> 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 <code>**%TOPIC%.zip**</code> in your twiki installation directory. Content: <table border="1" cellpadding="0" cellspacing="0">
+  <tr>
+    <th bgcolor="#99CCCC"><strong> File: </strong></th>
+    <th bgcolor="#99CCCC"><strong> Description: </strong></th>
+  </tr>
+  <tr>
+    <td><code><b>data/TWiki/%TOPIC%.txt</b></code></td>
+    <td> Plugin topic </td>
+  </tr>
+  <tr>
+    <td><code><b>data/TWiki/InterWikis.txt</b></code></td>
+    <td> Link rules topic for inter-site links </td>
+  </tr>
+  <tr>
+    <td><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td>
+    <td> Plugin Perl module </td>
+  </tr>
+</table>
+- Test if the plugin is correctly installed: Wiki:InterWiki should point to Wiki's <http://c2.com/cgi/wiki?InterWiki> topic.
+
+### <a name="Plugin Info"></a> Plugin Info
+
+<table border="1" cellpadding="0" cellspacing="0">
+  <tr>
+    <td align="right"> Plugin Author: </td>
+    <td>[[TWiki/AndreaSterbini]], [[TWiki/PeterThoeny]]</td>
+  </tr>
+  <tr>
+    <td align="right"> Plugin Version: </td>
+    <td> 1.0.2 </td>
+  </tr>
+  <tr>
+    <td align="right"> Change History: </td>
+    <td> 27 Jul 2001 Allow numbers in site name <br /> 26 Jul 2001 Fixed alternating missed link bug due to greedy $postfixPattern (fix by Richard Donkin) <br /> 14 Jul 2001 Changed to plug &amp; play <br /> 16 Jun 2001: Made tool tips optional; prevent <code><b>Module::Sub</b></code> type of link <br /> 12 Jun 2001: Added optional tool tips (IE only); added the link rules topic name variable; added flexible link patterns; optional <code><b>$page</b></code> in URL <br /> 10 Jun 2001: Changed rules topic to table based syntax <br /> 20 Feb 2001: Initial version </td>
+  </tr>
+  <tr>
+    <td align="right"> CPAN Dependencies: </td>
+    <td> none </td>
+  </tr>
+  <tr>
+    <td align="right"> Other Dependencies: </td>
+    <td> none </td>
+  </tr>
+  <tr>
+    <td align="right"> Perl Version: </td>
+    <td> 5.0 </td>
+  </tr>
+  <tr>
+    <td align="right"> Plugin Home: </td>
+    <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a> (TWiki:Plugins/%TOPIC%) </td>
+  </tr>
+  <tr>
+    <td align="right"> Feedback: </td>
+    <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a> (TWiki:Plugins/%TOPIC%Dev) </td>
+  </tr>
+</table>
+
+**_Related Topics:_** [[InterWikis]], [[TWikiPreferences]], [[TWikiPlugins]]
+
+-- [[AndreaSterbini]] - 20 Oct 2000 <br /> -- [[PeterThoeny]] - 27 Jul 2001 <br />
index 065c02d..9bb43bf 100644 (file)
@@ -15,7 +15,7 @@ What does the name TWiki stand for?
 - _Wiki wiki_ means quick in Hawai'ian. They call the shuttle at the Honolulu airport the [ wiki wiki bus](http://www.quickaid.com/airports/hnl/company/trans_tm.html).
 - _TWiki_ is the short form of _TakeFive Wiki_ . (Later on I found out that _Twiki_ is the name of a robot in a [Buck Rogers](http://www.buck-rogers.com/) TV show in 1979)
 
-%WIKITOOLNAME% is one of many [[WikiWikiClones]]; the first one was built by Ward Cummingham, <http://c2.com/>
+%WIKITOOLNAME% is one of many [[WikiWikiClones]]; the first one was built by Wiki:WardCummingham, <http://c2.com/>
 
 Topics of interest:
 
@@ -25,6 +25,7 @@ Topics of interest:
 - [[TWikiDocumentation]] is the implementation documentation.
 - [[TWikiAdministration]] tells you how to do administrative stuff, like renaming or deleting a topic.
 - [[WikiCulture]] talks about the unique type of collaboration Wiki systems offer.
+- [[WikiReferences]] has links to articles and books around collaboration and the Wiki technology in particular.
 
 **Note:**
 
index 0041958..46e8bc1 100644 (file)
@@ -24,7 +24,7 @@ you have reached the [[TWikiWeb]] (pronounced twee-kee web). %WIKITOOLNAME% is a
   - To create a free-floating topic, e.g. a topic that is not linked from anywhere, type its [[WikiWord]] in the entry field at the top of any page. If the topic already exists you'll then be taken to it. If it doesn't exist, you'll then have the option to create it.
 8. **See the History of a Topic:** Check out the the various "Diff" entries at the bottom of page.
 9. **Attach Files:** Upload and attach any file to a topic by following the "Attach" link at the bottom of page.
-10. **Learn More**: The [[TWikiTutorial]] gives you some more details on the %WIKITOOLNAME%.
+10. **Learn More**: The [[TWikiTutorial]] gives you some more details on the %WIKITOOLNAME%. [[WikiReferences]] has links to articles and books around collaboration and the Wiki technology in particular.
 
 **Main Features of %WIKITOOLNAME%**
 
diff --git a/TWiki/WikiReferences.mdwn b/TWiki/WikiReferences.mdwn
new file mode 100644 (file)
index 0000000..376d047
--- /dev/null
@@ -0,0 +1,33 @@
+# <a name="References on Wiki and Collabora"></a> References on Wiki and Collaboration
+
+Some useful articles and books around collaboration and the Wiki technology in particular.
+
+## <a name="Wiki Technology and TWiki"></a> Wiki Technology and TWiki
+
+- Book: The Wiki Way, Quick Collaboration on the Web; by Bo Leuf and Ward Cunningham; Addison-Wesley Pub Co; ISBN:020171499X
+
+- Article: Corporate Collaboration With TWiki; by Peter Thoeny; Web Techniques Magazine; December 2000; <http://www.webtechniques.com/archives/2000/12/thoeny/>
+
+- Presentation: TWiki Collaboration Tool - A Mature and Full Featured Platform for building Web Based Groupware Applications; by Peter Thoeny; TWiki:Main/TWikiPlatformPresentation
+
+- Directory: Google.com &amp;t; Computers &amp;t; Software &amp;t; Groupware &amp;t; Wiki; <http://directory.google.com/Top/Computers/Software/Groupware/Wiki/>
+
+## <a name="Collaboration and Knowledge Mana"></a> Collaboration and Knowledge Management
+
+- Article: Internet Groupware for Scientific Collaboration; Jon Udell; Software Carpentry; <http://software-carpentry.codesourcery.com/Groupware/report.html>
+
+- Directory: Google.com &amp;t; Reference &amp;t; Knowledge Management; [http://directory.google.com/Top/Reference/Knowledge\_Management/](http://directory.google.com/Top/Reference/Knowledge_Management/)
+
+- Book: The Knowledge Management Toolkit: Practical Techniques for Building a Knowledge Management System; by Amrit Tiwana; Prentice Hall PTR; ISBN:0130128538
+
+- Book: The Knowing-Doing Gap: How Smart Companies Turn Knowledge into Action; by Jeffrey Pfeffer and Robert I. Sutton; Harvard Business School Pr; ISBN:1578511240
+
+## <a name="Extreme Programming"></a> Extreme Programming
+
+- Book: Extreme Programming Examined; by Giancarlo Succi and Michele Marchesi; Addison-Wesley Pub Co; ISBN:0201710404
+
+- Book: Extreme Programming in Practice; by James W. Newkirk and Robert C. Martin; Addison-Wesley Pub Co; ISBN:0201709376
+
+- Book: Extreme Programming Explored; by William C. Wake and Bill Wake; Addison-Wesley Pub Co; ISBN:0201733978
+
+-- [[PeterThoeny]] - 27 Jul 2001 <br />