2017 wikitext editor/ja

ウィキテキスト エディター 2017 は、Extension:VisualEditor 内のモードの1つであり、利用者がウィキテキストのソースコードを編集する際に、ビジュアルエディターのツールを使用できるようにします. ビジュアルエディター内のツールバーでウィキテキストに切り替えるボタンをクリックすることで、この機能にアクセスできます.

ウィキメディアのウィキ群では、個人設定のデスクトップ向けのベータ版機能に遷移することで、この機能を有効にできます.

概要
「現在のコンテンツの作成と整理のインターフェイスを維持し、改善していく」という2016-2017年の年間計画の目標のひとつを支援するため、編集委員会は新しいウィキテキスト エディターに取り組んでいます.

2つのモードの切り替えを改善するため、ビジュアルエディターに統合されています. ビジュアルエディターと似たデザインであり、citoid 機能をはじめビジュアルエディターの数多くの機能も備えています. 新ウィキエディターはデスクトップ用ベータ版から使えます. ファブリケーターのリンクはT104479で「modern wikitext editor」や 「new wiki text editor」、NWEとも呼んでいます.

これは「新しい」エディターであって従来のものの改善ではありません. ベータ版は、突然の改訂で編集者を混乱させたり既存のガジェットを壊したりないように、利用者からバグの報告を受け付ける期間を設けます.

このプロジェクトの根拠
2010年、ウィキメディア財団は使いやすさプロジェクトを完了して（おかげで現状のVectorスキンとアップロードツールとエディタが提供されました）、2010－2015年戦略計画でコミュニティによって選ばれた問題点の改善へ乗り出しました. 戦略計画には通知等の他に編集ツール、特にビジュアルエディターの改善点が多く含まれていました. しかしこれまでも当面も、ウィキテキストを廃止する計画はありません. ビジュアルエディターは従来のソース編集を代用するものでは決してなく、長い目で見ると、コミュニティにとってどちらの編集方法もウィキメディアのプロジェクト群の成功に欠かせないものです.

2016年12月時点では、ウィキメディアのほぼすべてのウィキ群で、3つの主要なエディタを提供しています. 利用者にとって、それらの外観、挙動と実行、ヘルプや支援について、一貫性がありません. 1つめはウィキエディター (WikiEditor) と呼ばれる2010年代のデスクトップ向けのウィキテキスト エディター、2つめはデスクトップ向け・携帯機器向けの形態があるビジュアルエディター、3つめは携帯機器向けの必要最低限の機能を備えたウィキテキスト エディターです.

2010年以来、経験の長さに関わらず利用者が私たちのソフトをどう使っているか、改善すべき点は何か実に多くを知ることができました. 調査に基づくビジュアルエディタの設計により、力技で処理してきたベテランのやり方を卒業して、初学者にも使い方が明確にわかる使いやすいデザインを目指したのです. 完璧とはいかないまでも、デザインやワークフローのヒント等、ビジュアルエディターは全般に初学者から強く支持されたようです. 技術面で新しい課題も多く、ページでの挙動（例：""を押した時）やツールとの相性（例：フロー） 、あるいはデスクトップ版と携帯機器版等、他の拡張機能との伸展性を考えて構築しました.

Having three inconsistent editing systems is bad. It is bad for newbies, because whatever ideas they've learnt from one editor can't be applied to other contexts (like editing a talk page). It is bad for existing editors, who have to jump through several questions before they can work out what the situation for the newbie is and so how to help. It is bad for sysops, who need to separately set up what their community needs in each of the editors – or find out that they can't get it in some editors. It is bad for script and gadget developers, who have to deal with lots of different situations (or ignore them). It is bad for developers, who have to take three times as many parts of complexity into account whenever they need to fix something or add a feature. And it is bad for the donors to the Wikimedia Foundation, whose donations are spent supporting these multiple parallel work streams.

Consequently, we're working on a new wikitext editor. This will provide a single, integrated, consistent experience between desktop and mobile, and wikitext and visual editors. It will be a platform that can be integrated into other editors, so that the experience can be as close as possible between situations and content types. We'll give users as good an experience as we can, while limiting breakage of existing functionality.

Please note that the current phase of deployment is providing this as a Beta Feature and getting feedback. Only once we've met our quality requirements (including new-user testing and experienced-user happiness), probably in mid-2017, we'll begin to provide it by default in place of the current wikitext editor. Users who don't like it will of course be able to not use it whilst it's a Beta Feature, and to disable it along with the visual editor once it's released to everyone. The current wikitext editor is not going anywhere, at least for the next few years. While we may eventually sunset it, anyone who likes it can keep it.

初回のリリース (ベータ機能)
The initial goals for the project were to have parity with the existing wikitext editor, WikiEditor, using the same toolbar with the same buttons in the same positions as in the visual editor so users have consistent experience. This means providing at least all the controls in the wikitext editor, with very few exceptions for very rare buttons:


 * 基本ツール（太字、斜体、署名、リンク、画像）;
 * 高度なツール（見出し、箇条書きリスト、番号付きリスト、拡大、縮小、上付き文字、下付き文字、ギャラリー、表）;
 * 特殊文字の挿入、そして
 * 検索して置換です.

