Wiki Monkey is a MediaWiki-compatible bot and editor assistant that can be used directly within wiki pages in the browser as a user script. Currently it is tested on Firefox, Chromium and Opera, but it is very likely to work also on other browsers out of the box or with minor adaptations. Wiki Monkey can also be easily extended through the creation of plugins, exploiting its API.
The project is currently focused on ArchWiki, and as such most plugins address ArchWiki-specific problems.
- 1 Installation
- 2 Configurations table
- 3 Updates
- 4 Tour of the features
- 5 Contributions
- 6 See also
Now just click on the link of one of Wiki Monkey configurations from the "Scriptish/Greasemonkey/Tampermonkey" column in the #Configurations table and your browser should ask you to install it.
Make sure you have installed the Tampermonkey extension.
Just click on the link of one of Wiki Monkey configurations from the "Chromium native" column in the #Configurations table and your browser should ask you to install it.
Now download one of Wiki Monkey configurations from the "Opera" column in the #Configurations table and save it in the folder you've chosen earlier.
This is the table with the predefined configurations: read the section above for instructions on which link you must choose.
|Editor||Provides only manual-editing aid functions in editor pages||install||install||download||download|
|Patrol-Lite||Provides a quick-report function in diff pages||install||install||download||download|
|Patrol||Editor + Patrol-Lite||install||install||download||download|
|Bot||Patrol + automatic operations on list pages||install||install||download||download|
Alternatively, you can create your own configuration.
Open Firefox's Add-ons Manager (Tools -> Add-ons), select User Scripts, right-click on Wiki Monkey and choose Find Updates.
If you want to enable automatic updates, choose Show More Information instead, then set Automatic Updates to On.
Scriptish's perferences are available in Firefox's Add-ons Manager (Tools -> Add-ons), selecting the Extensions tab.
Greasemonkey should enable automatic updates by default, you can check opening Firefox's Add-ons Manager (Tools -> Add-ons), selecting User Scripts, right-clicking on Wiki Monkey and verifying Automatic check for updates is ticked.
Greasemonkey's perferences are available in Firefox's Add-ons Manager (Tools -> Add-ons), selecting the Extensions tab.
Tampermonkey should enable automatic updates by default, you can check opening Tools -> Extensions, selecting Tampermonkey's options, selecting the Settings tab and verifying the settings for Check Interval in the Script Update section.
Chromium's native support for user scripts is rather limited and should not be able to update Wiki Monkey. If you want automatic or semi-automatic updates, it is recommended to use Tampermonkey as described in the Installation section.
Due to how user scripts are installed in Opera, there is currently no way to have automatic or semi-automatic updates, you will have to check periodically and reinstall the script when a new version is released.
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) and tries to fix some.
- Fix headings tries to fix the levels of section headings so that they start from level 2 and do not increase by more than 1 level with relation to the parent section.
- 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.
- Sync interlanguage links * synchronizes the interlanguage links of the edited page with those of its translations.
- Use Template:AUR ** converts direct AUR package links to instances of Template:AUR.
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 Lite", "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 only bundled plugin is Quick report, which adds a row with a link to the visited diff in the specialized table of ArchWiki:Reports.
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 Category of this article: right at the top you will find Wiki Monkey's bot interface, whose usage is explained in the upstream documentation; other pages where you can find the bot are What Links Here pages and many of the list pages linked from Special:SpecialPages. The available plugins for the bot are a regular expression substitution function and a tool for synchronizing the interlanguage links of the pages with those of their translations*. The External links search page also provides a plugin for converting direct AUR package links to instances of Template:AUR**.
* The Chromium-native, Opera and standalone configurations can only synchronize local languages.
** Available only for the Scriptish/Greasemonkey/Tampermonkey configurations.
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.