Extension:TranslationNotifications/翻訳通知

MediaWiki 拡張機能マニュアル

TranslationNotifications リリースの状態: 安定
実装	特別ページ , 通知
説明	翻訳者が登録して翻訳の通知を受信できるようにする
作者	Jon Harald Soby, Amir Aharoni, Santhosh Thottingal, Niklas Laxström, Siebrand Mazeland
最新バージョン	継続的な更新
MediaWiki	1.34+
データベースの変更	いいえ
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (Phabricator · GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
例	translatewiki.net
パラメーター $wgTranslationNotificationsAlwaysHttpsInEmail $wgTranslationNotificationsSignupLegalMessage $wgTranslationNotificationsContactMethods
使用するフック BeforeCreateEchoEvent GetPreferences
四半期ごとのダウンロード数	4 (Ranked 127th)
translatewiki.net で翻訳を利用できる場合は、TranslationNotifications 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

翻訳拡張機能を使用しているウィキでは、翻訳通知拡張機能を使って翻訳者とのコミュニケーションを管理できます。

拡張機能は2部構成です：

翻訳者向け

通知を購読する手続きができるフォームです。翻訳言語、通知を受ける方法（後述）と頻度、ダイジェスト版の要不要を指定します。

翻訳管理者向け

ページ翻訳のお願いを送付できるフォームです。設定された条件に従い、逐次に、あるいはダイジェスト版で翻訳者全員に通知を送ります。

• 
  利用者登録フォーム
• 
  通知フォーム

要件

この拡張機能は、Translate 拡張機能をインストールおよび構成している場合のみ有用です。 It uses the MassMessage extension to leave messages on user's talk pages, so that extension should also be installed.

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のTranslationNotificationsという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TranslationNotifications
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'TranslationNotifications' );
  

• 必要に応じて設定します。
•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

設定

使用できる設定変数は以下のとおりです。

$wgTranslationNotificationsContactMethodsでどの連絡方法を有効にするか設定します。既定値は以下のとおりです。

$wgTranslationNotificationsContactMethods = [
	'email' => true,
	'talkpage' => true,
	'talkpage-elsewhere' => false,
];

特別ページ

Special:TranslatorSignup

この特別ページで翻訳者が登録します。例えばウィキメディアのMeta-wikiにある、特別ページ:翻訳者登録などと同様です。登録者は選択言語（母語、外国語、第2外国語）のほか、メールか個人のトークページか受信の方法を選べます。また共通のCentralAuth基準のウィキファミリーであれば、他のウィキ上のトークページでも受信できます。合わせて受信の頻度として、都度受信（翻訳対象ができるたび毎回）、1週間分もしくは1ヶ月分まとめたダイジェスト版から指定します。ユーザーがメールアドレスの登録確認をした場合のみ、メールでの通知が有効です。

利用者トークページが変更されるとメール通知するよう（他のウィキの個人設定で）選択してある場合、翻訳通知が届くと当然、メールが届きます。そこで重複しないように、翻訳通知はトークページで受け取らず、メールに限定したほうがよいかもしれません。

Special:NotifyTranslators

翻訳管理者が利用するページです。翻訳対象ページがあると通知するために使います（他のメッセージ群の通知はサポート外）。選択肢として〆切や優先順位を設定したり、特別な通信文を追加することができます。あるいは言語で送信先の翻訳者を絞り込むことも可能です。言語指定をしないと、登録した翻訳者全員に通知が届きましす。

このページを運用するには「translate-manage」利用者権限が必須です。 このページを例えばシステム管理者全員が使えるようにするには、LocalSettings.php ファイルの末尾に次の記述を追加します。

$wgGroupPermissions['sysop']['translate-manage'] = true;

通知の環境設定

通知 - メール、ダイジェスト版メール、トークページ通知のいずれも - ジョブキューを介して実行されます。ジョブキューのマニュアルの手順に従い、ジョブキューの実行時間を設定してください。

DigestEmailerスクリプトの設定にはcronジョブを使用する必要があります。例えば、毎週日曜日午前10時に、以下のようなcrontabを使用して実行します。

0 10 * * 7 /usr/bin/php /www/wiki/extensions/TranslationNotifications/scripts/DigestEmailer.php 2>&1 > /var/log/digestEmail.log

スクリプトは直後からメール送信を始めるわけではありません。MediaWikiのジョブキューにメール作業の追加を始めます。メールはジョブキューに設定された工程表どおりに送信されます。