Wikipedia:AutoWikiBrowser/Kingbotk plugin/User guide: Difference between revisions

Revision as of 10:44, 11 September 2006

Latest revision as of 17:54, 12 February 2020

(30 intermediate revisions by 8 users not shown)

Line 1:

{{Wikipedia:AutoWikiBrowser/Kingbotk plugin/Template}}

[[Image:WPBiography.jpg|right]]This is the user guide for [[User:Kingbotk/Plugin|my AWB WikiProject templating plugin]]. Please note that "the plugin" is really a ''set'' of plugins in one [[dynamic link library|DLL]] - one plugin per WikiProject template, and a plugin manager which interracts with [[WP:AWB|AWB]].

==Downloading and installing==

#[[User:Kingbotk/Plugin#Downloading_and_using_the_plugin|Download]] AWB and extract the pluginzipfile to a folder of your choice.

#Move or copy the file "Kingbotk AWB Plugin.dll" from the Plugins subfolder into the top AWB folder (the same folder as "AutoWikiBrowser.exe").

#'''Add [[User:Kingbotk/Plugin]] to your watchlist''' and sign onto the [[User:Kingbotk/Plugin#Mailing_list.2Fuser_list|mailing list]] so you can get updates.

#If you've downloaded the complete package (AWB and plugin), extract it all to a new folder. If you've just downloaded the plugin extract it into your AWB folder.

#Start AWB as normal.

#You will now have several new menu items:

#*Plugins menu. This contains a list of the plugins which are available - just click the plugin name to enable it. ''(Currently only one plugin is available, "Biography plugin").'' Be careful to select only one plugin at a time unless you really ''do'' want to tag talk pages on behalf of more than one WikiProject at a time (e.g. tagging military biographies with both {{tl|WPBiographyWikiProject Biography}} and {{tl|WPMILHISTWikiProject Military history}}).

#*"Kingbotk Plugin" submenu under Plugins. This contains general configuration for the plugin manager and other options which relate to all of the individual templating plugins. ''Some items here are not enabled or implemented yet''.

#*"Show settings tab" under General. Select this to hide all settings tabs. (But enable a plugin first!)

#*New items under the Help menu.

#*Plugins menu. This contains a list of the plugins which are available - just click the plugin name to enable it. ''(Currently only one plugin is available, "Biography plugin").'' Be careful to select only one plugin at a time unless you really ''do'' want to tag talk pages on behalf of more than one WikiProject at a time (e.g. tagging military biographies with both {{tl|WPBiography}} and {{tl|WPMILHIST}}).

#*"Kingbotk Plugin" submenu under Plugins. This contains general configuration for the plugin manager and other options which relate to all of the individual templating plugins. ''Some items here are not enabled or implemented yet''.

==Configuration==

[[File:Kingbotk plugin manager tab.png|right]]

You do '''not''' have to follow these steps in this order, just do all of them before clicking Start:

#Turn off all AWB features such as "auto-tag", "skip empty pages" etc. <!--(or click Plugins\Kingbotk Plugin\Set AWB (''not yet implemented))-->

#Optionally, set the AWB edit summary (make it ''very'' short, as the plugin will append its own edit summary)

#Turn on the plugin(s) for the WikiProject template(s) you wish to add

#You'll now have a number of additional tabs on the main console, to the right of the "(3) Start" tab, as per the first screenshot

#In the template plugin tabs, select the parameters you want to add or change

#Click the plugin tab. If and only if you are working through a category and/or its subcategories, enter the category name in the box provided. This will be added to the edit summary.

#Click Plugins\Kingbotk Plugin\Logging and select your options. I recommend turning on verbose logging and logging problematic pages (bad tags), and logging to ''either'' wiki format (if you want to upload to wiki) ''or'' [[XHTML]] for viewing in a web browser. You ''can'' select ''both'' or ''neither'', if you prefer.

#If you're done with your settings you can now uncheck General\Show settings tabs and all tabs apart from the Plugin tab will disappear.

#Save your settings so you can use them again. The plugin settings get saved too.

#Build your article list (and save it to file if large)

For generic templates, see [[User:Kingbotk/Plugin/Generic_WikiProject_templates#My_WikiProject.27s_template_is_generic.2C_how_do_I_configure_the_plugin.3F|here]].

==Tagging==

Hold your breath and click Start.

*The plugin displays article statistics (leeched from AWB) and keeps a running count of how many articles it has tagged, how many it has skipped, how many were new pages, how long the tagging process has been running, how many pages have been successfully saved, and the number of seconds per successful save.

*The plugin can recognise incorrectly formatted ("bad") templates; it does this by first searching for ''valid'' templates (and trapping any strangeness) and then running a "second chance" expression to search for any invalid instances which have been missed. These can be optionally logged and the list uploaded onto wiki so that the offending templates can be manually edited.

*If you want to do other work with AWB, just disable the plugins using the Plugin menu. There's no need to uninstall the .dll file.

*Use this software wisely and please [[User talk:Kingbotk/Plugin|report]] any issues or bugs.

==Wikipedia Assessments==

*Install and configure the plugin as above

*Build a list of articles for review (mainspace articles ''only'')

*Check-mark the assess box on the plugin tab

*Click "start the process". The first page will be loaded.

*Click ignore after viewing article and the talk page will be loaded

*Make your assessment and click Ok to save it, or Skip to make no assessment.

==Configuring and using Generic WikiProject templates==

*See [[User:Kingbotk/Plugin/Generic WikiProject templates]]

[[Category:AutoWikiBrowser plugins|Kingbotk Plugin User Guide]]