ビジュアルエディター/差分

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page VisualEditor/Diffs and the translation is 100% complete.

Other languages:
English • ‎dansk • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎čeština • ‎русский • ‎српски / srpski • ‎українська • ‎日本語

ビジュアルエディターは2017年版から差分の視覚化機能 visual diffs をインターフェイスの2箇所で提供しています。保存前に変更点を確認する時のほか、 (ベータ版として) 編集履歴のページで標準の MediaWiki の差分表示で利用できます。いずれの場合も差分の表示は差分の視覚化 (visual diffs) か従来の2列の差分表示 (wikitext diff) か、切り替えることができます。

ウィキ文よりも視覚化表示の方が優れている点は主に2つあります。第1に編集者はウィキ文を理解しなくても、直感的に自分やほかの人が行った変更を確認できます。文章以外の編集を見る時、例えば表からどの列を削除したか確かめるとします。差分をウィキ文で表示すると煩雑ですが、視覚化表示ならパッと見て判別しやすくなります。(訳注:視覚化表示でもテンプレート内のタグや文字列の変更は個別に表示せず、テンプレート全体が変更箇所として表示されます)

第2に、この技術を使用すると変更点をより正確に読者に示せます。一例として、視覚化表示ではふたつの段落を入れ換えた編集は (文字の変更の有無は問わない) そのまま読者に伝わりますが、ウィキ文では特定の文を削除し、まったく新しい文を挿入した表示になり、まるで2つの作業が発生したように見えるのです。

このデスクトップ版ビジュアルエディタの機能は、一次的 (標準の) 差分表示ツールとして 1.31.0-wmf-20 分岐で実装しています (2018年2月6日付けでウィキメディア製品群に展開)。従来は副次的 (オプションの) ツールとして1.29.0-wmf-17 分岐で提供しました (2017年3月21日付けでウィキメディア製品群に展開)。

標準の差分表示ページ

下記の例やサンプル画像の大半は差分の視覚化機能がどう作用するか、ビジュアルエディタを利用して編集中にプレビューした状態を扱っています。しかしながらウィキにビジュアルエディタがインストール済みであれば、標準の差分表示ページでもこの機能を利用できます。その使用例は英語版ウィキペディアのこちらのページを参照してください。

ビジュアルエディタを導入済みのウィキでは、差分の視覚化機能を有効にする方法が複数あります。

  • LocalSettings.php に以下の記述を追加:
$wgVisualEditorEnableDiffPage = true;
  • もしご利用のウィキで「特別ページ:個人設定」に「ベータ版」のタブがあり、どの利用者にも「既定で」差分視覚化表示を使ってほしい場合にはLocalSettings.php に以下の記述を追加します。
$wgVisualEditorEnableDiffPageBetaFeature = true;
  • ページの差分を表示させ、URL欄の末尾に「&visualdiff」と加筆すると、上記のウィキペディアの事例で示したように差分を視覚化して表示できます。

動作の仕組み

記事の変更点を示す画面キャプチャ。ウィキ書式で表示された部分が多い。
ページの編集が終わったら、編集要約欄にまとめを書き、「Review your changes」を押す。 ビジュアルモードでは追加・削除、リンクの追加、書式が強調表示される。画像の大きさなど、その他の変更はそばに注記される。


編集画面をビジュアルからウィキテキストに切り替えるボタン。画面はビジュアル編集を選択した状態。
編集画面をビジュアルからウィキテキストに切り替えるボタン。画面はビジュアル編集を選択した状態。


ウィキテキストの差分表示の画面キャプチャ。編集の作業の前後を、左右の2欄で見比べることができる。
この差分表示ツールは、ウィキテキストのエディタ(編集機能)および編集履歴の表示で用いるものと同じ。


使用例

技術

編集と差分表示の統一を解説するThalia Chan(2017年ウィキマニアにて)

現在の制限事項

  • 「不可視な」ページのメタデータ にカテゴリあるいは目次のキーワードが編集されても、変更通知は送信しません。
  • 表組みに複雑な変更を加えると正しく表示されない事例が発生しています。[3]
  • 特定の特別ページでは次の機能が使えません。
    • 「差分」ページの編集巻き戻し。[4]
    • ページの編集で衝突が起きたかどうか[5]

関連項目

脚注