「ArchWiki:ボット」の版間の差分

2021年12月22日 (水) 17:07時点における最新版

ヘルプ:操作手順

ボットはメンテナンスチームの重要なツールで、日々の業務から複雑な一度限りの更新まで、繰り返しのタスクを簡単に実行することができます。ボットによる編集は wiki への全ての貢献の8%以上を占めています。このような編集は手動で行うにはとても退屈でしょう。

現在以下のボットが使用されています。

kusakata.bot2 (使用者: kusakata)

ソフトウェア

ボットは MediaWiki API を使って wiki サーバーに接続します。ウィキメディア財団によって作られた、この API を使うたくさんのボットがありますが、それらは普通他の wiki で使えるように十分一般化されていなかったり、ArchWiki のスタイルガイドと衝突したりします。そのため、ArchWiki 特有のボットツールを作っていますが、外部から評価すると同じ弱点があるでしょう。

Wiki Monkey

Wiki Monkey プロジェクトの目的は、web ブラウザで直接 wiki ページを改良することで効率的な編集を補助することです。ユーザースクリプトとして動作し、編集ページで繰り返しのタスクを半自動で実行したり、カテゴリやリンク元といったページリストのページから完全に自動で実行したりできます。Wiki Monkey は特別:最近の更新や特別:新しいページのためのフィルターといったヘルパーも追加します。詳しくはドキュメントを参照してください。

Wiki Monkey のボットインターフェースによって行われた編集は、wiki-monkey タグが付けられ、最近の更新リストでフィルターすることができます。

ノート: 2021-12-22 時点で wiki.archlinux.jp では Wiki Monkey は動作しません。

wiki-scripts

wiki-scripts プロジェクトは、MediaWiki API のための小さなライブラリのような抽象化で構成されたたくさんの Python スクリプトを含んでいます。含まれているスクリプトの目的は、wiki の編集なしに情報を集めることから、自動化された複雑な編集を行うことにまで及びます。これらは #タスクで説明されています。wiki-script による編集は、自動でも手動でも、wiki-scripts タグが付けられ、最近の更新のリストでフィルターすることができます。

タスク

このセクションでは ArchWiki ボットにより繰り返し実行されるタスクについて説明します。概要と、運用中のボットスクリプトの機能のドキュメントを提供します。ボットの編集は標準で特別:最近の更新から隠されていることに注意してください。これらの編集を含めると、通常の貢献を追ったり参加したりすることがかなり難しくなるためです。

二重リダイレクト

二重リダイレクトの修正は最も古い自動化タスクです。Python スクリプトや Wiki Monkey の専用のプラグインで実行することができます。

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 のカウンタに頼らずに、手動でユーザーの貢献を数えて決定されています。

ノート: いくつかの改善が en:ArchWiki talk:Statistics#Improvements で議論されています。

パッケージテンプレート

update-package-templates.py スクリプトは全てのページの内容をパースして、Pkg・Grp・AUR テンプレートを更新します。パッケージ名は実際にはスクリプトによって変更されませんが、例えば最近 AUR から公式リポジトリに移動したパッケージは、リンクがテンプレート:AUR からテンプレート:Pkg に更新されます。無効なパッケージリンクにはテンプレート:Broken package link が付けられ、パッケージの状態を示す時々便利なヒントも付けられます。

スクリプトは地域化されたバージョンのテンプレート:Broken package link を存在すれば使い、存在しなければ英語バージョンを使います。これ以外のサーバーサイドの設定は存在しません。

それぞれの実行後に、7日以上の間隔をあけて、スクリプトは en:User:Lahwaacz.bot/Reports/archpkgs にリンク切れの詳細レポートを作成します。

言語間リンク

interlanguage.py スクリプトは以下を実行します。

言語カテゴリが、ページの言語と一致するページに付与されているか確認します。
存在しない地域化カテゴリを作成して、英語カテゴリツリーと同期します。
全てのページの言語間リンクをこのアルゴリズムを使って更新します。

実行時間は編集の量によって変化しますが、通常1分以内に終わり、編集がなければ30秒程度で終わります。

ページの言語

