Difference between revisions of "Wiki Monkey"
m (→Contributions: move link)
m (moved User:Kynikos/Wiki Monkey to Wiki Monkey: now the article is ArchWiki-centered, the extraneous information has been moved to the project's wiki on github)
Revision as of 11:51, 2 March 2012
Category:ArchWiki Tools << enable category!
Wiki Monkey is a MediaWiki-compatible bot and editor assistant that can be used directly within wiki pages in the browser. Wiki Monkey is run as a Scriptish script for Firefox and can be easily extended through the creation of plugins, exploiting its high-level API.
The project is currently focused on ArchWiki, and as such most plugins address ArchWiki-specific problems.
Now just click on the link of one of the following Wiki Monkey configurations and Firefox should ask you to install it:
- Editor: provides manual-editing aid functions in editor pages, like automatic style fixes
- Patrol: Editor + quick-report functions in diff pages
- Bot: Patrol + automatic operations on list pages
Otherwise you can create your own configuration.
If you want to enable automatic updates, open Firefox's Add-ons Manager (Tools -> Add-ons), select User Scripts, right-click on Wiki Monkey and choose Show More Information, then set Automatic Updates to On.
Tour of the features
After installing the desired version of Wiki Monkey, start visiting the editor of this very page, you will find Wiki Monkey's interface right below the Save page button row. As you can see there are some buttons, each of which will execute a plugin action (see Bundled plugins for detailed information):
- Fix header reorders the elements in the header, warns about possible problems (e.g. lack of category), adds Template:i18n if it is missing and so on.
- Use code templates replaces
<tt>with Template:bc and Template:ic, taking care of adding numbered parameters or
<nowiki>tags when necessary.
- Expand contractions expands some common English contractions, e.g. "don't" becomes "do not".
- Multiple line breaks compresses multiple empty lines into one.
- RegExp substitution lets you perform a regular expression substitution.
By pressing one of them, the text in the editor will be modified, but note that the page will not be saved, so you will still be able to see the diff or the preview and perform other modifications manually. The Execute row and Execute all buttons are used to execute more plugins one after the other, thus saving some clicks.
At the bottom of Wiki Monkey's interface you will always find the log area, on dark background, where Wiki Monkey and its plugins will output their messages.
Now, if you have installed the "patrol" or "bot" configuration, visit Special:RecentChanges and select a diff from the list: right below the diff panes you will find Wiki Monkey's interface. Here the bundled plugins are:
- Quick report adds a row with a link to the visited diff in a specialized table of a predefined article, see User:Kynikos/RC Patrol for an example.
- Save discussion does pretty much the same thing in another article but with less details, and can be useful to save a discussion for replying later, see User:Kynikos/Discussions for an example.
At this point, if you have installed the "bot" configuration, visit Special:SpecialPages: at the top of the page you will find those plugins that have a generic purpose and are not based on a specific page: the only currently available plugin is a function to update Table of Contents pages.
Finally, if you have installed the "bot" configuration, visit the What Links Here page of this article: right at the top you will find Wiki Monkey's bot interface, whose usage is explained in the upstream documentation. The only currently available plugin is a regular expression substitution function.
Of course any help in the resolution of bugs or the development of new plugins is appreciated: if you are interested, send an email to the original author (or use his talk page) and urge him to finally complete the documentation about the development of plugins, which is actually quite straightforward.