VisualEditor

From MediaWiki.org
(Redirected from Visual editor)
Jump to: navigation, search
For the VisualEditor deployment at the English Wikipedia, see Wikipedia:VisualEditor.
For changes made using the VisualEditor, see VisualEditor, VisualEditor: Check, and VisualEditor: Switched

The VisualEditor project aims to create a reliable rich-text editor for MediaWiki. It is being developed so it can be used as a MediaWiki extension, using the Parsoid project to supply HTML+RDFa.

As of late 2014, it is available to all users here at MediaWiki.org and on about half of the Wikipedias. It is also available as an opt-in Beta Feature to logged-in users on most other projects, in all languages. VisualEditor is only available in some namespaces, including the main namespace (where this page is), but not in discussion namespaces.

More information about VisualEditor can be found on Wikimedia's blog, the FAQs, and VisualEditor:Welcome. Please visit the main, multilingual VisualEditor Portal.

Rationale[edit | edit source]

The decline in new contributor growth is the single most serious challenge facing the Wikimedia movement. Removing avoidable technical impediments associated with Wikimedia's editing interface is a necessary pre-condition for increasing the number of Wikimedia contributors.

Status[edit | edit source]


2014-11-19 (MW 1.25wmf9):

VisualEditor was updated as part of the wider MediaWiki 1.25wmf9 branch deployment on Wednesday 19 October. In the week since the last deployment, the team made some minor improvements to several features and a range of bug fixes.

Adding a redirect category now adds the target category directly instead. On wikis using the Flagged Revisions system, the notice saying "1 change in this version is pending review" at the top of the page is now shown when you exit VisualEditor (bug 60718). When you close the save dialog to resume editing, we restore the selection back to where it was (bug 72911).

We fixed a number of issues which we chose to release immediately to avoid disrupting and inconveniencing editing for users. Loading a page in Chrome would sometimes scroll immediately to the bottom because we focussed on the wrong thing; we removed this (bug 73208). Editing a page with incorrect, broken or nonsense values for table's colspan or rowspan attributes will no longer normalise or corrupt them (bug 73430). Pasting text in Chrome no longer strips the spaces off the text between things that are bold/linked and things that aren't, caused by the browser using the wrong source when copying content to the clipboard (bug 71718). An issue from last week's change to no longer use <iframe>s meant that the link and language inspectors appeared as blank when you tried to use them inside a reference or media dialog was fixed (bug 73542).

Some further improvements to table editing were made, including some bad UX issues for users of RTL languages like Hebrew (bugs 73378 and 73379). Dragging a gallery node into the caption of an image is no longer possible (bug 73368). Clicking away from the comment editor now doesn't save an empty comment (bug 71706) and you don't have to press "undo" twice to reverse a comment editing action (bug 72315). A bug with Safari that meant the link editor opened in the upper-left corner of the screen, rather than where the user clicked (bug 73336). We fixed an issue that mean selection a node with the cursor keys caused the context menu to briefly flicker in and then out of existence at the position of the last mouse click first (bug 73242). The new system for displaying formulæ being worked on by the Math team now works inside VisualEditor for editing purposes too, and we fixed the display if you're using the new rendering form (bug 72539).

On the back-end, we removed the very old ve.bind method which is no longer needed (bug 72156), and fixed a couple of server-side PHP warnings found during an audit (bugs 73463 and 73469). We made preparatory changes for supporting new features in TemplateData as part of our work on auto-filled citations. The RangeFix library was updated to version 0.1.1. VisualEditor no longer uses a hard-coded list comma message, but the system one (bug 66894). The OOjs UI library has a number of improvements, including not closing menus when you click their scroll bars (bug 65774). The OOjs library had a new version, 1.1.3, released, which OOjs UI, VisualEditor and MediaWiki all now use; this version contains upstreamed versions of VisualEditor's ve.getProp() and ve.setProp() utility functions, which are now used through these functions.

You can monitor the live results of the automated browser tests (triggered every twelve hours) on the server. A complete list of individual code commits is available in the 1.25/wmf9 changelog, and all Bugzilla tickets closed in this period are on Bugzilla's list.

You can see the team's current code dashboard on gerrit.

