Meta:category.py

From DIYinfo.org

Jump to: navigation, search

Scripts to manage categories.

NOTE!!! PLEASE NOTE THAT THE FOLLOWING ARTICLE IS FOR AUTHORS WITH ADMIN PRIVILEGES ONLY

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
Personal tools