Gamepedia Help Wiki
No edit summary
mNo edit summary
(33 intermediate revisions by 15 users not shown)
Line 1: Line 1:
  +
{{Extension infobox
[[File:VisualEditor-logo.jpg|right|300px]]
 
  +
| version = 0.1.0
  +
| author = Alex Monk, Bartosz Dziewoński, Christian Williams, David Lynch, Ed Sanders, Inez Korczyński, James D. Forrester, Moriel Schottlender, Roan Kattouw, Rob Moen, Timo Tijhof, Trevor Parscal, C. Scott Ananian and others
  +
| link = [[mediawikiwiki:Extension:VisualEditor|MediaWiki.org]]
  +
| desc = Visual editor for MediaWiki
  +
| default = yes
  +
| ucp = yes
  +
}}
   
VisualEditor is a new, "visual" way of editing Gamepedia that allows people to contribute without having to learn wikimarkup by providing a [[wikipedia:WYSIWYG|WYSIWYG]] interface. This rich-text editor was made available as an opt-in release for existing users on all Gamepedia wikis in June, 2015. User accounts created after June 10th, 2015 will have VisualEditor enabled by default.
+
'''VisualEditor''' is a "visual" way of editing Gamepedia that allows people to contribute without having to learn wikimarkup by providing a [[wikipedia:WYSIWYG|WYSIWYG]] interface. This rich-text editor was created and continues to be maintained by [[mediawikiwiki:|MediaWiki.org]]. It was made available as an opt-in release for existing users on all Gamepedia wikis in June 2015. User accounts created after June 10, 2015 and anonymous user have VisualEditor enabled by default.
   
To learn more about using VisualEditor, please read the [[Extension:VisualEditor/User guide|guide to VisualEditor]] and the [[Extension:VisualEditor/Keyboard_shortcuts|list of common keyboard shortcuts]].
+
To learn more about using VisualEditor, please read the [[mediawikiwiki:Help:VisualEditor/User guide|VisualEditor User guide]] and the [[mediawikiwiki:VisualEditor/Portal/Keyboard shortcuts|list of common keyboard shortcuts]] on the MediaWiki wiki.
   
To give your thoughts or feedback about VisualEditor, visit the [[Extension:VisualEditor/Community Discussion|Community Discussion]] page.
+
To give your thoughts or feedback about VisualEditor, visit the [[Extension talk:VisualEditor|Community discussion]] page.
   
  +
==How to enable VisualEditor==
'''Please note that as of 5pm CST (10pm UTC) we are still in the process of flagging VisualEditor as "Off" for existing accounts. You can either disable it manually, or wait until our system turns it off for you.'''
 
 
==How to Enable Visual Editor==
 
 
[[File:VisualEditorPrefs.png|thumb|right|250px|The "Editing" section of your preferences]]
 
[[File:VisualEditorPrefs.png|thumb|right|250px|The "Editing" section of your preferences]]
   
Line 18: Line 23:
 
Once enabled, the Edit button will trigger VisualEditor. You can still use the traditional editor by clicking the "Edit Source" button on any page. The VisualEditor setting is synced globally across all Gamepedia wikis.
 
Once enabled, the Edit button will trigger VisualEditor. You can still use the traditional editor by clicking the "Edit Source" button on any page. The VisualEditor setting is synced globally across all Gamepedia wikis.
   
==How to Disable Visual Editor==
+
==How to disable VisualEditor==
   
 
#Navigate to your [[Special:Preferences|Preferences]]
 
#Navigate to your [[Special:Preferences|Preferences]]
Line 25: Line 30:
   
 
==Resources==
 
==Resources==
*[[mediawikiwiki:Extension:VisualEditor|VisualEditor Extension Documentation on MediaWiki.org]]
+
* [[mediawikiwiki:Extension:VisualEditor|VisualEditor Extension Documentation on MediaWiki.org]]
*[[Wikipedia:Wikipedia:VisualEditor/User_guide|User Guide]]
+
* [[Wikipedia:Wikipedia:VisualEditor/User_guide|User Guide]] on Wikipedia
*[[Extension:VisualEditor/FAQ|FAQ]]
+
* [[Extension:VisualEditor/FAQ|FAQ]]
*[[Extension:VisualEditor/Keyboard_shortcuts]]
 
   
== Limitations ==
+
==Limitations==
 
Current known limitations include: <!-- Listed roughly in order of impact -->
 
