ArchWiki:ボット
関連記事
ボット は メンテナンスチーム の重要なツールで、日々の業務から複雑な一度限りの更新まで、繰り返しのタスクを簡単に実行することができます。ボットによる編集は wiki への全ての貢献の8%以上を占めています。このような編集は手動で行うにはとても退屈でしょう。
現在以下のボットが使用されています。
- kusakata.bot2 (使用者: kusakata)
目次
ソフトウェア
ボットは MediaWiki API を使って wiki サーバーに接続します。ウィキメディア財団 によって作られた、この API を使うたくさんのボットがありますが、それらは普通他の wiki で使えるように十分一般化されていなかったり、ArchWiki のスタイルガイドと衝突したりします。そのため、ArchWiki 特有のボットツールを作っていますが、外部から評価すると同じ弱点があるでしょう。
Wiki Monkey
Wiki Monkey プロジェクトの目的は、web ブラウザで直接 wiki ページを改良することで効率的な編集を補助することです。ユーザースクリプトとして動作し、編集ページで繰り返しのタスクを半自動で実行したり、カテゴリ や リンク元 といったページリストのページから完全に自動で実行したりできます。Wiki Monkey は 特別:最近の更新 や 特別:新しいページ のためのフィルターといったヘルパーも追加します。詳しくは ドキュメント を参照してください。
wiki-scripts
wiki-scripts プロジェクトは、MediaWiki API のための小さなライブラリのような抽象化で構成されたたくさんの Python スクリプトを含んでいます。含まれているスクリプトの目的は、wiki の編集なしに情報を集めることから、自動化された複雑な編集を行うことにまで及びます。これらは #タスク で説明されています。wiki-script による編集は、自動でも手動でも、wiki-scripts タグ が付けられ、最近の更新のリストで フィルター することができます。
タスク
このセクションでは ArchWiki ボットにより繰り返し実行されるタスクについて説明します。概要と、運用中のボットスクリプトの機能のドキュメントを提供します。ボットの編集は標準で 特別:最近の更新 から隠されていることに注意してください。これらの編集を含めると、通常の貢献を追ったり参加したりすることがかなり難しくなるためです。
二重リダイレクト
二重リダイレクト の修正は最も古い自動化タスクです。Python スクリプト や Wiki Monkey の専用のプラグインで実行することができます。
目次
目次 ページとその "翻訳" は toc.py スクリプトを使って維持されています。スクリプトは毎日実行され、実行は数秒で終わります。
スクリプトは以下のエントリーポイントがページに存在すると仮定します。
{| id="wiki-scripts-toc-table"
...
|}
この表の内容はスクリプトによって生成された更新されたバージョンに置き換えられ、ページの残りはそのままにされます。スクリプトは以下の任意の属性を設定として認識します。
data-toc-languagesはページで表示される言語を指定します。カンマ区切りの言語タグのリストで、最大2つまで指定できます。デフォルトでは現在のページの言語で、例えば en:Table of contents (Русский) ではruとなります。data-toc-alsoinは "also in" フレーズの翻訳を指定します。形式はtag1:text, tag2:text, ...です。
以下は en:Table of contents (Русский) での例です。
{| id="wiki-scripts-toc-table" data-toc-languages="ru,en" data-toc-alsoin="ru:Также в"
...
|}
ユーザーは表の中のカテゴリ名を wiki ページのリンクを編集することで翻訳でき、スクリプトはそれを更新時に維持します。
統計
ArchWiki:統計 ページは statistics.py スクリプトにより更新されています。現在は ユーザー統計 だけが自動生成されていて、残りの部分は手動で更新されています。更新は15秒程度で終わり、毎日実行されています。
スクリプトは全ての版とユーザーアカウントのメタデータを API から取得して、よりよいパフォーマンスのためにローカルにキャッシュすることで動いています。編集回数は MediaWiki のカウンタに頼らずに、手動でユーザーの貢献を数えて決定されています。
パッケージテンプレート
update-package-templates.py スクリプトは全てのページの内容をパースして、Pkg・Grp・AUR テンプレートを更新します。パッケージ名は実際にはスクリプトによって変更されませんが、例えば最近 AUR から公式リポジトリに移動したパッケージは、リンクが テンプレート:AUR から テンプレート:Pkg に更新されます。無効なパッケージリンクには テンプレート:Broken package link が付けられ、パッケージの状態を示す時々便利なヒントも付けられます。
スクリプトは地域化されたバージョンの テンプレート:Broken package link と テンプレート:aur-mirror を存在すれば使い、存在しなければ英語バージョンを使います。これ以外のサーバーサイドの設定は存在しません。
それぞれの実行後に、7日以上の間隔をあけて、スクリプトは en:User:Lahwaacz.bot/Reports/archpkgs にリンク切れの詳細レポートを作成します。
言語間リンク
The interlanguage.py script does the following:
- Checks if the language of categories assigned to each page matches the language of the page itself.
- Creates missing localized categories, mirroring the English category tree.
- Updates the interlanguage links on all content pages using this algorithm.
The execution time depends on the amount of updates, it is usually less than a minute and about 30 seconds when there are no updates.