コンテンツにスキップ

Help:Pywikipediabot/category.py

これはこのページの過去の版です。赤の旋律 (会話 | 投稿記録) による 2010年10月17日 (日) 06:17個人設定で未設定ならUTC)時点の版であり、現在の版とは大きく異なる場合があります。

Category.pyはpythonで書かれた、カテゴリ関係の作業を自動で行うためのプログラムです。

文法

次のように記述してください。:

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

[action]には次の物を指定できます。:

* add         - 指定したリストにあるページに指定したカテゴリを付与します。
* remove      - 指定したカテゴリに属するすべてのページからそのカテゴリを除去します。
* move        - 指定したカテゴリに属するすべてのページを他のカテゴリに移動します。
* tidy        - 指定したカテゴリに属するページをサブカテゴリに移動することによって、そのカテゴリを片付けます。
* tree        - 指定したカテゴリのカテゴリツリーを表示します。
* listify     - 指定したカテゴリにあるすべてのページをリスト化します。

[option]には次のものを指定できます。:

* -person     - 姓によって人物をソートします。 (for action 'add')
* -rebuild    - データベースをリセットします。
* -from:      - 移動元のカテゴリを指定します。 (for the move option)
                削除するカテゴリを指定します。(for the remove option)
                リストを作成するカテゴリを指定します。(for the listify option)
* -to:        - 移動先のカテゴリを指定します。(for the move option)
              - 作成するリストの名前を指定します。(for the listify option)
        NOTE: 指定するカテゴリの名前にスペースが入っている場合は、カテゴリ名を引用符で囲んでください。
          ex:)-from:'United States'
* -batch      - 空のカテゴリを自動で削除しないようにします。
* -summary:   - 要約欄に記述する文章を指定します。
* -inplace    - カテゴリを変更する時は、再整理するのではなく、このフラグを使ってください。
* -nodelsum   - 要約欄に、デフォルトで指定されている削除理由を記述します。英語版では、"Category was disbanded" in English."です。(for the remove option)
* -overwrite  - リストを作成する際に、すでにページがあっても、それを上書きしてリストを作成します。
* -showimages - リストを作成するときに、リストからリンクするのではなく、それを直接表示します。
* -talkpages  - リストを作成するときに
* -recurse    - カテゴリのすべてのサブカテゴリに対して再帰呼び出しを行います。
* -match      - 正規表現で与えられた文字列と一致するタイトルのページのみ処理を行います。(for the move and remove option)
* -create     - ページが存在しなかった時、処理をスキップする代わりにそのページを作成します。

[action]にaddを指定した際には、次の引数が使用できます。:

-cat             カテゴリを指定し、そのカテゴリに属するすべてのページにカテゴリを付与するようにします。
                 次のように記述することもできます。"-cat:categoryname" 、もしくは "-cat:categoryname|fromtitle".
-catr            -catと似ていますが、サブカテゴリ、またその下のカテゴリも処理するようにします。
                 次のように記述することもできます。"-catr:categoryname" 、もしくは"-catr:categoryname|fromtitle".
-subcats         指定されたすべてのサブカテゴリで動作します。
                 次のように記述することもできます。 "-subcats:categoryname"、もしくは"-subcats:categoryname|fromtitle".
-subcatsr        -subcatsと似ていますが、サブカテゴリのその下のカテゴリも処理
                 次のように記述することもできます。"-subcatsr:categoryname"、もしくは"-subcatsr:categoryname|fromtitle".
-uncat           カテゴライズされていないすべてのページで動作するよう設定します。
-uncatcat        カテゴライズされていないすべてのカテゴリで動作するよう設定します。
-uncatfiles      カテゴライズされていないすべてのファイルで動作するよう設定します。
-file            テキストファイルからページのリストを読み込みます。ページのタイトルは[]で囲むか、改行によって区切る必要があります。
                 次のように記述することもできます。"-file:filename".
-filelinks       指定したイメージファイル、メディアファイルを使用しているページで動作するよう指定します。
                 次のように記述することもできます。"-filelinks:filename".
-yahoo           Yahoo検索で見つかったページを対象に追加します。処理は、Pythonモジュールの「pYsearch」に依存します。使用するには、config.py の yahoo_appid で設定が必要です。
-search          メディアウィキの検索で見つかったページを対象に追加します。対象は、全名前空間です。
-google          Google検索で見つかったページを対象に追加します。使用するには、config.py の google_key で設定が必要です。
-namespace       処理する名前空間の名前または変数を指定します。複数の名前空間を指定するときはカンマで区切ってください。
-interwiki       
-links           指定したページからリンクしているすべてのページで動作するよう設定します。
                 次のように記述することもできます。"-links:linkingpagetitle".
-new             新しい60ページで動作するよう指定します。-new:xのようにすると、60の代わりにxが指定されます。
-imagelinks      指定したページからリンクしているすべてのイメージファイルで動作するよう指定します。
                 次のように記述することもできます。"-imagelinks:linkingpagetitle".
-newimages       新しい100イメージファイルで動作するよう指定します。-newimages:xのようにすると、100の代わりにxが指定されます。
-ref             指定したページにリンクするすべてのページで動作するよう設定します。
                 次のように記述することもできます。"-ref:referredpagetitle".
-start           
-prefixindex     Work on pages commencing with a common prefix.
-titleregex      正規表現で与えられた文字列と一致するタイトルのページで動作するよう設定します。
-transcludes     指定したテンプレートを使用しているすべてのページで動作するよう設定します。
                 次のように記述することもできます。"-transcludes:Template:Title".
-unusedfiles     使われていないイメージファイル、メディアファイルの解説ページで動作するよう設定します。
                 次のように記述することもできます。"-unusedfiles:n" nは動作するページの最大数です。
-unwatched       閲覧のないページで動作するよう設定します。
                 次のように記述することもできます。"-unwatched:n" nは動作するページの最大数です。
-usercontribs    指定した利用者によって編集されたすべてのページで動作するよう設定します。
                 ex:) -usercontribs:DumZiBoT
-weblink         指定した外部リンクにリンクするすべての記事で動作するよう設定します。
-withoutinterwiki 内部リンクを持たないすべてのページで動作するよう設定します。
                 次のように記述することもできます。"-withoutinterwiki:n" nには2桁の数を指定してください。
-random         Special:Randomから返ってきたページで動作するよう設定します。
                 次のように記述することもできます。"-random:n" nは返されるページの数です。指定がない場合、10が指定されます。
-randomredirect  Special:Randomredirectから返ってきたすべてのページで動作するよう設定します。
                 次のように記述することもできます。"-randomredirect:n"nは返されるページの数です。指定がない場合、10が指定されます。
-gorandam        Specifies that the robot should starting at the random pages
                 returned by Special:Random.
-recentchanges   Work on new and edited pages returned by Special:Recentchanges.
                 Can also be given as "-recentchanges:n" where n is the number
                 of pages to be returned, else 100 pages are returned.
-redirectonly    Work on redirect pages only, not their target pages.
                 The robot goes alphabetically through all redirect pages
                 on the wiki, starting at the named page. The
                 argument can also be given as "-redirectonly:pagetitle".
                 You can also include a namespace. For example,
                 "-redirectonly:Template:!" will make the bot work on
                 all redirect pages in the template namespace.

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.


Or to do it all from the command-line,

See also