Current known limitations include: <!-- Listed roughly in order of impact -->
 
* '''Slower''' – Loading longer pages into VisualEditor generally takes more time than the old wikitext editor, although this delay has been reduced significantly.
 
* '''Slower''' – Loading longer pages into VisualEditor generally takes more time than the old wikitext editor, although this delay has been reduced significantly.
* '''Not available in talk or discussion namespaces''' – On Gamepedia, VisualEditor is only enabled in the Main namespace. On pages other than those in the namespaces mentioned, the "Edit" button for VisualEditor is not available.
+
* '''Not available in talk or discussion namespaces''' – On Gamepedia, VisualEditor is only enabled in the Main and User namespaces. On pages other than those in the namespaces mentioned, the "Edit" button for VisualEditor is not available.
* '''Cannot edit a single section''' – VisualEditor loads and submits only entire pages. In VisualEditor's model, editing sections would be paradoxically slower than editing the whole page. Section editing does not reduce edit conflicts.
+
* '''Cannot edit a single section''' – VisualEditor loads and submits only entire pages. Clicking an "edit" link for a section causes VisualEditor to scroll to the section where the "edit" link was clicked. In VisualEditor's model, editing sections would be paradoxically slower than editing the whole page. Section editing does not reduce edit conflicts.
* '''Template parameters are wikitext, not rich edited''' – VisualEditor lets you edit the parameters of template transclusions, but only as "wikitext" (so "<code><nowiki>[[Foo]]</nowiki></code>" not "[[Foo]]").
+
* '''Template parameters are wikitext, not rich edited''' – VisualEditor lets you edit the parameters of template transclusions, but only as "wikitext" (so "<code><nowiki>[[Gamepedia Help Wiki]]</nowiki></code>" not "[[Gamepedia Help Wiki]]").
 
* '''Nested templates aren't very easy''' (''e.g.'' <code><nowiki>{{Template1|{{Template2}}}}</nowiki></code>) – VisualEditor lets you edit template transclusions which themselves use templates ("nested" templates).
 
