Manual:Echo

From mediawiki.org
This page is a translated version of the page Manual:Echo and the translation is 100% complete.

Extension:Echo は MediaWiki 用の通知システムのひとつです。

言及

Echo を使い、議論で言及した利用者に通知を送ります。通称ピンを送る、「pinging」などと表現します。 署名入りのメッセージで、直接またはテンプレートを介して、利用者ページにリンクすると、その相手に言及が通知されます。 以下に技術的な構造を説明します。

技術的な詳細

言及イベントを生成するとき、Echo は版の差分を固まりごとに処理していき、新規コメントの中から言及されている利用者を検索します。これを執筆している時点では、利用者への言及の通知が成功する条件は以下の通りです:

  • 差分の固まりは既存の行の変更ではなく、新しい行の文章の追加として認識される必要があります。
  • 利用者がメッセージに署名する必要があります。[1]
    • 署名はプレーンなウィキリンク ([[ ]]) のみを含み、ローカルのウィキにある利用者ページ、利用者トークページ、または投稿記録ページにリンクする必要があります。署名はテンプレートに埋め込むことはできません。[2]
    • 署名を認識するには、投稿が ~~~ (および ~~~~) を記入して得られる結果と正確に一致するマークアップを含む必要があります。[3]
  • コメントが既存のセクションに完全に属するか(追加行の差分の固まりが新しいセクション見出しを含まない)[4][5]、もしくは新しいセクションを開始する(差分の固まりが新しいセクション見出しから始まる)必要があります。[6][7] 見出しレベル 2 以上のセクションのみ集計します。[8]
  • 差分はテンプレート展開するため、言及する利用者ページへのリンクはテンプレートを使っても直接リンクでも成立します。[9]
    • 変数のうち{{REVISIONID}}{{REVISIONUSER}}はEcho が差分を解析するときに空の文字列に展開します。
  • もし言及相手の数が上限値50を超過すると、言及は誰にも発信しません。[10]

また、すべてのマークアップは正規表現で構文解析され、マークアップに凝りすぎると予想外の結果が起きがちです。

脚注