VisualEditor/Diffs/ja

ビジュアルエディターは2017年版から機能をインターフェイスの2箇所で提供しています. 保存前に変更点を確認する時のほか、(ベータ版機能として) 編集履歴のページで標準の MediaWiki の差分表示で利用できます. いずれの場合も差分の表示は差分の視覚化 (visual diffs) か従来の2列の差分表示 (wikitext diff) か、切り替えることができます. These are available in two places in the interface: when previewing changes to the document before the user saves the page, and (as a beta feature) within the standard MediaWiki diff display, accessed from the history page. In both cases, the visual diff shows up alongside the traditional two-column wikitext diff, and the user can toggle between the two displays.

ウィキ文よりも視覚化表示の方が優れている点は主に2つあります. 第1に編集者はウィキ文を理解しなくても、直感的に自分やほかの人が行った変更を確認できます. 文章以外の編集を見る時、例えば表からどの列を削除したか確かめるとします. 差分をウィキ文で表示すると煩雑ですが、視覚化表示ならパッと見て判別しやすくなります. (訳注：視覚化表示でもテンプレート内のタグや文字列の変更は個別に表示せず、テンプレート全体が変更箇所として表示されます) The first is that editors can directly see the changes they and others have made without needing to understand wikitext. This is particularly helpful when looking at changes to graphical structures such as tables; for example, if an edit deletes a column from a table, the wikitext diff for it would be hard to understand, while the visual diff would be immediately obvious.

第2に、この技術を使用すると変更点をより正確に読者に示せます. 一例として、視覚化表示ではふたつの段落を入れ換えた編集は (文字の変更の有無は問わない) そのまま読者に伝わりますが、ウィキ文では特定の文を削除し、まったく新しい文を挿入した表示になり、まるで2つの作業が発生したように見えるのです. For example, if an edit swapped two paragraphs (with or without changes to the paragraphs), the visual diff will identify that this is what occurred, while a wikitext diff makes it appear that a paragraph was deleted and an entirely new paragraph was added.

標準の差分表示ページ
下記の例やサンプル画像の大半は差分の視覚化機能がどう作用するか、ビジュアルエディタを利用して編集中にプレビューした状態を扱っています. しかしながらウィキにビジュアルエディタがインストール済みであれば、標準の差分表示ページでもこの機能を利用できます. その使用例は英語版ウィキペディアのこちらのページを参照してください. However, VisualEditor's visual diffs can also be used on regular diff pages, on any wiki that has VisualEditor installed. You can see an example of it in use on the English-language Wikipedia here.

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


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

動作の仕組み
[[File:VisualEditor_visual_diff_tool_-_visual_diff.png|alt=記事の変更点を示す画面キャプチャ. ウィキ書式で表示された部分が多い. |left|thumb|300px|ページの編集が終わったら、編集要約欄にまとめを書き、「」を押す.

ビジュアルモードでは追加・削除、リンクの追加、書式が強調表示される. 画像の大きさなど、その他の変更はそばに注記される. ]]





技術



 * Google Diff, Match and Patch
 * TreeDiffer.js

現在の制限事項

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

History
このデスクトップ版ビジュアルエディターの機能は、一次的 (標準の) 差分表示ツールとして 1.31.0-wmf-20 ブランチで実装しています (2018年2月6日付けでウィキメディア製品群に展開). 従来は副次的 (オプションの) ツールとして1.29.0-wmf-17 ブランチで提供しました (2017年3月21日付けでウィキメディア製品群に展開). Before that, it was a secondary tool from the 1.29.0-wmf-17 branch onwards (released to Wikimedia production on 21 March 2017).

関連項目

 * 2016 Community Wishlist Survey/Categories/Reading#CW2016-R094
 * Community Tech/Improved diffs