update-page-language.py スクリプトは、それぞれのページの言語をタイトルに基づいて判断して (ヘルプ:i18n#ページのタイトルを参照)、wiki のデータベースに言語コードをセットします。これは MediaWiki の $wgPageLanguageUseDB 設定により可能になります [1]。

リンクのチェック

extlink-checker.py は外部リンクの状態を確認して、確実に壊れているリンクを Template:Dead link でマークします。主に Javascript を必要とするサイトと、確実に判定できない HTTP ステータスコードを返すサーバーが原因で、多くのリンクはこのツールで確認されないままになります。
url-replace.py は、URL の HTTP から HTTPS への更新や、wiki.archlinux.org への外部リンクを内部リンクに置き換えるなどの、外部リンクの様々な置き換えを実行します。
link-checker.py は、内部リンク、マニュアルページへのリンク、外部リンク (url-replace.py と同じコードを使用) の様々な確認と置き換えを実行します。
mark-archived-links.py は、ArchWiki:アーカイブへの内部リンクを Template:Archived page でマークします。

翻訳ステータス: このページは en:ArchWiki:Bots の翻訳バージョンです。最後の翻訳日は 2021-09-07 です。もし英語版に変更があれば、翻訳の同期を手伝うことができます。

@@ 5行目: / 5行目: @@
 {{Related|ヘルプ:操作手順}}
 {{Related articles end}}
 [[w:Bots|ボット]] は [[ArchWiki:メンテナンスチーム|メンテナンスチーム]] の重要なツールで、日々の業務から複雑な一度限りの更新まで、繰り返しのタスクを簡単に実行することができます。ボットによる編集は wiki への全ての貢献の8%以上を占めています。このような編集は手動で行うにはとても退屈でしょう。
@@ 19行目: / 18行目: @@
 [https://github.com/kynikos/wiki-monkey Wiki Monkey] プロジェクトの目的は、web ブラウザで直接 wiki ページを改良することで効率的な編集を補助することです。ユーザースクリプトとして動作し、編集ページで繰り返しのタスクを半自動で実行したり、[[特別:カテゴリ|カテゴリ]] や [[特別:リンク元|リンク元]] といったページリストのページから完全に自動で実行したりできます。Wiki Monkey は [[特別:最近の更新]] や [[特別:新しいページ]] のためのフィルターといったヘルパーも追加します。詳しくは [https://github.com/kynikos/wiki-monkey/wiki ドキュメント] を参照してください。
+Wiki Monkey のボットインターフェースによって行われた編集は、{{ic|wiki-monkey}} [[特別:タグ一覧|タグ]] が付けられ、最近の更新リストで [{{canonicalurl:Special:RecentChanges|hidebots=0&tagfilter=wiki-monkey}} フィルター] することができます。
+{{Note|2021-12-22 時点で wiki.archlinux.jp では Wiki Monkey は動作しません。}}
 === wiki-scripts ===
-[https://github.com/lahwaacz/wiki-scripts wiki-scripts] プロジェクトは、MediaWiki API のための小さなライブラリのような抽象化で構成されたたくさんの Python スクリプトを含んでいます。含まれているスクリプトの目的は、wiki の編集なしに情報を集めることから、自動化された複雑な編集を行うことにまで及びます。これらは [[#タスク]] で説明されています。wiki-script による編集は、自動でも手動でも、{{ic|wiki-scripts}} [[特別:タグ一覧|タグ]] が付けられ、最近の更新のリストで [https://wiki.archlinux.jp/index.php?title=特別:最近の更新&hidebots=0&tagfilter=wiki-scripts フィルター] することができます。
+[https://github.com/lahwaacz/wiki-scripts wiki-scripts] プロジェクトは、MediaWiki API のための小さなライブラリのような抽象化で構成されたたくさんの Python スクリプトを含んでいます。含まれているスクリプトの目的は、wiki の編集なしに情報を集めることから、自動化された複雑な編集を行うことにまで及びます。これらは [[#タスク]] で説明されています。wiki-script による編集は、自動でも手動でも、{{ic|wiki-scripts}} [[特別:タグ一覧|タグ]] が付けられ、最近の更新のリストで [{{canonicalurl:特別:最近の更新|hidebots=0&tagfilter=wiki-scripts}} フィルター] することができます。
 == タスク ==
@@ 36行目: / 39行目: @@
 [[目次]] ページとその "翻訳" は [https://github.com/lahwaacz/wiki-scripts/blob/master/toc.py toc.py] スクリプトを使って維持されています。スクリプトは毎日実行され、実行は数秒で終わります。
-スクリプトは以下のエントリーポイントがページに存在すると仮定します。
+ページは以下のエントリーポイントの表で手作業で初期化する必要があります。
 {{bc|<nowiki>
 {| id="wiki-scripts-toc-table"
-...
 |}
 </nowiki>}}
@@ 71行目: / 73行目: @@
 [https://github.com/lahwaacz/wiki-scripts/blob/master/update-package-templates.py update-package-templates.py] スクリプトは全てのページの内容をパースして、[[テンプレート:Pkg|Pkg]]・[[テンプレート:Grp|Grp]]・[[テンプレート:AUR|AUR]] テンプレートを更新します。パッケージ名は実際にはスクリプトによって変更されませんが、例えば最近 AUR から公式リポジトリに移動したパッケージは、リンクが [[テンプレート:AUR]] から [[テンプレート:Pkg]] に更新されます。無効なパッケージリンクには [[テンプレート:Broken package link]] が付けられ、パッケージの状態を示す時々便利なヒントも付けられます。
-スクリプトは地域化されたバージョンの [[テンプレート:Broken package link]] と [[テンプレート:aur-mirror]] を存在すれば使い、存在しなければ英語バージョンを使います。これ以外のサーバーサイドの設定は存在しません。
+スクリプトは地域化されたバージョンの [[テンプレート:Broken package link]] を存在すれば使い、存在しなければ英語バージョンを使います。これ以外のサーバーサイドの設定は存在しません。
 それぞれの実行後に、7日以上の間隔をあけて、スクリプトは [[:en:User:Lahwaacz.bot/Reports/archpkgs]] にリンク切れの詳細レポートを作成します。
@@ 77行目: / 79行目: @@
 === 言語間リンク ===
-The [https://github.com/lahwaacz/wiki-scripts/blob/master/interlanguage.py interlanguage.py] script does the following:
+[https://github.com/lahwaacz/wiki-scripts/blob/master/interlanguage.py interlanguage.py] スクリプトは以下を実行します。
+* 言語カテゴリが、ページの言語と一致するページに付与されているか確認します。
+* 存在しない地域化カテゴリを作成して、英語カテゴリツリーと同期します。
+* 全てのページの [[Help:I18n#言語間リンク|言語間リンク]] を [https://lahwaacz.github.io/wiki-scripts/ws/ws.interlanguage.InterlanguageLinks.html このアルゴリズム] を使って更新します。
+実行時間は編集の量によって変化しますが、通常1分以内に終わり、編集がなければ30秒程度で終わります。
+=== ページの言語 ===
+[https://github.com/lahwaacz/wiki-scripts/blob/master/update-page-language.py update-page-language.py] スクリプトは、それぞれのページの言語をタイトルに基づいて判断して ([[ヘルプ:i18n#ページのタイトル]] を参照)、wiki のデータベースに言語コードをセットします。これは MediaWiki の [[mw:Manual:$wgPageLanguageUseDB|$wgPageLanguageUseDB]] 設定により可能になります [https://github.com/archlinux/archwiki/pull/39]。
+=== リンクのチェック ===
+* [https://github.com/lahwaacz/wiki-scripts/blob/master/extlink-checker.py extlink-checker.py] は外部リンクの状態を確認して、確実に壊れているリンクを [[Template:Dead link]] でマークします。主に Javascript を必要とするサイトと、確実に判定できない HTTP ステータスコードを返すサーバーが原因で、多くのリンクはこのツールで確認されないままになります。
-* Checks if the language of categories assigned to each page matches the language of the page itself.
+* [https://github.com/lahwaacz/wiki-scripts/blob/master/url-replace.py url-replace.py] は、URL の HTTP から HTTPS への更新や、wiki.archlinux.org への外部リンクを内部リンクに置き換えるなどの、外部リンクの様々な置き換えを実行します。
-* Creates missing localized categories, mirroring the English category tree.
+* [https://github.com/lahwaacz/wiki-scripts/blob/master/link-checker.py link-checker.py] は、内部リンク、マニュアルページへのリンク、外部リンク ({{ic|url-replace.py}} と同じコードを使用) の様々な確認と置き換えを実行します。
-* Updates the [[Help:I18n#言語間リンク|interlanguage links]] on all content pages using [http://lahwaacz.github.io/wiki-scripts/ws/ws.interlanguage.InterlanguageLinks.html this algorithm].
+* [https://github.com/lahwaacz/wiki-scripts/blob/master/mark-archived-links.py mark-archived-links.py] は、[[ArchWiki:アーカイブ]] への内部リンクを [[Template:Archived page]] でマークします。
+{{TranslationStatus|ArchWiki:Bots|2021-09-07|694341}}
-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.