Timeline[edit | edit source]

  • Some level of exploration was done in 2010 by the Wikipedia Usability Initiative.
  • The 2011 product whitepaper published by the Wikimedia Foundation's strategic product team identified rich-text editing as one of the "Great Movement Projects". Work subsequently started in May 2011.
  • The 2011-12 Wikimedia annual plan, released July 2011, states a goal for VisualEditor: "First opt-in user-facing production usage by December 2011, and first small wiki default deployment by June 2012".
  • The 2012-13 Engineering Goals document sets a timeline for VisualEditor's development and deployment up to the end of June 2013.
  • The 2013–2014 Engineering Goals document lists the goals for that year.
  • VisualEditor is scheduled to be deployed across Wikimedia projects over the coming months. Below is the schedule as of November 2014:
Roll-out timeline (detailed list)
Week of… Launch Users Projects Status
Summer 2012 Phase 0 All users Mediawiki.org[1] YesY Done
1 July 2013 Logged-in users English Wikipedia (en)[2] YesY Done
15 July 2013 All users YesY Done
24 July 2013 Phase 1 Logged-in users 7 of the largest Wikipedias

Spanish (es),[3] French (fr), Hebrew (he), Italian (it), Polish (pl), Russian (ru) & Swedish (sv)[4]

YesY Done
29 July 2013 All users YesY Done
30 September 2013 Phase 2 Logged-in users 27 of the next largest Wikipedias

Bulgarian (bg), Catalan (ca), Cebuano (ceb), Czech (cs), Danish (da), Modern Greek (el), Estonian (et), Basque (eu), Finnish (fi), Galician (gl), Croatian (hr), Hungarian (hu), Indonesian (id), Latvian (lv), Malay (ms), Neopolitan (nap), Norwegian - Nynorsk (nn), Norwegian - Bokmål (no), Sicilian (scn), Simple English (simple), Slovak (sk), Slovenian (sl), Turkish (tr), Ukrainian (uk), Venetian (vec), Volapük (vo), Waray-Waray (war)

YesY Done
7 October 2013 All users YesY Done
2 December 2013 Phase 3 All users 91 Wikipedias with all characters normally directly available to users

Acehnese (ace), Aymara (ay), Central Bikol (bcl), Bislama (bi), Banjar (bjn), Chavacano (cbk-zam), Chechen (ce), Chamorro (ch), Cheyenne (chy), Corsican (co), Kashubian (csb), Zazaki (diq), Emilian-Romagnol (eml), Extremaduran (ext), Fijian (fj), Faroese (fo), Franco-Provençal/Arpitan (frp), North Frisian (frr), Friulian (fur), Scottish Gaelic (gd), Hawai'ian (haw), Fiji Hindi (hif), Haitian (ht), Interlingua (ia), Ilokano (ilo), Ido (io), Lojban (jbo), Kongo (kg), Kikuyu (ki), Greenlandic (kl), Komi-Permyak (koi), Ripuarian (ksh), Cornish (kw), Ladino (lad), Lak (lbe), Ganda (lg), Limburgish (li), Ligurian (lij), Lombard (lmo), Banyumasan (map-bms), Malagasy (mg), Maori (mi), Minangkabau (min), Maltese (mwl), Erzya (myv), Nauruan (na), Low Saxon (nds), Dutch Low Saxon (nds-nl), Novial (nov), Norman (nrm), Northern Sotho (nso), Chichewa (ny), Oromo (om), Pangasinan (pag), Kapampangan (pam), Papiamento (pap), Picard (pcd), Pennsylvania German (pdc), Norfuk (pih), Piedmontese (pms), Portuguese (pt), Quechuan (qu), Romansh (rm), Romani (rmy), Kirundi (rn), Aromanian (roa-rup), Tarantino (roa-tara), Kinyarwanda (rw), Northern Sami (se), Sango (sg), Samoan (sm), Shona (sn), Somali (so), Sranan (srn), Swazi (ss), Sesotho (st), Saterland Frisian (stq), Sundanese (su), Tongan (to), Tok Pisin (tpi), Tsonga (ts), Tumbuka (tum), Tahitian (ty), Tuvan (tyv), Veps (vep), West Flemish (vls), Kalmyk (xal), Yiddish (yi), Yoruba (yo), Zeelandic (zea), Zulu (zu)

YesY Done
13 January 2014 Phase 4 All users 23 remaining Wikipedias with all characters normally directly available to users