* '''Nested templates aren't very easy''' (''e.g.'' <code><nowiki>{{Template1|{{Template2}}}}</nowiki></code>) – VisualEditor lets you edit template transclusions which themselves use templates ("nested" templates).
* '''Limited browser support''' – VisualEditor works only in relatively modern (last three years) versions of Chrome/Chromium, Firefox/Iceweasel, Internet Explorer 10 or higher, Safari, Opera, Midori, Qupzilla, SeaMonkey and WebPositive (approximately 93% of all users). VisualEditor does not yet work with Internet Explorer 9, and will never work with Internet Explorer 8 or older.
+
* '''Limited browser support''' – VisualEditor works only in relatively modern (last three years) versions of Chrome/Chromium, Firefox/Iceweasel, Internet Explorer 10 or higher, Safari, Opera, Midori, Qupzilla, SeaMonkey and WebPositive (approximately 93% of all users). VisualEditor does not yet work with Internet Explorer 9, and will never work with Internet Explorer 8 or older.<ref>[https://www.mediawiki.org/wiki/VisualEditor/Target_browser_matrix VisualEditor target browser matrix]</ref>
 
* '''"Weird" templates''' – struggles with templates that pass a bit of incomplete code, with markup, to another template or table, such as ones that fill in multiple parameters of a table by passing, for example, <code>''param1''|''param2''</code> - this is a difficult problem to code around, but usually unnecessary.
 
* '''"Weird" templates''' – struggles with templates that pass a bit of incomplete code, with markup, to another template or table, such as ones that fill in multiple parameters of a table by passing, for example, <code>''param1''|''param2''</code> - this is a difficult problem to code around, but usually unnecessary.
 
* '''Incomplete editing functionality''' – The content of some "complex" formatting, including definition lists and multi-column layouts, will display and can be edited, but editors using VisualEditor cannot modify certain details, and table editing on mobile doesn't work properly. Adding features in this area is one of the developers' priorities.
 
* '''Incomplete editing functionality''' – The content of some "complex" formatting, including definition lists and multi-column layouts, will display and can be edited, but editors using VisualEditor cannot modify certain details, and table editing on mobile doesn't work properly. Adding features in this area is one of the developers' priorities.
   
 
Because of these limitations and the many remaining bugs in VisualEditor, the developers recommend that VisualEditor users click "Review your changes" before saving a page.
 
Because of these limitations and the many remaining bugs in VisualEditor, the developers recommend that VisualEditor users click "Review your changes" before saving a page.
  +
  +
==References==
  +
<references />
  +
  +
[[Category:Extensions|VisualEditor]]
  +
  +
[[pt:Editor Visual]]
  +
  +
<!-- Extension prefix in other languages:
  +
  +
[[de:Erweiterung:{{subst:BASEPAGENAME}}]]
  +
[[es:Extensión:{{subst:BASEPAGENAME}}]]
  +
[[fr:Extension:{{subst:BASEPAGENAME}}]]
  +
[[it:Estensione:{{subst:BASEPAGENAME}}]]
  +
[[nl:Uitbreiding:{{subst:BASEPAGENAME}}]]
  +
[[pl:Rozszerzenie:{{subst:BASEPAGENAME}}]]
  +
[[pt:Extensão:{{subst:BASEPAGENAME}}]]
  +
[[ru:Расширение:{{subst:BASEPAGENAME}}]]
  +
[[zh:扩展:{{subst:BASEPAGENAME}}]]
  +
-->

Revision as of 19:21, 3 December 2020

VisualEditor is a "visual" way of editing Gamepedia that allows people to contribute without having to learn wikimarkup by providing a WYSIWYG interface. This rich-text editor was created and continues to be maintained by MediaWiki.org. It was made available as an opt-in release for existing users on all Gamepedia wikis in June 2015. User accounts created after June 10, 2015 and anonymous user have VisualEditor enabled by default.

To learn more about using VisualEditor, please read the VisualEditor User guide and the list of common keyboard shortcuts on the MediaWiki wiki.

To give your thoughts or feedback about VisualEditor, visit the Community discussion page.

How to enable VisualEditor

VisualEditorPrefs

The "Editing" section of your preferences

  1. Navigate to your Preferences
  2. Select the "Editing" Tab
  3. In the "Editor" section, check "Enable VisualEditor'

Once enabled, the Edit button will trigger VisualEditor. You can still use the traditional editor by clicking the "Edit Source" button on any page. The VisualEditor setting is synced globally across all Gamepedia wikis.

How to disable VisualEditor

  1. Navigate to your Preferences
  2. Select the "Editing" Tab
  3. In the "Editor" section, uncheck "Enable VisualEditor'

Resources

Limitations

Current known limitations include:

  • Slower – Loading longer pages into VisualEditor generally takes more time than the old wikitext editor, although this delay has been reduced significantly.
  • Not available in talk or discussion namespaces – On Gamepedia, VisualEditor is only enabled in the Main and User namespaces. On pages other than those in the namespaces mentioned, the "Edit" button for VisualEditor is not available.
  • Cannot edit a single section – VisualEditor loads and submits only entire pages. Clicking an "edit" link for a section causes VisualEditor to scroll to the section where the "edit" link was clicked. In VisualEditor's model, editing sections would be paradoxically slower than editing the whole page. Section editing does not reduce edit conflicts.
  • Template parameters are wikitext, not rich edited – VisualEditor lets you edit the parameters of template transclusions, but only as "wikitext" (so "[[Gamepedia Help Wiki]]" not "Gamepedia Help Wiki").
  • Nested templates aren't very easy (e.g. {{Template1|{{Template2}}}}) – VisualEditor lets you edit template transclusions which themselves use templates ("nested" templates).
  • Limited browser support – VisualEditor works only in relatively modern (last three years) versions of Chrome/Chromium, Firefox/Iceweasel, Internet Explorer 10 or higher, Safari, Opera, Midori, Qupzilla, SeaMonkey and WebPositive (approximately 93% of all users). VisualEditor does not yet work with Internet Explorer 9, and will never work with Internet Explorer 8 or older.[1]
  • "Weird" templates – struggles with templates that pass a bit of incomplete code, with markup, to another template or table, such as ones that fill in multiple parameters of a table by passing, for example, param1|param2 - this is a difficult problem to code around, but usually unnecessary.
  • Incomplete editing functionality – The content of some "complex" formatting, including definition lists and multi-column layouts, will display and can be edited, but editors using VisualEditor cannot modify certain details, and table editing on mobile doesn't work properly. Adding features in this area is one of the developers' priorities.

Because of these limitations and the many remaining bugs in VisualEditor, the developers recommend that VisualEditor users click "Review your changes" before saving a page.

References