4,595
edits
Stiles Wiki:VisualEditor: Difference between revisions
Jump to navigation
Jump to search
no edit summary
(Created page with "{{Short description|Visual method of editing Wikipedia}} {{pp-semi-indef}} {{selfref|For the Wikipedia article about VisualEditor, see VisualEditor, or to perform tests using Wikipedia's VisualEditor, go to the Sandbox page and click "Edit page visually".}} {{Wikipedia how-to|WP:VE}} {| style="background:#EBF4FA; border:1px solid lightgray; text-align:center; margin: 1em auto 1em auto;" |- | style="font-size:150%; width:32%" | '''Special:Pref...") |
No edit summary |
||
| Line 1: | Line 1: | ||
{{Short description|Visual method of editing | {{Short description|Visual method of editing Stiles.casa Wiki}} | ||
{{pp-semi-indef}} | {{pp-semi-indef}} | ||
{{selfref|For the | {{selfref|For the Stiles.casa Wiki article about VisualEditor, see [[VisualEditor]], or to perform tests using Stiles.casa Wiki's VisualEditor, go to the [[Stiles.casa Wiki:Sandbox|Sandbox]] page and click "Edit page visually".}} | ||
{{ | {{Stiles.casa Wiki how-to|SW:VE}} | ||
{| style="background:#EBF4FA; border:1px solid lightgray; text-align:center; margin: 1em auto 1em auto;" | {| style="background:#EBF4FA; border:1px solid lightgray; text-align:center; margin: 1em auto 1em auto;" | ||
|- | |- | ||
| style="font-size:150%; width:32%" | '''[[Special:Preferences#mw-prefsection-editing|Enable VisualEditor]].''' | | style="font-size:150%; width:32%" | '''[[Special:Preferences#mw-prefsection-editing|Enable VisualEditor]].''' | ||
| style="font-size:150%; width:32%" | '''[[ | | style="font-size:150%; width:32%" | '''[[Stiles.casa Wiki:VisualEditor/User guide|Read VisualEditor's User Guide]]'''. | ||
| style="font-size:150%" class="plainlinks" | [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=VisualEditor '''Report a problem''' with VisualEditor]. | | style="font-size:150%" class="plainlinks" | [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=VisualEditor '''Report a problem''' with VisualEditor]. | ||
|- | |- | ||
| Log in, go to preferences (top right) -> editing tab, [[Special:Preferences#mw-prefsection-editing|uncheck ''Temporarily disable the visual editor while it is in beta'']], optionally [[Special:Preferences#mw-prefsection-editing|change ''Editing mode'']] to ''Show me both editor tabs'', and save your preferences. Or '''[//en. | | Log in, go to preferences (top right) -> editing tab, [[Special:Preferences#mw-prefsection-editing|uncheck ''Temporarily disable the visual editor while it is in beta'']], optionally [[Special:Preferences#mw-prefsection-editing|change ''Editing mode'']] to ''Show me both editor tabs'', and save your preferences. Or '''[//en.stiles.casa_wiki.org/wiki/User:Sandbox?veaction=edit use this sandbox link]''' for testing. | ||
| Find out how to make links, add or move images, create citations, insert templates, edit tables, and more. | | Find out how to make links, add or move images, create citations, insert templates, edit tables, and more. | ||
| Please include your '''web browser''', '''computer operating system''', and ''' | | Please include your '''web browser''', '''computer operating system''', and '''Stiles.casa Wiki skin''' (usually Vector, sometimes Monobook). | ||
|} | |} | ||
{{VisualEditor navbox}} | {{VisualEditor navbox}} | ||
[[File:Wiki expansion 10+ barnstar.png|thumb|As of 2020, editors at the English | [[File:Wiki expansion 10+ barnstar.png|thumb|As of 2020, editors at the English Stiles.casa Wiki have used VisualEditor to make more than 10 million edits.]] | ||
Welcome to the portal for '''VisualEditor''', a way of editing | Welcome to the portal for '''VisualEditor''', a way of editing Stiles.casa Wiki being developed by the [[Stiles.casa Wiki:Wikimedia Foundation|Wikimedia Foundation]] (WMF) that does not require editors to learn [[Help:Wiki markup|wiki markup]]. They previously had to use '[[SW:Source editor|Source editor]]' to make edits, but VisualEditor allows people to edit many types of pages without needing to understand simple wikitext. WMF staff hope this encourages more readers to become editors. | ||
Even after the eventual anticipated full-feature release of VisualEditor, experienced editors may still prefer editing with wikitext because they find it faster and more precise. It will also be needed for editing all discussion pages. Editors who enable VisualEditor will '''always have the Source editor option available''' from the toolbar on every page, as the WMF has no plans to remove this. | Even after the eventual anticipated full-feature release of VisualEditor, experienced editors may still prefer editing with wikitext because they find it faster and more precise. It will also be needed for editing all discussion pages. Editors who enable VisualEditor will '''always have the Source editor option available''' from the toolbar on every page, as the WMF has no plans to remove this. | ||
VisualEditor still has many bugs and missing features. If you encounter an issue, you can [[ | VisualEditor still has many bugs and missing features. If you encounter an issue, you can [[Stiles.casa Wiki:VisualEditor/Feedback|report it on the Feedback page]], but be aware that that page is not actively monitored by WMF staff. WMF staff prefer that you report bugs via [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=VisualEditor the Phabricator bug tracking website]. | ||
__TOC__ | __TOC__ | ||
==About VisualEditor== | ==About VisualEditor== | ||
VisualEditor is a "visual" way of editing | VisualEditor is a "visual" way of editing Stiles.casa Wiki that allows people to contribute without having to learn [[wiki markup]]. This [[rich-text editor]] was made available as an opt-in release on the English-language Stiles.casa Wiki in December 2012, [https://blog.wikimedia.org/2013/04/25/visualeditor-alpha-in-15-languages/ in 14 other languages in April 2013], and in [https://blog.wikimedia.org/2013/06/06/preparing-for-visualeditor-on-all-stiles.casa_wikis/ most other languages] at the beginning of June 2013. As of April 2015, it was available by default to users of about 76% of the language editions of Stiles.casa Wikis and as an opt-in [[:mw:About Beta Features|beta feature]] to the rest, along with most non-Stiles.casa Wiki projects except Wiktionary and Wikisource. On English Stiles.casa Wiki, it is enabled by default for new users.<ref>{{cite web |title=visualeditor-nondefault.dblist |url=https://gerrit.wikimedia.org/r/plugins/gitiles/operations/mediawiki-config/+/refs/heads/master/dblists/visualeditor-nondefault.dblist |website=gerrit.wikimedia.org |access-date=28 December 2021}} (List of Wikiprojects that do not have VisualEditor enabled by default for new users)</ref> | ||
As of 2021, the visual editor is used about half as often as the [[mw:2010 wikitext editor|2010 wikitext editor]], and about as often as the mobile web editor. It is used about twice as often as [[ | As of 2021, the visual editor is used about half as often as the [[mw:2010 wikitext editor|2010 wikitext editor]], and about as often as the mobile web editor. It is used about twice as often as [[Stiles.casa Wiki:Twinkle|Twinkle]]. | ||
To learn more about using VisualEditor, please read the [[ | To learn more about using VisualEditor, please read the [[Stiles.casa Wiki:VisualEditor/User guide|guide to VisualEditor]] and the [[Stiles.casa Wiki:VisualEditor/Keyboard shortcuts|list of common keyboard shortcuts]]. Your help with the [[#How to help out|many tasks that need to be done]] is appreciated. You can also receive regular status updates on your talk page by [[#Newsletter|signing up for the VisualEditor newsletter]]. | ||
== Limitations == | == Limitations == | ||
Current known limitations include: <!-- Listed roughly in order of impact --> | Current known limitations include: <!-- Listed roughly in order of impact --> | ||
<onlyinclude><!-- Please do not remove - this tag is used to post select content to the Known problems page --> | <onlyinclude><!-- Please do not remove - this tag is used to post select content to the Known problems page --> | ||
* '''Not available in talk or discussion namespaces''' – In the English | * '''Not available in talk or discussion namespaces''' – In the English Stiles.casa Wiki, VisualEditor is not enabled for any talk pages, in the Template or Stiles.casa Wiki namespaces, and in several of the namespaces that are rarely edited. The "Edit" button for VisualEditor is not available on pages where VisualEditor cannot be used. The [[mw:Talk pages project/Replying|Reply tool]] has a visual mode based on VisualEditor, as well as a wikitext mode with a live preview. | ||
* '''Template parameters are wikitext, not rich text''' – VisualEditor lets you edit the parameters of template transclusions, but only as "wikitext" (so "<code><nowiki>[[Foo]]</nowiki></code>" or nested templates like "<code><nowiki>{{Foo|{{Bar}}}}</nowiki></code>", not "[[Foo]]" or "{{tlp|Foo|{{tl|Bar}}}}"). | * '''Template parameters are wikitext, not rich text''' – VisualEditor lets you edit the parameters of template transclusions, but only as "wikitext" (so "<code><nowiki>[[Foo]]</nowiki></code>" or nested templates like "<code><nowiki>{{Foo|{{Bar}}}}</nowiki></code>", not "[[Foo]]" or "{{tlp|Foo|{{tl|Bar}}}}"). | ||
* '''Incomplete editing functionality''' – The content of some complex formatting, including definition lists, will display and can be edited, but editors using VisualEditor cannot modify certain details. Multi-column lists are edited through the complex transclusion dialog, which is difficult. 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, will display and can be edited, but editors using VisualEditor cannot modify certain details. Multi-column lists are edited through the complex transclusion dialog, which is difficult. Table editing on Mobile doesn't work properly. Adding features in this area is one of the developers' priorities. | ||
* '''Some browsers not supported''' – VisualEditor works in almost all relatively modern (2012 or newer) versions of Chrome/Chromium, Firefox, Edge, Internet Explorer, Safari, Opera, Midori, Falkon (formerly Qupzilla), SeaMonkey and WebPositive (approximately 95% of all users). VisualEditor will never work in some browsers that do not follow web standards, including Android 2.3 or Internet Explorer 10 or prior. If VisualEditor is not available in your browser, or if you have turned off Javascript, then you will see the buttons for the wikitext editor only. | * '''Some browsers not supported''' – VisualEditor works in almost all relatively modern (2012 or newer) versions of Chrome/Chromium, Firefox, Edge, Internet Explorer, Safari, Opera, Midori, Falkon (formerly Qupzilla), SeaMonkey and WebPositive (approximately 95% of all users). VisualEditor will never work in some browsers that do not follow web standards, including Android 2.3 or Internet Explorer 10 or prior. If VisualEditor is not available in your browser, or if you have turned off Javascript, then you will see the buttons for the wikitext editor only. | ||
* '''Footnotes inside templates''' – Footnotes inside templates (most commonly, infoboxes and {{tl|reflist}}) are not visible in the "reuse" dialog, causing discrepancies in the numbering of footnotes displayed at the bottom of the main VisualEditor editing window. | * '''Footnotes inside templates''' – Footnotes inside templates (most commonly, infoboxes and {{tl|reflist}}) are not visible in the "reuse" dialog, causing discrepancies in the numbering of footnotes displayed at the bottom of the main VisualEditor editing window. | ||
* '''Numeric reference names''' – Currently, [[ | * '''Numeric reference names''' – Currently, [[Stiles.casa Wiki:VisualEditor/Named references|VE automatically adds numeric ref names]] with a colon prefix, i.e., ":0", ":1", ":2", and so on. There has [[m:Community Wishlist Survey 2019/Citations/VisualEditor: Allow references to be named|long been interest]] in having VE [[SW:VE:NAMEDREFS|support named references]]. | ||
* '''Unbalanced templates''' – VisualEditor struggles with templates that pass a bit of incomplete code, with markup, to another template or table. These may display oddly or may not be editable if selected in VisualEditor. | * '''Unbalanced templates''' – VisualEditor struggles with templates that pass a bit of incomplete code, with markup, to another template or table. These may display oddly or may not be editable if selected in VisualEditor. | ||
* '''Slower''' – Loading longer pages into VisualEditor can take 60 seconds or more for some users. | * '''Slower''' – Loading longer pages into VisualEditor can take 60 seconds or more for some users. | ||
* '''Cannot edit a single section''' – VisualEditor loads and submits only entire pages. Clicking an edit link for a section will scroll to the appropriate section upon opening. In VisualEditor's model, editing sections would be paradoxically slower than editing the whole page. [Note: Opening an entire page for editing does ''not'' increase [[Help:Edit conflict|edit conflicts]], which are (roughly) based on editing the same ''paragraph''.] | * '''Cannot edit a single section''' – VisualEditor loads and submits only entire pages. Clicking an edit link for a section will scroll to the appropriate section upon opening. In VisualEditor's model, editing sections would be paradoxically slower than editing the whole page. [Note: Opening an entire page for editing does ''not'' increase [[Help:Edit conflict|edit conflicts]], which are (roughly) based on editing the same ''paragraph''.] | ||
* '''Cannot upload non-free images''' – At this time, images that are uploaded inside either the wikitext editor or VisualEditor are sent directly to the [[Wikimedia Commons]], which does not accept non-free images. All images that fall under [[ | * '''Cannot upload non-free images''' – At this time, images that are uploaded inside either the wikitext editor or VisualEditor are sent directly to the [[Wikimedia Commons]], which does not accept non-free images. All images that fall under [[Stiles.casa Wiki:Non-free content|Stiles.casa Wiki's non-free content policy]] must instead be stored on Stiles.casa Wiki using the [[Stiles.casa Wiki:File Upload Wizard|File Upload Wizard]]. Commons also runs a filter to reject many images uploaded by editors who have not made many prior edits to Commons, especially for small or low-resolution images. | ||
* '''Unaware of table formatting done by templates''' – Popular [[Template:Table cell templates|table cell templates]] (e.g. yes, no, tba, n/a) can cause issues. The reason is that these templates contain a pipe character to separate formatting and text, but VisualEditor isn't aware of this. As a result, table operations which change the table structure, such as merging/splitting cells or inserting/deleting/moving rows or columns, may not work properly. | * '''Unaware of table formatting done by templates''' – Popular [[Template:Table cell templates|table cell templates]] (e.g. yes, no, tba, n/a) can cause issues. The reason is that these templates contain a pipe character to separate formatting and text, but VisualEditor isn't aware of this. As a result, table operations which change the table structure, such as merging/splitting cells or inserting/deleting/moving rows or columns, may not work properly. | ||
* '''Data in merged cells is deleted''' if rows or columns are moved across them. Workaround: Unmerge the affected areas before moving, and merge them again afterwards. | * '''Data in merged cells is deleted''' if rows or columns are moved across them. Workaround: Unmerge the affected areas before moving, and merge them again afterwards. | ||
| Line 52: | Line 52: | ||
== How to help out == | == How to help out == | ||
Help is needed to make VisualEditor as good as it can be: You can find and [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=VisualEditor report bugs and ideas for improvements] or lend a hand in many other tasks, such as: | Help is needed to make VisualEditor as good as it can be: You can find and [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=VisualEditor report bugs and ideas for improvements] 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 VisualEditor development team needs help [[ | * '''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 VisualEditor development team needs help [[Stiles.casa Wiki:VisualEditor/Help|updating help pages]]. The [[Stiles.casa Wiki:VisualEditor/User guide|user guide to VisualEditor]] is a starting place for text for the new help pages. | ||
* '''Adding TemplateData code to template documentation pages''' – VisualEditor features an interactive template editor—described in more detail in the [[ | * '''Adding TemplateData code to template documentation pages''' – VisualEditor features an interactive template editor—described in more detail in the [[Stiles.casa Wiki:VisualEditor/User guide|user guide]]—and as you'll see if you use it on Stiles.casa Wiki, some templates display named parameters and nice descriptions that make the interactive template editor easy to use. However, other templates lack them, because they need [[Stiles.casa Wiki:TemplateData|TemplateData]] code added to their documentation pages for this feature to work. If you're interested in adding TemplateData, read the [[Stiles.casa Wiki:VisualEditor/TemplateData tutorial|guide for it]] and a [[Stiles.casa Wiki:VisualEditor/TemplateData|list of some of the most transcluded templates]] that may still need TemplateData added to their documentation. | ||
* '''Help new users''' – Even though editing with VisualEditor may be easier, learning policies and guidelines and how to interact with the community is always challenging for new editors. You can help by spending time at the appropriate venues: the '''[[ | * '''Help new users''' – Even though editing with VisualEditor may be easier, learning policies and guidelines and how to interact with the community is always challenging for new editors. You can help by spending time at the appropriate venues: the '''[[Stiles.casa Wiki:Help desk|Help desk]]''', the '''[[Stiles.casa Wiki:Teahouse|Teahouse]]''', and the '''[[Stiles.casa Wiki:IRC help disclaimer|help chatroom]]'''. Additionally, please feel free to monitor the '''[[:Category:Stiles.casa Wikins looking for help|Category of Stiles.casa Wikins looking for help]]'''. | ||
{{ | {{Stiles.casa Wiki:VisualEditor/Newsletter}} | ||
== Userbox == | == Userbox == | ||
{{userbox top|extra-css=clear:both|toptext=VisualEditor [[ | {{userbox top|extra-css=clear:both|toptext=VisualEditor [[SW:userbox|userbox]]en}} | ||
{{User:Psiĥedelisto/Userboxes/VisualEditor}} | {{User:Psiĥedelisto/Userboxes/VisualEditor}} | ||
{{User:Psiĥedelisto/Userboxes/VisualEditor|adv=sometimes}} | {{User:Psiĥedelisto/Userboxes/VisualEditor|adv=sometimes}} | ||
{{User:Psiĥedelisto/Userboxes/VisualEditor|buggy=}} | {{User:Psiĥedelisto/Userboxes/VisualEditor|buggy=}} | ||
{{userbox bottom}} | {{userbox bottom}} | ||
You can signal to other editors your use of the VisualEditor on your [[ | You can signal to other editors your use of the VisualEditor on your [[SW:userpage|userpage]] by using the [[SW:userbox|userbox]] [[:User:Psiĥedelisto/Userboxes/VisualEditor]]. See that page for all the options available. | ||
== External links == | == External links == | ||
| Line 73: | Line 73: | ||
{{collapse top|Subpage Index}} | {{collapse top|Subpage Index}} | ||
{{Special:Prefixindex/ | {{Special:Prefixindex/Stiles.casa Wiki:VisualEditor/}} | ||
{{collapse bottom}} | {{collapse bottom}} | ||
{{ | {{Stiles.casa Wiki technical help|collapsed}} | ||
[[Category:VisualEditor| ]] | [[Category:VisualEditor| ]] | ||