View source for Help:VisualEditor/VE as the main editor

<languages/>
[[File:VisualEditor-logo.svg|240x240px|centre]]
<br />{{#ifeq:{{dir}}|ltr|{{TOC right}}|{{TOC left}} }}
<translate>
==About this page== <!--T:36-->
</translate>
<translate><!--T:37--> Here is a quick-start guide so that you can learn how to support your community while [[<tvar name=VE>Special:MyLanguage/VisualEditor</tvar>|the visual editor]] becomes available by default to editors at your wiki.</translate>
<translate><!--T:94--> Some points may not apply to you, because maybe the work has already been done. Yay!</translate>

<translate>
<!--T:38-->
Don't hesitate to request clarifications;  [[<tvar name=1>phab:T130533</tvar>|a "cross-wiki taskforce"]] of community members who have experience with the tasks listed below is also in the works, and they may be able to provide advice and support. '''[[<tvar name=tforce>Special:MyLanguage/Help:VisualEditor/Community_Taskforce</tvar>|You are invited to join the taskforce today!]]'''

<!--T:39-->
''Attention, translators: you are welcome to translate this resource. However, please bear in mind that further improvements on it are planned, so your translations may become obsolete soon. Thanks for your understanding!''

==Involve your community== <!--T:40-->
</translate>
<big>''<translate><!--T:41--> Discuss with community members; announce the rollout widely; update editing-related documentation; set up a dedicated sandbox for testing.</translate>''</big>

* <translate><!--T:42--> You are the expert here. You know about the best ways to '''involve your community''' to let them know the visual editor is now available for editors at your wiki —or may soon be— and to get further help with the following tasks. </translate>
**<translate><!--T:43--> You can start a conversation at your Village Pump in your language and then link to this page, or you can set up a [[<tvar name=notice>MediaWiki:Sitenotice</tvar>|sitenotice]], or a [[<tvar name=watchlist>MediaWiki:Watchlist-details</tvar>|watchlist notice]] for logged-in contributors, or use other methods which are known to work well for your community members. You will certainly receive multiple announcements and updates from community liaisons: please make sure that those are translated or at least summarized in your language.</translate>
**<translate><!--T:44--> You may want to create a sort of "WikiProject", or anyway a page where the community members who are interested in supporting you can sign up.</translate> 
** <translate><!--T:45--> Make sure that local documentation, especially pages read by new editors such as tutorials for newcomers, editing guides etc., mentions the visual editor and its documentation.</translate> 
**<translate><!--T:46--> You may want to provide a dedicated space (a sandbox in the main or in the User: namespace) where even logged-out editors can try the visual editor.</translate> <translate><!--T:47--> [<tvar name=sandbox>https://en.wikipedia.org/w/index.php?title=Wikipedia%3AVisualEditor&type=revision&diff=600302691&oldid=598467251</tvar> Here is an example] of how this was done on the English Wikipedia (note the <tvar name=1>''?veaction=edit''</tvar> string at the end of the URL).</translate>

<translate>
==Check translations status== <!--T:52-->
</translate>
<big>''<translate><!--T:53--> The rollout will be smoother once translations for interface and user guide, at a minimum, are in place!</translate>''</big>

* <translate><!--T:54--> There is '''key documentation to translate''', mainly the [<tvar name=guide>https://www.mediawiki.org/w/index.php?title=Special:Translate&group=page-Help%3AVisualEditor%2FUser+guide&action=page&filter=</tvar> User guide] and [<tvar name=interface>https://translatewiki.net/w/i.php?title=Special:Translate&group=ext-visualeditor-0-all&filter=%21translated&action=translate</tvar> the interface itself]. </translate>
*<translate><!--T:97--> If your wiki is getting the visual editor in conjunction with the single edit tab rollout, [[<tvar name=SET>Special:MyLanguage/VisualEditor/Single edit tab</tvar>|the related page]] will help you explain what this change is about.</translate> <translate><!--T:55--> The page you are reading now is also a good resource to consider.</translate> 
** <translate><!--T:56--> For more information and instructions, please see <tvar name=1>{{ll|VisualEditor/TranslationCentral}}</tvar>.</translate>

<translate>
== Make sure main templates feature TemplateData information == <!--T:57-->
</translate>
<big>''<translate><!--T:58--> Filling infoboxes and Cite templates in particular will be so much easier with the visual editor.</translate>''</big> 

* <translate><!--T:59--> <tvar name=1>{{ll|Help:TemplateData}}</tvar> contains information about how to '''add TemplateData information to common templates''' on your wiki.</translate> <translate><!--T:60--> This is important because it will make editing a template similar to filling a form, and just as easy.</translate>
** <translate><!--T:61--> There is now an [[<tvar name=tdgui>Special:MyLanguage/Help:TemplateData#TemplateData_editor</tvar>|editing tool]] that allows you to add TemplateData in a simpler way.</translate>
** <translate><!--T:62--> Start with templates that are often used in articles, such as citation and reference templates, as well as infoboxes. The <tvar name=1>[[Special:MostTranscludedPages]]</tvar> special page on your wiki might help you find out which are the most important templates you need to work on. The ones which are heavily used in the article namespace have the priority.</translate>
** <translate><!--T:63--> Check how other wikis did this. For example, [[<tvar name=templates>:en:Template:Cite_web/doc#TemplateData</tvar>|here is the TemplateData]] for the <tvar name=1>''<nowiki>{{Cite web}}</nowiki>''</tvar> template at the English Wikipedia. If you recently imported <tvar name=1>''<nowiki>{{Cite web}}</nowiki>''</tvar> from that wiki and didn't customize it further, then copying and pasting their TemplateData will probably work for you.</translate>

<translate>
==Add locally popular Cite templates to the Cite menu== <!--T:68-->
</translate>
<big>''<translate><!--T:69--> What are the templates that your community uses the most to create citations? The visual editor has a dedicated menu, a sort of shortcut to reach them!</translate>''</big>

*<translate><!--T:70--> '''Set up a customized <tvar name=cite>{{int|cite-ve-toolbar-group-label}}</tvar> menu''' with the most used <tvar name=cite>{{int|cite-ve-toolbar-group-label}}</tvar>  templates at your wiki. Note that when Citoid is enabled, such a menu will be available from the "<tvar name=manual>{{int|Citoid-citefromiddialog-mode-manual}}</tvar>" tab of the <tvar name=citetwo>{{int|citoid-citefromidtool-title}}</tvar> dialog.</translate> <translate><!--T:95--> If your wiki uses plain <tvar name=1>{{tag|ref|open}}</tvar> tags instead, you can consider skipping this step.</translate>
*<translate><!--T:71--> See the [[<tvar name=cite>Special:MyLanguage/VisualEditor/Citation_tool#Citation_tool_definition</tvar>|instructions page at mediawiki.org]] to learn more about this.</translate>
*<translate><!--T:123--> If your wiki doesn't really use templates for citations, we recommend simply importing the most recent version of Template:Citation and then enable Citoid using only the single template.</translate>

<translate>
==Enable Citoid on your wiki== <!--T:72-->
</translate>

[[File:Auto-citing a source using VisualEditor, small.gif|{{dir|{{pagelang}}|left|right}}|300px]]
<big>''<translate><!--T:73--> Interested in easier and painless referencing? With this powerful tool it's as easy as copying and pasting a URL.</translate>''</big>

*<translate><!--T:74--> '''Configure Citoid''', which automatically creates a citation template for you from several types of sources.</translate>
*<translate><!--T:75--> See the [[<tvar name=citoid>Special:MyLanguage/Citoid/Enabling Citoid on your wiki</tvar>|instructions page at mediawiki.org]] to learn more about this.</translate>
<br />


<translate>
==Customize the Special Characters menu== <!--T:64-->
</translate> 
<big>''<translate><!--T:65--> The characters that your community uses the most can get a prominent place in the related visual editor menu.</translate>''</big>

*<translate><!--T:66--> You can '''add special characters''' which are relevant to your language to the existing set of characters.</translate> 
*<translate><!--T:67--> See the [[<tvar name=chars>Special:MyLanguage/VisualEditor/Special characters</tvar>|instructions page at mediawiki.org]] to learn more about this.</translate>

<translate>
==Make developers aware of issues raised locally== <!--T:76-->
</translate>
<big>''<translate><!--T:77--> Become an ambassador for your community by making sure the development team knows about problems or wishes you're hearing.</translate>''</big>

*<translate><!--T:78--> '''Check and communicate about bugs''' reported on the village pump (or at the local feedback page, if your wiki has one); see [[<tvar name=1>phab:tag/visualeditor</tvar>|if they are already known to developers]].</translate>
*<translate><!--T:79--> [[<tvar name=phab>Special:MyLanguage/Phabricator</tvar>|Reporting bugs or feature requests directly on Phabricator]] will catch the developers' attention more quickly.</translate> <translate><!--T:80--> You can [[<tvar name=howto>Special:MyLanguage/Phabricator/Help#Creating_a_task</tvar>|learn how to file a task]] on this site.</translate> <translate><!--T:81--> A mention of the report and any updates to it will also appear live in the <tvar name=1>''#mediawiki-visualeditor''</tvar> IRC channel.</translate>
*<translate><!--T:82--> You may also report problems by leaving a message at the [[<tvar name=fback>Special:MyLanguage/VisualEditor/Feedback</tvar>|central feedback page on this site]].</translate>

<translate>
==Check how things go after the rollout== <!--T:83-->
</translate>
<big>''<translate><!--T:84--> We set up a deployment process keeping your needs in mind. So, let us know what you're observing in the first weeks after the visual editor lands at your wiki.</translate>''</big> 

*<translate><!--T:85--> Patrollers might want to '''keep an eye on the log of edits''' made with the visual editor for a few weeks. You can reach it from [<tvar name=rchanges>https://en.wikipedia.org/w/index.php?title=Special:RecentChanges&tagfilter=visualeditor</tvar> this link] (you'll need to change language code and sister project name in the browser's address bar after you click on it!).</translate>
*<translate><!--T:86--> Experienced users may make more mistakes than expected at the beginning, as they need some time to adapt to the new environment.</translate>

<translate>
==Keep yourself and your community up-to-date on visual editor news== <!--T:87-->
</translate>
<big>''<translate><!--T:88--> We publish a multilingual bimonthly newsletter so you can learn about new, exciting features as they are made available, and about planned improvements.</translate>''</big>

*<translate><!--T:89--> '''Sign up for the [[<tvar name=news>m:Special:MyLanguage/VisualEditor/Newsletter</tvar>|newsletter]]''', and please add your name [[<tvar name=translators>m:Special:MyLanguage/VisualEditor/Newsletter/Translators</tvar>|to the translators' list]] so that other people at all projects in your language will be able to read the bulletin in your language on community pages there. </translate> 

<translate>
==Learn about existing gadgets and how to develop new ones== <!--T:90-->
</translate>
<big>''<translate><!--T:96--> In time, community members have developed code to expand the visual editor's capabilities.</translate>''</big>

* '''{{ll|VisualEditor/Gadgets}}''' - <translate><!--T:124--> Learn how to '''write gadgets''' and customize the visual editor to your or your community needs</translate>
* {{ll|VisualEditor/Gadgets#Real examples for gadgets/scripts that interact with VE|2=<translate><!--T:125--> Examples for scripts that interact with the visual editor.</translate>}} - <translate><!--T:126--> Please add yours!</translate>

<translate>
== In a nutshell—rating of tasks on this page == <!--T:98-->
</translate>
{| class="wikitable"
|-
| <translate><!--T:99--> Tell the Wikimedia Foundation about your intentions</translate>
|'''<translate><!--T:100--> Important</translate>'''
|-
| <translate><!--T:101--> Involve your community</translate>
|'''<translate><!--T:102--> Important</translate>'''
|-
| <translate><!--T:103--> Check translations status</translate>
|'''<translate><!--T:104--> Important</translate>'''
|-
| <translate><!--T:105--> Make sure main templates feature TemplateData information</translate>
|'''<translate><!--T:106--> Important</translate>'''
|-
| <translate><!--T:107--> Add locally popular Cite templates to the Cite menu</translate>
| <translate><!--T:108--> '''Nice to have''' (if plain references tags are the norm for your wiki; if it does use Cite templates instead, then this point is an '''important''' one)</translate>
|-
| <translate><!--T:109--> Enable Citoid on your wiki</translate>
| <translate><!--T:110--> '''Nice to have''' (but [[<tvar name=gif>Special:MyLanguage/VisualEditor/GIFs#auto-citing</tvar>|check how it works]], and you'll tell us!)</translate>
|-
| <translate><!--T:111--> Customize the Special Characters menu</translate>
|'''<translate><!--T:112--> Nice to have</translate>'''
|-
| <translate><!--T:113--> Make developers aware of issues raised locally</translate>
|'''<translate><!--T:114--> Important</translate>'''
|-
| <translate><!--T:115--> Check how things go after the rollout</translate>
|'''<translate><!--T:116--> Nice to have</translate>'''
|-
| <translate><!--T:117--> Keep yourself and your community up-to-date on visual editor news</translate>
|'''Nice to have'''
|-
| <translate><!--T:118--> Learn about existing gadgets and how to develop new ones</translate>
|'''<translate><!--T:119--> Nice to have</translate>'''
|}

<translate>
==Community-created resources== <!--T:120-->

<!--T:121-->
*[[<tvar name=ja-help>:ja:Help:ビジュアルエディター</tvar>|Shorter, essential user guide]] to the visual editor (on ja.wiki)</translate>
<translate>
<!--T:127-->
*[[<tvar name=el-video>:c:Category:VisualEditor_greek_videos</tvar>|Videos]] about using the visual editor (in Greek); [[<tvar name=de-video>:File:Tutorial 3 Arbeiten im Visual Editor.webm</tvar>|video]] about using the visual editor (in German)</translate>
<translate>
<!--T:128-->
**[[<tvar name=cs-video>:File:Automatizovan%C3%A9_vkl%C3%A1d%C3%A1n%C3%AD_citac%C3%AD_na_%C4%8Desk%C3%A9_Wikipedii.webm</tvar>|video]] about using the automatic reference system (in Czech)</translate>
<translate>
<!--T:129-->
*[[<tvar name=enwp-intro>:en:Help:Introduction to editing (VE)/1</tvar>|Introduction to editing]], [[<tvar name=enwp-intro-ref>:en:Help:Introduction to referencing (VE)/1</tvar>|to referencing]] and [[<tvar name=enwp-intro-img>:en:Help:Introduction to images (VE)/1</tvar>|to uploading images]] with the visual editor (en.wiki) - also implemented on the [[<tvar name=es-intro>:es:Ayuda:Introducción</tvar>|Spanish Wikipedia]]</translate>
<translate>
<!--T:130-->
*[[<tvar name=de-overview>:de:Benutzerin_Diskussion:Lómelinde/Übersicht</tvar>|Overview]] and [[<tvar name=de-working>:de:Hilfe:VisualEditor/Bedienung</tvar>|help about working]] on the German Wikipedia

<!--T:122-->
*... add yours!
</translate>

:<translate><!--T:92--> Please '''[[<tvar name=fback>Special:MyLanguage/VisualEditor/Feedback</tvar>|let the visual editor team know]]''' if you have further questions.</translate> 
:<translate><!--T:93--> '''[[<tvar name=portal>Special:MyLanguage/VisualEditor/Portal</tvar>|Click here]]''' to go to the main visual editor page.</translate>