WikiLink - The Mediawiki Interface: Difference between revisions
From Knot Atlas
Jump to navigationJump to search
m (Reverted edit of 70.191.124.29, changed back to last version by Scott) |
|||
| Line 1: | Line 1: | ||
====License==== |
|||
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, while the java class, and its addition functionality, will be documented elsewhere. |
|||
<u style="display: none;">... no changes ... no changes ... no changes ... no changes ... no changes ... no changes ... no changes ... no changes ... no changes ... no changes ... no changes ... Thanks!!! Links: <a href='http://www.areaseo.com'>pagerank main</a> : [http://www.areaseo.com improve pagerank default] - [HTTP://www.areaseo.com improve pagerank default] : [PageRank 11|http://www.areaseo.com] - [PageRank 11|HTTP://www.areaseo.com] : http://www.areaseo.com/improvepr/ : [[http://www.areaseo.com google rank 20]] : [[http://www.areaseo.com | pagerank 5]] : "online pr16" http://www.areaseo.com : [http://www.areaseo.com|google pr] </u>====License==== |
|||
<tt>WikiLink.nb</tt>, <tt>WikiLink.m</tt> and <tt>wikilink.jar</tt> are copyright Scott Morrison, available under your choice of the MIT, Apache or GPL licenses. The other components are copyright by other parties, all available under the Apache license. |
<tt>WikiLink.nb</tt>, <tt>WikiLink.m</tt> and <tt>wikilink.jar</tt> are copyright Scott Morrison, available under your choice of the MIT, Apache or GPL licenses. The other components are copyright by other parties, all available under the Apache license. |
||
====Download==== |
|||
Download [http://katlas.math.toronto.edu/svn/WikiLink/tags/stable/WikiLink.zip WikiLink.zip]. 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: |
|||
{| border=1 |
|||
|- |
|||
!Filename |
|||
!Description |
|||
|- |
|||
| <tt>mathematica/WikiLink.nb</tt> |
|||
| The Mathematica notebook containing wrapper function definitions. |
|||
|- |
|||
| <tt>mathematica/WikiLink.m</tt> |
|||
| The Mathematica package automatically generated from <tt>WikiLink.nb</tt>. |
|||
|- |
|||
| <tt>wikilink.jar</tt> |
|||
| The WikiLink java classes and source code. |
|||
|- |
|||
| |
|||
<tt>jars/jdom.jar</tt><br/> |
|||
<tt>jars/commons-httpclient-3.0-rc2.jar</tt><br/> |
|||
<tt>jars/commons-codec-1.3.jar</tt><br/> |
|||
<tt>jars/commons-lang-2.1.jar</tt><br/> |
|||
<tt>jars/commons-logging.jar</tt><br/> |
|||
| Libraries (all available under either GPL or the Apache license) required by <tt>wikilink.jar</tt> |
|||
|} |
|||
====Importing the package in Mathematica==== |
|||
First, you'll need to set some paths, so WikiLink` can find the java files it needs. You need to add the "mathematica/" subdirectory of the WikiLink distribution to the Mathematica $Path. |
|||
<!--$$WikiLinkPath = "/path/to/WikiLink/mathematica/";$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{In| |
|||
n = 1 | |
|||
in = <nowiki>WikiLinkPath = "/path/to/WikiLink/mathematica/";</nowiki>}} |
|||
<!--END--> |
|||
<!--$$AppendTo[$Path, WikiLinkPath];$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{In| |
|||
n = 2 | |
|||
in = <nowiki>AppendTo[$Path, WikiLinkPath];</nowiki>}} |
|||
<!--END--> |
|||
<!--$$<<WikiLink`$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{In| |
|||
n = 3 | |
|||
in = <nowiki><<WikiLink`</nowiki>}} |
|||
<!--END--> |
|||
We then try to connect to the wiki. Executing this line will prompt you for a username and password. |
|||
<!--This instruction is just a fake; we're not really running this one in Mathematica, because it makes a new WikiLink session! :-) |
|||
<!--CreateWikiConnection[ |
|||
"http://katlas.math.toronto.edu/w/index.php", |
|||
InputString["Enter Your Username:"], |
|||
InputString["Enter Your Password:"] |
|||
]--> |
|||
{{In| |
|||
n = 6 | |
|||
in = <nowiki>CreateWikiConnection[ |
|||
"http://katlas.math.toronto.edu/w/index.php", |
|||
InputString["Enter Your Username:"], |
|||
InputString["Enter Your Password:"] |
|||
]</nowiki>}} |
|||
The function <code>WikiUserName[]</code> checks that we're logged in |
|||
<!--$$?WikiUserName$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{HelpLine| |
|||
n = 4 | |
|||
in = <nowiki>WikiUserName</nowiki> | |
|||
out= <nowiki>WikiUserName[] returns either the name of the user you are logged in as, your IP address if you're not logged in, or $Failed if something more complicated has happened!</nowiki>}} |
|||
<!--END--> |
|||
<!--$$WikiUserName[]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 5 | |
|||
in = <nowiki>WikiUserName[]</nowiki> | |
|||
out= <nowiki>ScottManualRobot</nowiki>}} |
|||
<!--END--> |
|||
====Usage==== |
|||
WikiLink` provides functions for checking your login status, getting and setting pages, as well as transparently extending some of Mathematica's string manipulation functions to wiki pages. |
|||
<!--$$?WikiUserName$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{HelpLine| |
|||
n = 6 | |
|||
in = <nowiki>WikiUserName</nowiki> | |
|||
out= <nowiki>WikiUserName[] returns either the name of the user you are logged in as, your IP address if you're not logged in, or $Failed if something more complicated has happened!</nowiki>}} |
|||
<!--END--> |
|||
<!--$$?WikiGetPageText$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{HelpLine| |
|||
n = 7 | |
|||
in = <nowiki>WikiGetPageText</nowiki> | |
|||
out= <nowiki>WikiGetPageText[pagename] returns the raw text of the specified page.</nowiki>}} |
|||
<!--END--> |
|||
<!--$$?WikiSetPageText$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{HelpLine| |
|||
n = 8 | |
|||
in = <nowiki>WikiSetPageText</nowiki> | |
|||
out= <nowiki>WikiSetPageText[pagename, text] overwrites the contents of the specificied page with the given text. |
|||
WikiSetPageText[pagename, text, summary] overwrites the contents of the specificied page with the given text and notes summary in the change log.</nowiki>}} |
|||
<!--END--> |
|||
<!--$$?WikiSetPageTexts$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{HelpLine| |
|||
n = 9 | |
|||
in = <nowiki>WikiSetPageTexts</nowiki> | |
|||
out= <nowiki>WikiSetPageText[{{pagename1, text1},{pagename2,text2},...}] efficiently sets multiple pages, by first checking which texts are already up to date.</nowiki>}} |
|||
<!--END--> |
|||
<!--$$?WikiUploadFile$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{HelpLine| |
|||
n = 10 | |
|||
in = <nowiki>WikiUploadFile</nowiki> | |
|||
out= <nowiki>WikiUploadFile[name, description] uploads the specified file to the wiki.</nowiki>}} |
|||
<!--END--> |
|||
Thus for example after |
|||
<!--$$WikiSetPageText["Sandbox", "A robotic edit, at 19:39, 31-August-2005."]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 11 | |
|||
in = <nowiki>WikiSetPageText["Sandbox", "A robotic edit, at 19:39, 31-August-2005."]</nowiki> | |
|||
out= <nowiki>True</nowiki>}} |
|||
<!--END--> |
|||
we get |
|||
<!--$$WikiGetPageText["Sandbox"]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 12 | |
|||
in = <nowiki>WikiGetPageText["Sandbox"]</nowiki> | |
|||
out= <nowiki>A robotic edit, at 19:39, 31-August-2005.</nowiki>}} |
|||
<!--END--> |
|||
The function <code>WikiSetPageTexts</code> 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 <code>{"title", "text"}</code> pairs, and returns a list of those pairs which failed. |
|||
<!--$$WikiSetPageTexts[{{"Sandbox", "A robotic edit, by --~~"<>"~~"}, {"Sandbox2", "The determinant of the knot [[3_1]] is 3."}}]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 13 | |
|||
in = <nowiki>WikiSetPageTexts[{{"Sandbox", "A robotic edit, by --~~"<>"~~"}, {"Sandbox2", "The determinant of the knot [[3_1]] is 3."}}]</nowiki> | |
|||
out= <nowiki>{}</nowiki>}} |
|||
<!--END--> |
|||
<!--$$WikiGetPageText["Sandbox2"]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 14 | |
|||
in = <nowiki>WikiGetPageText["Sandbox2"]</nowiki> | |
|||
out= <nowiki>The determinant of the knot [[3_1]] is 3.</nowiki>}} |
|||
<!--END--> |
|||
=====String manipulation functions===== |
|||
<code>WikiLink`</code> provides functions WikiPageMatchQ, WikiPageFreeQ, WikiStringReplace and WikiStringCases. Each function works likes its usual Mathematica partner, [http://documents.wolfram.com/mathematica/functions/StringMatchQ StringMatchQ], [http://documents.wolfram.com/mathematica/functions/StringFreeQ StringFreeQ], [http://documents.wolfram.com/mathematica/functions/StringReplace StringReplace] or [http://documents.wolfram.com/mathematica/functions/StringCases StringCases]. Instead of providing a string, or list of strings, as the first argument, you should give the name of a page, or a list of names. |
|||
You can use these to perform all sorts of editing tricks. |
|||
<!--$$WikiPageMatchQ[{"Sandbox", "Sandbox2"}, "determinant"]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 15 | |
|||
in = <nowiki>WikiPageMatchQ[{"Sandbox", "Sandbox2"}, "determinant"]</nowiki> | |
|||
out= <nowiki>{False, False}</nowiki>}} |
|||
<!--END--> |
|||
<!--$$WikiPageFreeQ[{"Sandbox", "Sandbox2"}, "[["~~(DigitCharacter..)~~"_"~~(DigitCharacter..)~~"]]"]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 16 | |
|||
in = <nowiki>WikiPageFreeQ[{"Sandbox", "Sandbox2"}, "[["~~(DigitCharacter..)~~"_"~~(DigitCharacter..)~~"]]"]</nowiki> | |
|||
out= <nowiki>{True, False}</nowiki>}} |
|||
<!--END--> |
|||
<!--$$WikiStringCases[{"Sandbox", "Sandbox2"}, "[["~~ShortestMatch[__]~~"]]"]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 17 | |
|||
in = <nowiki>WikiStringCases[{"Sandbox", "Sandbox2"}, "[["~~ShortestMatch[__]~~"]]"]</nowiki> | |
|||
out= <nowiki>{{Sandbox, {[[User:ScottManualRobot|ScottManualRobot]]}}, |
|||
{Sandbox2, {[[3_1]]}}}</nowiki>}} |
|||
<!--END--> |
|||
<!--$$WikiStringReplace[{"Sandbox", "Sandbox2"}, "robotic edit"->"robotic edit (using WikiLink`)]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 18 | |
|||
in = <nowiki>WikiStringReplace[{"Sandbox", "Sandbox2"}, "robotic edit"->"robotic edit (using WikiLink`)]</nowiki> | |
|||
out= <nowiki>$Failed</nowiki>}} |
|||
<!--END--> |
|||
<!--$$WikiGetPageTexts[{"Sandbox", "Sandbox2"}]$$--> |
|||
<!--Robot Land, no human edits to "END"--> |
|||
{{InOut| |
|||
n = 19 | |
|||
in = <nowiki>WikiGetPageTexts[{"Sandbox", "Sandbox2"}]</nowiki> | |
|||
out= <nowiki>{{Sandbox, A robotic edit, by\ |
|||
--[[User:ScottManualRobot|ScottManualRobot]] 14:54, 18 Feb 2006\ |
|||
(EST)}, {Sandbox2, The determinant of the knot [[3_1]] is 3.}}</nowiki>}} |
|||
<!--END--> |
|||
====Troubleshooting==== |
|||
The instruction <code>ShowJavaConsole[]</code> 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. |
|||
WikiLink has known issues on mediawiki 1.5.0. Retrieving multiple pages at once is broken. This appears to be a mediawiki bug, and will not be fixed. The same problem does not occur on mediawiki 1.5.8. --[[User:Scott|Scott]] 10:56, 27 Mar 2006 (EST) |
|||
I expect WikiGetPage text to continue working in mediawiki 1.5 and beyond, because it uses the stable interface [[Special:Export]]. Logging in and setting pages will quite likely break in the next version. If you've tried this, please let me know about your experiences. I'm hoping that soon (1.5?) [[Special:Import]] will become available, and I can switch to using this. --[[User:Scott|Scott]] 15:57, 31 Aug 2005 (EDT) |
|||
====Todo==== |
|||
I'd love to [http://ant.apache.org/manual/develop.html#writingowntask create an Ant task] which allows uploading a file to a wiki. We could then use this in build scripts for KnotTheory, etc. --[[User:Scott|Scott]] 04:07, 17 Sep 2005 (EDT) |
|||
====See Also==== |
|||
All of the Mathematica notebooks in [[:Category:Knot Atlas Maintenance Software]] rely on WikiLink, and so are good examples of how to use it. |
|||
You may also be interested in the Wikipedia page on [http://en.wikipedia.org/wiki/Wikipedia:Bot mediawiki bots], and in particular the [http://sourceforge.net/projects/pywikipediabot/ Python Wikipedia Robot Framework]. |
|||
Revision as of 20:01, 10 May 2006
License
WikiLink.nb, WikiLink.m and wikilink.jar are copyright Scott Morrison, available under your choice of the MIT, Apache or GPL licenses. The other components are copyright by other parties, all available under the Apache license.
