Wikipedia:VisualEditor
Wikimedia Foundation (WMF) developers have implemented a Beta version of VisualEditor (VE), a way to edit pages without needing to learn wiki markup. Both VisualEditor and the original wikitext editor are automatically available to all editors on all article and user pages (VE is disabled in all other namespaces). You can continue to edit wikitext directly using the "Edit source" tab, or (on non-article, non-user pages), the "Edit" tab.
Bug reports and comments are welcome at Wikipedia:VisualEditor/Feedback. Your help in identifying bugs and training new users is invaluable.
That VisualEditor is in Beta means that it lacks the full functionality of the older wikitext editor. But while experienced editors will be more comfortable with wikitext editing, VE has features that are intended to be more user-friendly for new editors. For example, there are dialogs to insert a new image, or to edit a complex templates or a reference.
After a huge consensus in its favor, the WMF developers have implemented a user preference to disable the VisualEditor. Go to Special:Preferences#mw-prefsection-editing, and check the box labeled "Temporarily disable VisualEditor while it is in beta", then click "Save". If you're having trouble disabling the VisualEditor, or to hide it instead of disabling it, see Wikipedia:VisualEditor/Opt-out for more detailed instructions.
Attention Internet Explorer (IE) users: At the moment, VisualEditor is disabled for all IE web browsers. For IE9 and IE10 users, this is intended to be temporary, with various issues being addressed by software fixes. But VE will not be made available to users of IE8 and earlier. If you use these older versions of IE and want to edit with VisualEditor, you will need to use a different browser.
- Main page
- Feedback at MediaWiki
- Sandbox (no account required)
- Documentation:
- Development:
- Roadmap up to 2017
- Updates (2013-2023)
- Weekly status reports (2015-2016)
- Why are the developers building this? (2013)
- User Test Data (2013)
- Customization
- Known problems
- Requests for Comments (RfCs): Jul 2013 a, Jul 2013 b, Jul 2015, Sep 2015
Welcome to the portal for the VisualEditor, a new way of editing Wikipedia being developed by the Wikimedia Foundation. Editing Wikipedia has, in the past, required people to learn some wikimarkup, for most changes to articles. In 2001, this was acceptable; in 2013, it drives away some contributors. VisualEditor allows people to edit without having to learn wikimarkup and will, it is hoped, encourage more readers to become editors.
By the end of July 2013, the VE team expects VE to be available to editors on almost all Wikimedia projects.
Experienced editors may well prefer editing wikitext directly, finding it faster and more precise. Editing articles purely in wikitext is still and will remain an option; the Wikimedia Foundation has absolutely no plans to remove this. Both editing options are accessible from the toolbar above each article and user page.
About the VisualEditor
The VisualEditor is a new, "visual" way of editing Wikipedia that will let people contribute without having to learn wikimarkup. It has been available as an opt-in "alpha" release on the English-language Wikipedia since December 2012, in 16 other languages since April 2013, and in almost all other languages since the beginning of June. As shown below, the VE team expects to deploy this to almost all Wikipedias by the end of July, making it available for all editors without their opting in, starting with the English-language Wikipedia on 1 July.
For those interested in using VisualEditor, there is a guide to doing so, as well as a list of common keyboard shortcuts. If you're interested in helping with the deployment, there are lots of tasks that needed to be done. You can receive regular status updates on your talk page by signing up for the VE newsletter.
At the moment, the VisualEditor has a large number of bugs. While some bugginess was inevitable, the current level is unacceptable and the developers' goal is to eliminate as many of these bugs as quickly as possible. Some entirely new features are still yet to be built. If you encounter an issue, then please report it on the Feedback page.
Limitations
Current limitations include:
- Articles and User pages only – The VisualEditor is only enabled for the article and user namespaces (the latter allows editors to make changes in a personal sandbox). In time, VE will include the specialised editing tools needed for non-article pages, but the developer focus has been on articles. On pages other than those in the article and user namespaces, the "Edit" button will take editors to the old (wikitext) editor.
- Limited browser support – VisualEditor currently works only in the most modern versions of Firefox, Chrome and Safari. A volunteer is working on Opera support, and the developers aim to have support for the latest versions of Internet Explorer once they release the VisualEditor more widely.
- Only supports the Vector and Monobook skins. [3]
- Cannot edit a single section. VisualEditor only loads and submits entire pages.
- Despite above, must hover over "Edit" link for sections in order to get the Edit source tab for that section. This does not work on touchscreens, and is inaccessible to those who use screenreaders. This is in contrast to recommended practices of the Web Content Accessibility Guidelines that Wikipedia aims to uphold.[1]
- Slow loading - Loading longer pages into VisualEditor takes more time than the old wikitext editor, though significantly less time than at the initial rollout of VE. Large articles may take 15 seconds or so to load.
- Pages for which the VisualEditor is an option carry roughly 2% more Javascript, which is about 0.5% of the total page load. Furthermore, this only has to be loaded once and is cached for use on all pages (until your cache expires, usually once a week).
- Slow scrolling – Pages can take a long time to respond to attempted scrolling down or up on even relatively good computers with good internet connections.
- Incomplete editing functionality – The content of some "complex" formatting, including tables and definition lists, will display and can be edited, but editors using VE cannot modify the structures or add new entries, such as an additional row for a table. Adding features in this area is one of the developers' priorities.
- Relatively weak referencing support (albeit getting better).
- Cannot copy-paste from one page to another without losing italics, bold, wikilinks, and other markup. In particular, footnotes and templates cannot be copy-pasted. Adding this functionality is a high-priority enhancement.
- Odd-looking – The developers are currently struggling with making the HTML that VE produces look like what editors are used to seeing, so styling and so on may look a little (or even very) odd. Developer time is being spent on improving this, but their focus remains on ensuring that the VisualEditor does not alter wikitext unexpectedly.
- Cannot view hidden comments – Users using VisualEditor cannot view hidden comments, which often contain notes that are helpful in editing specific sections of articles.
- Template within template - (e.g.
{{Template1|{{Template2}}}}
) Unlike the Visual Mode editor of Wikia, which will be disabled if a template is containing another template, VisualEditor of Wikimedia allows such usage and will display the preview properly. The only problem is that the template within can only be used in the source mode style, meaning you need to write the full source code of the inner template manually in the parameter entry window of the outer template.
Because of these limitations and the many remaining bugs in Visual Editor, the developers recommend that VE users click "Review your changes" before saving a page, and report any problems they see.
Timetable
Week of.. | Launch | Target projects | Status |
---|---|---|---|
1 July | Launch to all logged-in users as the default editor | English-language Wikipedia | Done |
15 July | Launch to all logged-in and anonymous users as the default editor | English-language Wikipedia | Done |
24 July | Launch to all logged-in users on other first-stage projects | German (de), Spanish (es), French (fr), Hebrew (he), Italian (it), Dutch (nl), Polish (pl), Russian (ru) and Swedish (sv) | Please update |
29 July | Launch to all logged-in and anonymous users on other first-stage projects | German (de), Spanish (es), French (fr), Hebrew (he), Italian (it), Dutch (nl), Polish (pl), Russian (ru) and Swedish (sv) | Please update |
? | Launch to all logged-in and anonymous users on all other projects | All Wikipedias, except those languages with language variants, such as Chinese. | Please update |
How to help out
Help is needed to make the VisualEditor as good as it can be: You can find and report bugs while using the software or lend a hand in many other tasks, such as:
- Updating help pages – All Wikimedia Foundation projects have help pages to make contributing easier for new editors. Unfortunately, the full launch of VisualEditor will make obsolete the screenshots and tutorials in these help pages, because they describe how to edit using the markup editor. Therefore, the VE development team needs help updating help pages. The user guide to VisualEditor is a starting place for text for the new help pages.
- Adding TemplateData to templates – The VisualEditor features an interactive template editor—described in more detail in the user guide—and as you'll see if you use it on Wikipedia, some templates have named parameters and nice descriptions that make it easy to use. However, other templates lack them because they need "TemplateData" before this feature will work. If you're interested in adding TemplateData, then read the guide to it and the list of the most important templates to add it to.
- Help new users – The successful launch of VisualEditor might result in many more new editors than usual, and even though editing may be easier, learning policies and guidelines and how to interact with the community will still be challenging. Please try to spend some time at the appropriate venues: the Help desk, the Teahouse and the help chatroom. Additionally, please feel free to monitor the Category of Wikipedians looking for help.
Newsletter
Sign up here! Just add * {{user|Your username}} below.
- Lacolchadetu senscape (talk · contribs)
- Jimbo Wales (talk · contribs)
- 3family6 (talk · contribs)
- Alessandro57 (talk · contribs)
- Flexdream (talk · contribs)
- Defan24 (talk · contribs)
- Wrybit (talk · contribs)
- Cisco9078 (talk · contribs)
- cj1340 (talk · contribs)
- Judgesurreal777 (talk · contribs)
- Alaney2k (talk · contribs)
- J.Dong820 (talk · contribs)
- Drali1954 (talk · contribs)
- Doberek (talk · contribs)
- Ekhaya2000 (talk · contribs)
- Tentinator (talk · contribs)
- Buffbills7701 (talk · contribs)
- ctxppc (talk · contribs)
- Captain Assassin! (talk · contribs)
- Pratyya Ghosh (talk · contribs)
- Charles Edwin Shipp (talk · contribs)
- Blok Glo (talk · contribs)
- JordanKyser22 (talk · contribs)
- Auric (talk · contribs)
- Chiefmartinez (talk · contribs)
- Zhaofeng Li (talk · contribs)
- CRC43 (talk · contribs)
- Aashwath_001 (talk · contribs)
- patchallel (talk · contribs)
- Susanne Ramharter (talk · contribs)
- Neo12345292 (talk · contribs)
- Simoncaulton (talk · contribs)
- benzband (talk · contribs)
- Coal town guy (talk · contribs)
- Farshid7 (talk · contribs)
- Smuckola (talk · contribs)
- Corn cheese (talk · contribs)
- ~Siriusly (talk · contribs)
- vfrickey (talk · contribs)
- Gerryyabes (talk · contribs)
- Johnny Au (talk · contribs)
- Quadtripplea (talk · contribs)
- Signalizing (talk · contribs)
- Cekli829 (talk · contribs)
- fabregas0414 (talk · contribs)
- JMHamo (talk · contribs)
- gordon4752 (talk · contribs)
- PearlSt82 (talk · contribs)
- Jacopo Werther (talk · contribs)
- Freedman1 (talk · contribs)
- Charles01 (talk · contribs)
- lion_trainer (talk · contribs)
- Lineagekeeper (talk · contribs)
- Spacenut42 (talk · contribs)
- danlev (talk · contribs)
- Perumalism (talk · contribs)
- Aleksa Milićević (talk · contribs)
- Coolgama (talk · contribs)
- Wahrmund (talk · contribs)
- Discott (talk · contribs)
- Paine Ellsworth (talk · contribs)
- Nascar1996 (talk · contribs)
- Codename Lisa (talk · contribs)
- mgiganteus1 (talk · contribs)
- XapApp (talk · contribs)
- Andrewa (talk · contribs)
- Robert McClenon (talk · contribs)
- Imagine Wizard (talk · contribs)
- BJMendelson (talk · contribs)
- Bcorr (talk · contribs)
- Ocaasi (talk · contribs)
- Lucky102 (talk · contribs)
- Loggats (talk · contribs)
- John Broughton (talk · contribs)
- ScottyWZ (talk · contribs)
- ProtoDrake (talk · contribs)
- Diaa abdelmoneim (talk · contribs)
- Dom497 (talk · contribs)
- JB82 (talk · contribs)
- ConradKilroy (talk · contribs)
- Sreejiththulaseedharan (talk · contribs)
- TehPlaneFreak (talk · contribs)
- Ged UK (talk · contribs)
- hym411 (talk · contribs)
- David Gerard (talk · contribs)
- Bilby (talk · contribs)
- Pseudonymous Rex (talk · contribs)
- OrangesRyellow (talk · contribs)
- Arctic Kangaroo (talk · contribs)
- Quiddity (talk · contribs)
- Faizan (talk · contribs)
- Miya (talk · contribs)
- Numbermaniac (talk · contribs)
- Alexander95015 (talk · contribs)
- Hair (talk · contribs)
- Shanata (talk · contribs)
- Martijn Hoekstra (talk · contribs)
- Stratocaster27 (talk · contribs)
- Joe Decker (talk · contribs)
- Ewiz88 (talk · contribs)
- PamD (talk · contribs)
- jduranboger (talk · contribs)
- metsfreak2121 (talk · contribs)
- Diego Moya (talk · contribs)
- Froztbyte (talk · contribs)
- Odisha1 (talk · contribs)
- JetBlast (talk · contribs)
- MirandaStreeter (talk · contribs)
- Christian75 (talk · contribs)
- EdSaperia (talk · contribs)
- Jc86035 (talk · contribs)
- Bevo (talk · contribs)
- JohnCD (talk · contribs)
- GermanJoe (talk · contribs)
- orsd (talk · contribs)
- MatthewBurton (talk · contribs)
Notes
- ^ Specifically two of the core principles, "Perceivable" and "Operable", and most likely several specific principles such as [1] and [2]. See also http://www.w3.org/WAI/WCAG20/glance/.
External links
- The mediawiki.org page about the VisualEditor, including the regular status reports
- The mediawiki.org page about Parsoid, the bidirectional wiki parser behind VisualEditor and its regular status reports