WikiLink - The Mediawiki Interface: Difference between revisions

From Knot Atlas
Jump to navigationJump to search
Line 113: Line 113:
<!--$$WikiSetPageTexts[{{"Sandbox", "A robotic edit, by --[[User:Scott|Scott]]"}, {"Sandbox2", "The determinant of the knot [[3_1]] is 3."}}]$$--><!--END-->
<!--$$WikiSetPageTexts[{{"Sandbox", "A robotic edit, by --[[User:Scott|Scott]]"}, {"Sandbox2", "The determinant of the knot [[3_1]] is 3."}}]$$--><!--END-->
<!--$$WikiGetPageText["Sandbox2"]$$--><!--END-->
<!--$$WikiGetPageText["Sandbox2"]$$--><!--END-->

====Troubleshooting====
The instruction <code>ShowJavaConsole[]</code> will bring up a window in which some debugging information is displayed.


====Compatibility====
====Compatibility====

Revision as of 14:36, 31 August 2005


WikiLink is actually two separate things; firstly, a java class for interfacing with a mediawiki server, and secondly, a Mathematica package providing a wrapper around this. This page documents the Mathematica package, whie the java class, and its addition functionality, will be documented elsewhere.

License

WikiLink.nb, WikiLink.m and wikilink.jar are copyright Scott Morrison, available under your choice of the MIT or GPL licenses. The other components are copyright by other parties, all available under the Apache license.

Download

Download WikiLink.zip (file description). Unzip this, probably in the same place you've unzipped the KnotTheory` package. This will create a subdirectory called WikiLink, containing (at least) these files:

Filename Description
WikiLink.nb The Mathematica notebook containing wrapper function definitions.
WikiLink.m The Mathematica package automatically generated from WikiLink.nb.
wikilink.jar The WikiLink java class and source code (MediawikiConnection.java).

jdom.jar
commons-httpclient-3.0-rc2.jar
commons-codec-1.3.jar
commons-lang-2.1.jar
commons-logging.jar

Libraries (all available under either GPL or the Apache license) required by wikilink.jar

Importing the package in Mathematica

First, you'll need to set some paths, so WikiLink` can find the java files it needs.

In[1]:= KnotAtlasPath = "c:\\scott\\math.berkeley.edu\\Work\\Mathematica\\KnotAtlas\\";
In[2]:= AppendTo[$Path, KnotAtlasPath];
In[3]:= SetDirectory[KnotAtlasPath];
In[4]:= << "WikiLink\\WikiLink.m"
In[5]:= SetJarPath[KnotAtlasPath <> "WikiLink\\"];

We then try to connect to the wiki. Executing this line will prompt you for a username and password.

In[6]:= CreateWikiConnection[ "http://katlas.math.toronto.edu/w/index.php", wikiUserName=InputString["Enter Your Username:"], InputString["Enter Your Password"] ]

The function WikiUserName[] checks that we're logged in

In[7]:= ?WikiUserName
WikiUserName[] returns either the name of the user you are logged in as, or $Failed if you appear to be not logged in.
In[8]:= wikiUserName==WikiUserName[]
Out[8]= True

Usage

WikiLink` provides only a few functions.


Thus for example after we get

The function WikiSetPageTexts is most useful for batch uploads, as it does considerably more error checking, and filters out edits which won't change the page text. It takes as argument a list of {"title", "text"} pairs, and returns a list of those pairs which failed.


Troubleshooting

The instruction ShowJavaConsole[] will bring up a window in which some debugging information is displayed.

Compatibility

WikiLink has been tested against mediawiki 1.4.5beta3 and 1.4.7.