Alemannic (als), Aragonese (an), Asturian (ast), Bavarian (bar), Belarusian (be), Belarussian Taraškievica (be-x-old), Bosnian (bs), Esperanto (eo), West Frisian (fy), Irish (ga), Javanese (jv), Latin (la), Luxembourgish (lb), Lithuanian (lt), Occitan (oc), Palatinate German (pfl), Romanian (ro), Scots (sco), Albanian (sq), Swahili (sw), Tswana (tn), Vietnamese (vi), Xhosa (xh)

YesY Done
November 2014 All users Tagalog (tl) YesY Done
27 November 2014 Logged-in users

Opt-in only

All logged in users at all remaining projects (Wikibooks, Wikivoyage, Wiki) except Wikisource and Wiktionary In progress In progress
TBC Phase 5 All users 53 Wikipedias with some characters not normally directly-available to users

(Provisional list) Abkhazian (ab), Afrikaans (af), Akan (ak), Anglo-Saxon (ang), Avar (av), Azerbaijani (az), Bashkir (ba), Samogitian (bat-smg), Bambara (bm), Breton (br), Buryat (bxr), Crimean Tatar (crh), Old Church Slovonic (cu), Chuvash (cv), Welsh (cy), Lower Sorbian (dsb), Ewe (ee), Fula (ff), Võro (fiu-vro), Gagauz (gag), Guarani (gn), Hausa (ha), Upper Sorbian (hsb), Igbo (ig), Inupiak (ik), Icelandic (is), Karakalpak (kaa), Kabyle (kab), Kabardian (kbd), Karachay-Balkar (krc), Komi (kv), Kyrgyz (ky), Lezgian (lez), Lingala (ln), Latgalian (ltg), Moksha (mdf), Meadow Mari (mhr), Macedonian (mk), Mongolian (mn), Hill Mari (mrj), Maltese (mt), Nahuatl (nah), Navajo (nv), Ossetian (os), Rusyn (rue), Sakha (sah), Silesian (szl), Turkmen (tk), Tatar (tt), Udmurt (udm), Venda (ve), Walloon (wa), Wolof (wo)

TBC Phase 6 All users 59 Wikipedias with complex characters inserted using Input Method Editors

(Provisional list) Amharic (am), Arabic (ar), Aramaic (arc), Egyptian Arabic (arz), Assamese (as), Behari (bh), Bengali (bn), Tibetan (bo), Bishnupriya (bpy), Buginese (bug), Min Dong (cdo), Cherokee (chr), Sorani Kurdish (ckb), Cree (cr), Dhivehi (dv), Dzongkha (dz), Persian (fa), Gilaki (glk), Gothic (got), Gujarati (gu), Manx (gv), Hakka (hak), Hindi (hi), Akan (hy), Japanese (ja), Georgian (ka), Khmer (km), Kannada (kn), Korean (ko), Kashmiri (ks), Lao (lo), Malayalam (ml), Marathi (mr), Burmese (my), Mazanderani (mzn), Nepali (ne), Nepal Bhasa (new), Oriya (or), Punjabi (pa), Pali (pi), Saraiki (Western Punjabi) (pnb), Pontic (pnt), Pashto (ps), Sanskrit (sa), Sindhi (sd), Serbo-Croatian (sh), Sinhala (si), Tamil (ta), Telugu (te), Thai (th), Tigrinya (ti), Uyghur (ug), Urdu (ur), Wu (wuu), Zhuang (za), Classical Chinese (zh-classical), Min Nan (zh-min-nan), Cantonese (zh-yue)

TBC Phase 7 All users 9 language variant Wikipedias

Gan (gan), Inuktitut (iu), Kazakh (kk), Kurdish (ku), Tachelhit (shi), Serbian (sr), Tajik (tg), Uzbek (uz), Chinese (zh)

Enabling VisualEditor by default for all users or for all logged-in users can be requested by contacting product manager James Forrester.

Notes[edit | edit source]

  1. Initially restricted to just the VisualEditor: namespace, later for all pages.
  2. Subsequently switched back to "opt-in" mode in September 2013.
  3. Subsequently switched back to "opt-in" mode in February 2014.
  4. German (de) and Dutch (nl) initially proposed, but withdrawn before full deployment due to community concerns.

Documentation[edit | edit source]

You can speak with us in our chat channel, #mediawiki-visualeditorconnect.

Related pages[edit | edit source]

For more information on VisualEditor and its design process, see these directory pages:

See also[edit | edit source]