Manual:Pywikibot/category.py

Scripts to manage categories.

WARNING!!! This needs Python 2.4 (at least?) not 2.3 as stated on Using the python wikipediabot.

Syntax: python category.py [global-arguments] action [-option]

where action can be one of these: * add        - mass-add a category to a list of pages * remove     - remove category tag from all pages in a category * move       - move all pages in a category to another category * tidy       - tidy up a category by moving its articles into subcategories * tree       - show a tree of subcategories of a given category * listify    - make a list of all of the articles that are in a category

and option can be one of these: * -person    - sort persons by their last name (for action 'add') * -rebuild   - reset the database * -from:     - The category to move from (for the move option) Also, the category to remove from in the remove option Also, the category to make a list of in the listify option * -to:       - The category to move to (for the move option) - Also, the name of the list to make in the listify option NOTE: If the category names have spaces in them you may need to use a special syntax in your shell so that the names aren't treated as        separate parameters. For instance, in BASH, use single quotes, e.g. -from:'Polar bears' * -batch     - Don't prompt to delete emptied categories (do it                 automatically). * -summary:  - Pick a custom edit summary for the bot. * -inplace   - Use this flag to change categories in place rather than rearranging them. * -delsum    - An option for remove, this specifies to use the custom edit summary as the deletion reason (rather than a canned                deletion reason) * -overwrite - An option for listify, this overwrites the current page with the list even if something is already there. * -showimages - An option for listify, this displays images rather than linking them in the list. * -talkpages - An option for listify, this outputs the links to talk pages of the pages to be listified in addition to the pages themselves. * -recurse   - Recurse through all subcategories of categories. * -match     - Only work on pages whose titles match the given regex (for                 move and remove actions).

For the actions tidy and tree, the bot will store the category structure locally in category.dump. This saves time and server load, but if it uses these data later, they may be outdated; use the -rebuild parameter in this case.

For example, to create a new category from a list of persons, type: "category.py" 610L, 25644C                                   1,1           Top

If you want to add a category to an existing one you could do the following: category.py move

You will be prompted for the old category (that you also want to keep but enter it) OldCategoryname

Enter the name of the category without the 'Category:' prefix.

You will now be prompted for the new category, now enter the old and new Category like this: NewCategoryName