All these were completed as of August 2016, along with a lot of tools not in the existing wikitext editor (like strikethrough, underline, template inserting and so on), and features like pasted HTML being turned into wikitext automatically. In particular, we also provide the "citoid" auto-citation tool, which lets users quickly add references based on URLs or DOIs. This is similar to, but more advanced than, the gadgets that a few wikis like the English Wikipedia had written for themselves already, and they will now be available for all wikis.

We undertook extensive QA testing that the features work as expected, and a design review and structured user testing. Once we were happy that it is adequately working as intended, and is (at least) no worse for new users, we have sought feedback from experienced users of all levels via a Beta Feature.

完成版ベータのリリース (改訂版のリリース前の段階)
ベータ機能としての初回リリースの目標はこの新しいエディタが人々にとって使いやすいかどうか、初期のフィードバックを得ることです. 変更点に関するたくさんの提案をふくんだフィードバックによって期待しています. すでにいくつかの改善に取り組んでいます. そのなかには新しいウィキテキストエディタをリリースする前段階で、ベータ機能とは別に血書する必要があるかもしれません. そのなかには機能をできるだけ使いやすく形作るため、技術的に難しいため延期されてきたものや、ほかには現実世界の現在のユーザーからのフィードバックを待つべきものがあります.

For the first category (big challenges), we believe that we will need to address section editing, in which clicking edit will show small parts of the page to edit, and a fully responsive design, so that the interface can scale up and down more cleanly for smaller devices, where users are zoomed-in, or other accessibility and platform reasons; these will let us provide the feature in mobile as a beta example as well, to ensure it works for all our editors, not just those on desktop.

For the second category (feedback needed), we will need to provide in-editor help to guide users through the editing process from the very first time they click edit and also later in their editing careers. Right now the wikitext editor has a "help" tab with some brief wikitext guidance; in the visual editor, we have a link to the user-guide, which we could replicate for this purpose. How this should work, and what it should highlight, is likely to be something on which many members of our communities have expert ideas. We will also need to clean up how gadgets extend the editor, as the new editor integration right now is complex and confusing. This would make converting some gadgets harder than it should be. Many wiki communities depend on particular gadgets to speed up their editing workflow, and it's important that we preserve the ability for wikis to flexibly experiment with improvements like this.

Naturally, any change of this scale is likely to be disruptive for some users' workflows, and will have a few issues with relative 'edge cases' not being addressed. We look forward to uncovering and addressing these over the weeks and months following the release of the beta feature.

見送るもの
上に説明したものに加えて、その他可能であれば提供できたらよいというものがありますが、開発コストの高さやユーザーが使うにはおそすぎることを考慮して最初から考慮していません. 私たちが提供できたらと考えている機能の1つは、ユーザの編集中に自動的ローカルドラフトを保存する機能で、入力中にブラウザやコンピュータがクラッシュしたり電源が切れたりした場合に、最初からやり直さなくても再開できるものです. これはユーザーをたいへんなストレスから救い、ごくまれなケースとしても、特に状態が悪い/古いコンピュータあるいはネットワーク接続の問題を抱えたユーザーを救済します.

A big feature that often gets discussed is syntax highlighting of wikitext to help guide people's eyes to the right content for which they're looking. This feature was in fact built for the existing wikitext editor back in 2011, but we had to abandon it because the very high complexity of wikitext means that this was exceedingly slow for most users. Five years later, most users' machines are a fair bit faster than they were back then, which helps a little. Also, it might be worth exploring how performant we could make a feature doing this if we were to make some simplifications of the kinds of wikitext which we try to highlight.

(In the meantime, syntax highlighting is provided by Remember the dot's syntax highlighter and WikEd, which are available on some wikis as gadgets). Syntax highlighting has also been introduced to the 2017 wikitext editor using Extension:CodeMirror.

More complex and error-prone than syntax highlighting, but possibly even more useful, would be a feature for folding wikitext structures into blocks so that users can easily ignore things they don't want to edit without having to read through them. For example, long infobox invocations or references could be folded up into blocks until you want to edit them. The technologies we built for the visual editor are particularly well-suited for providing this use case in a reliable fashion, so this may be something we could look at doing. Again, as with syntax highlighting we might need to compromise on the complexity of wikitext that we recognise in return for providing something performant enough to be useful to most of our users.

Another nice feature we could provide would be to prompt users when they save with two or three buttons to add one-click edit summaries based on their recent activities. This kind of feature is quite popular on some wikis as a gadget and it would be nice to provide it to all users on all wikis, without those wikis needing to have a gadget guru on hand to help set it up and maintain it.

資料

 * An early rough design mockup from April is available here. To see the wikitext editor, click the brackets icon in the top-right corner.
 * An old rough demo video is also available as of mid-May 2016 at https://www.youtube.com/watch?v=jgd2ZHOZGBE.
 * Video demo of the 2017 wikitext editor from the December 2016 CREDIT showcase
 * The current version can be seen via Beta Features at Special:Preferences; enable the "new wikitext editor" item, go to https://www.mediawiki.org/wiki/Project:Sandbox?veaction=editsource (for example) and see what it looks like when you switch back and forth.
 * Enabling the "2017 wikitext editor" for extension "VisualEditor"

関連項目

 * 2016年6月現在 編集ソフトの状態のアップデート
 * フィードバックページ