View source for Help:VisualEditor

[[File:Edit button.png|alt=Location of VisualEditor ("Edit" tab) and Enhanced Editor ("Edit source" tab)|thumb|400x400px|Location of VisualEditor ("Edit" tab) and Enhanced Editor ("Edit source" tab)]]{{Clear right}}
{{Shortcut|H:VE}}
[[File:Adding a link using the visual editor.gif|400px|thumbnail|right|Using the visual editor to add a link on the English Wikipedia article {{W|African crake}}]]
{{#ev:youtube|u577WkW2TVY|400|right|Wikipedia: Editing Basics (Visual Editor)}}
{{#ev:youtube|JFEBPZBbHp8|400|right|Editing [[Wikipedia]] in VisualEditor}}

'''VisualEditor''' ('''VE''') is a simplified tool to edit [[Saintapedia]] that allows you see the effect of any change immediately on the page (commonly referred to as [[What You See Is What You Get]]).  It does not require editors to use the [[Editing toolbar]] to learn [[wikitext]] to edit existing content.  

Editing articles purely in wikitext is and will remain an option using the [[Enhanced editor|enhanced editor]] and editing toolbar.  This may be the preference for experienced editors because they might find it faster and more precise.  Even editors who enable VisualEditor will have the wikitext option available from the toolbar for each page and section.

== VisualEditor toolbar ==
[[File:VisualEditor toolbar-en.png|frameless|center|1000px|alt=Screenshot of the VisualEditor toolbar]]

The VisualEditor toolbar appears at the top of the screen when you begin editing. It includes some familiar icons.

=== Undo and redo ===
[[File:VisualEditor - Toolbar - Undo-redo.png|frameless|border|150px|right]]

You can '''Undo''' and '''Redo''' the changes you have made.

* Undo ({{Keypress|CTRL}} + {{Keypress|Z}}) - erases the last change done to the document reverting it to an older state
* Redo ({{Keypress|CTRL}} + {{Keypress|Shift}} + {{Keypress|Z}} or {{Keypress|CTRL}} + {{Keypress|Y}}) - reverses the undo or advances the buffer to a more current state

=== Headings ===
[[File:VisualEditor Toolbar Headings-en.png|frameless|border|350x350px|right]]
{{Headings}}
The [[Headings]] pull-down menu: allows you to change how the paragraph is formatted. To change the style of a paragraph, put your cursor in the paragraph and select an item in this menu (you don't have to highlight any text). [[Section]] titles are formatted "Heading", and subsections are "Heading 2", "Heading 3", and so on. The normal format for text is "Paragraph".

* Paragraph ({{Keypress|CTRL}} + {{Keypress|0}}) - a self-contained unit of a discourse in writing dealing with a particular point or idea
* Heading ({{Keypress|CTRL}} + {{Keypress|2}}) - You should always start adding sections with level 2 sections (Headings)
* Sub-heading 1 ({{Keypress|CTRL}} + {{Keypress|3}}) - the 1st section level (sub-section), under Headings
* Sub-heading 2 ({{Keypress|CTRL}} + {{Keypress|4}}) - the 2nd section level (sub-section), under Sub-heading 1
* Sub-heading 3 ({{Keypress|CTRL}} + {{Keypress|5}}) - the 3rd section level (sub-section), under Sub-heading 2
* Sub-heading 4 ({{Keypress|CTRL}} + {{Keypress|6}}) - the 2nd section level (sub-section), under Sub-heading 3
* Preformatted ({{Keypress|CTRL}} + {{Keypress|7}}) - See [[Enhanced editor]] version at [[Help:Formatting#Preformattedtext]]
* Block quote ({{Keypress|CTRL}} + {{Keypress|9}}) - See [[Enhanced editor]] version at [[Help:Formatting#Blockquotes]]
* Page title ({{Keypress|CTRL}} + {{Keypress|1}}) - Level 1 should not be used for [[Saintapedia:Accessibility|Accessibility]] reasons

{{Clear}}

[[Category:Graphic templates|Multiple image]]
[[Category:Help]]
[[Category:Pages with the Cats template]]
[[Category:Pages with videos]]

[[Category:Saintapedia formatting and function templates|Clear]]
[[Category:Templates with TemplateData]]
[[Category:Templates with print versions]]

=== Formatting ===
{{multiple image
| header    = Two formatting menu lists
| width     = 200

| image1    = Short format list.png
| alt1      = Short format list
| caption1  = Short format list

| image2    = VisualEditor Toolbar Formatting-en.png
| alt2      = Full list
| caption2  = Full list
}}

Clicking the "'''A'''" opens a menu.  There are two levels of formatting options.

If no text is selected when you click the "'''A'''" to open the menu, then when you select an item, that formatting will apply to the text that you start typing, from wherever your cursor is located.

==== Short list ====
This can be expanded to Full list by clicking on the word "More" or the down arrow next to it.

* The "Bold" item ('''B''', {{Keypress|CTRL}} + {{Keypress|B}}) bolds the selected text.
* The "Italic" item (''I'', {{Keypress|CTRL}} + {{Keypress|I}}) italicizes the selected text.
* "Clear styling" ([[File:VisualEditor MediaWiki theme clear icon bitmap.png ]], {{Keypress|CTRL}} + {{Keypress|\}} or {{Keypress|CTRL}} + {{Keypress|M}}) - removes all character formatting from the selected text, including links. 

==== Full list ====
This can be shortened to Short list by clicking on the word "Fewer" or the up arrow next to it.

* The "Bold" item ('''B''', {{Keypress|CTRL}} + {{Keypress|B}}) bolds the selected text.
* The "Italic" item (''I'', {{Keypress|CTRL}} + {{Keypress|I}}) italicizes the selected text.
* The "Superscript" item (x<sup>2</sup>, {{Keypress|CTRL}} + {{Keypress|.}}) causes the selected text to appear smaller than surrounding text and to be slightly higher than the surrounding text.
* The "Subscript" item (x<sub>2</sub>, {{Keypress|CTRL}} + {{Keypress|,}}) causes the selected text to appear smaller than surrounding text and slightly lower than the surrounding text.
* The "Strikethrough" item (<strike>S</strike>, {{Keypress|CTRL}} + {{Keypress|Shift}} + {{Keypress|5}}) adds a solid bar through the selected text.
* The "Computer code" item ({{Keypress|CTRL}} + {{Keypress|Shift}} + {{Keypress|6}}) - a set of curly brackets: {}) changes the font of the selected text to a monospaced font, which sets it apart from surrounding (proportionally spaced) text.
* The "Underline" item (, {{Keypress|CTRL}} + {{Keypress|U}} - adds a solid line beneath the selected text (such as <span style="text-decoration: underline;">U</span>)
* The "Language" item (Aあ) allows you to label the language (for example, Japanese) and direction (for example, right-to-left) of the selected text.
* Big - Increase the font size
* Small - Decreases the font size
* "Clear styling" ([[File:VisualEditor MediaWiki theme clear icon bitmap.png ]], {{Keypress|CTRL}} + {{Keypress|\}} or {{Keypress|CTRL}} + {{Keypress|M}}) - removes all character formatting from the selected text, including links.

=== Linking tool ===
[[File:VisualEditor - Toolbar - Linking.png|frameless|border|50x50px|left]]

Link important words to other wiki articles or even other websites.  It will help the reader understand the context.  Click on the chain icon opens the linking tool and will allow you to type or search for an article to link.  '''See the [[#Links|links]] section''' below for more information about the tool.

Alternatively, if you selecting some text and click on it, the link tool will populate the search with the text you selected.
{{Clear}}

=== Cite menu ===
[[File:VisualEditor - Cite Pulldown.png|frameless|border|100x100px|right]]

The "Cite" menu is used to add inline citations (also called "footnotes" or "references"). All projects have access to "Basic" reference formatting and the ability to "Re-use" citations, using this menu. This menu also gives you quick access to local citation templates, if these are enabled on your wiki.

See [[#Editing references]] for more details.

=== Lists and indentation ===
[[{{#ifexist: Media:VisualEditor Toolbar Lists and indentation-{{CONTENTLANGUAGE}}.png|File:VisualEditor Toolbar Lists and indentation-{{CONTENTLANGUAGE}}.png|File:VisualEditor Toolbar Lists and indentation-en.png}}|frameless|border|300px|right]]

The first two items allow you to format text as either a "Bullet list" or a "Numbered list". The last two items allow you to decrease or increase the indentation level of list items.

* Bullet list
* Numbered list
* Decrease indentation ({{Keypress|Shift}} + {{Keypress|Tab}}  or {{Keypress|Ctrl}} + {{Keypress|[}})
* Increase indentation ({{Keypress|Tab}} or {{Keypress|Ctrl}} + {{Keypress|]}})
{{Clear}}
See [[#Lists]] below for more details.

=== Insert ===
[[File:VisualEditor Insert Menu-en.png|411x411px|alt=Screenshot of the the full list of options under Visual Editor's insert menu|thumb|Screenshot of the the full list of options under VisualEditor's insert menu]]
The "Insert" menu may be different on some projects. Below is a list of all options that may appear. 
* The "Media" item [[File:VisualEditor media icon.PNG|23px]] opens the [[Help:Visual editor#Images and other media files|media dialog]].
* The "Template" item [[File:VisualEditor template icon.PNG|23px]] allows you to [[Help:Visual editor#Templates|edit templates]].
* The "Table" item [[File:VisualEditor table icon.PNG|23px]] allows you to insert a table.
* The "Comment" item [[File:VisualEditor comment icon.PNG| 23px]] allows you to insert [[Help:Comments|comments]] that are not visible to readers; these comments can be seen only when in edit mode and are then indicated by an exclamation mark icon.
* Your signature
* The "Gallery" item [[File:Gallery icon.png]] allows you to insert a gallery to the page.
* Code block
* Reference list

=== Special character insertion ===
The "Special character" ('''Ω''') item on the "Insert" menu, when clicked, displays a dialog showing many special characters. By clicking on a specific character, you place it into the text where your cursor is located. These special characters include some standard symbols, accents, and mathematical symbols. (This list may be customized locally. See [[VisualEditor/Special characters]] for instructions.)
[[File:VisualEditor_Toolbar_SpecialCharacters-en.png|border|center|frameless|1100x1100px]]

=== Page options ===
[[File:VisualEditor More Settings-en.png|frameless|350x350px|border|right]]
The '''Page options''' menu is to the left of the '''Publish changes''' button. On this menu there are options to adjust page settings, such as whether the page is a redirect, or how it is indexed; to add, edit, or delete categories; and to see, using the '''Language''' item, the list of articles on the same subject that are in other languages. See [[#Options]] below for more details.

You can also switch (one-way only) from VisualEditor to the classic wikitext source editor without losing the editing work you've done.

=== Switch to old editor ===
[[File:Switching from the visual editor to the wikitext editor.gif|500x500px|alt=Switching from the visual editor to the wikitext editor, while preserving changes, on the English Wikipedia|thumbnail|Switching from the visual editor to the wikitext editor, while preserving changes, on the English Wikipedia]]
[[File:Visual editor - switch to source editor.png|300x300px|alt=Menu option to switch to source editor|thumbnail|Menu option to switch to source editor|left]]

It is possible to switch from Visual editor to the [[Help:Enhanced editor|Enhanced editor]] with the [[Help:Editing toolbar|Editing toolbar]].

The editing toolbar appears above the edit/text box and functions partly as a typing aid and partly as a reminder of the available functions.

This allows editors to copy the complete contents of a page to another page, such as moving an article from a [[Sandbox]] to the [[Main namespace]].

{{clear}}

== Editing options ==
[[File:Visual editor edit options.png|300x300px|thumbnail|Edit options]]

To edit a page using the visual editor, click on the "Edit" tab at the top of the page.  A loading bar should appear.  It may take a few seconds for the page to open for editing, and longer if the page is very long.
* You still have the option to use the classic [[Edit toolbar]] by clicking on the "Edit source" tab.
* The "View History" tab will bring you to the [[Article history]].
* The "Read" tab is the default and will bring you out of either edit modes or back to the text from the article history

=== Section editing ===
[[File:VisualEditor - Section edit links.png|200x200px|thumbnail|Section edit links]]
{{Main|Section editing}}

You are able to edit individual [[sections]] with either editor:
# open VisualEditor by clicking on the "edit" link on each section
# open the [[Enhanced editor]] with [[Editing toolbar]]

== Saving changes ==
[[File:VisualEditor toolbar actions-en.png|frameless|border|300px|right]]

When you're done editing, click the blue '''Publish changes''' button in the toolbar. If you have not made any changes, the button will be disabled (grayed out). To cancel all your editing changes, just close your browser window.

=== Publish box and edit summary ===
[[File:VisualEditor save dialog-en.png|frameless|border|right|442x442px]]

Pressing the blue "Publish changes" button opens a  "Save your changes" dialog box. On that box there are a couple of options.
* In the large text box, you should enter a brief summary of your actions, mark your edit as minor, and add the page to your [[Help:Watchlist|Watchlist]]. The box for the summary is the equivalent of the [[Help:Article history#Edit Summaries|edit summary]] field in the [[wikitext editor]].
* You can also review your changes using the "Review your changes" button to be sure they will work as intended before saving your changes. This is similar to the  "[[Show preview]]" button in the [[Enhanced editor]] summary section of each page. (see below)
* The "Resume editing" button returns you to the page you were editing. You can save and publish all of your changes later.

=== Review your changes ===
On the "Review your changes" screen, you to see the results of your changes.  Below the blue "Save changes" button, it is possible to toggle between the two ways, Visual or Wikitext, of viewing those changes.  From this screen, you can also either:
* Save changes - The edit summary you entered, if at all, on the "Save your changes" screen will be added to your edit
* "Resume editing" button returns you to the page you were editing.
* "Return to save form"  will bring you back to "Save your changes" screen"
{| class="wikitable"
|+
!VisualEditor
!Wikitext
|-
|[[File:Visual review changes.png|left|thumb|500x500px]]
|[[File:Wikitext review changes.png|left|thumb|500x500px]]
|}

=== Resume editing ===
Clicking on the "Resume editing" will allow you to continue editing, while preserving any edit summary you might have already drafted.  Using the {{Key press|Esc}} on your keyboard achieves the same results.







== Links ==
[[File:VisualEditor - Toolbar - Linking.png|frameless|border|200px|right]]
[[File:Adding a link using the visual editor.gif|400px|thumbnail|right|Using the visual editor to add a link on the English Wikipedia article {{W|African crake}}]]

Links can be added through the "Link" icon (links in a chain) in the toolbar, or by using the shortcut {{Keypress|Ctrl}} + {{Keypress|K}} on PC (or {{Keypress|⌘}} + {{Keypress|Command}} + {{Keypress|K}} on a Mac).

If you select (highlight) text and then press the "Link" button, that text will be used in creating the link. For a link that involves just one word, you can either select that word or just put the cursor within that word.  If you select (highlight) text and then press the button, that text will be used in creating the link. For a link that involves just one word, you can either select that word or just put the cursor within that word.

=== Search ===
When you use either the button or the shortcut, a dialog box will open in which you may type the name of the article to link it.

[[File:VisualEditor-link tool-search results.png|frameless|border|center|300px]]

=== Adding internal links ===
VisualEditor will try to help with '''[[Internal link|internal]]''' links by looking for likely matches.

Once you have entered or selected the link, you complete the linking process by pressing {{key press|Enter}} or by pressing the "Done" button. Your link will immediately appear on the VisualEditor page but, as with other changes to the page, it will not be saved until you 'Publish' the entire page.

[[File:VisualEditor link tool 2015.png|frameless|border|center|400px]]

==== File links ====
[[File links]] can be added.  It is still recommended to use one of the [[Help:Media templates|Media templates]] for PDF, Word, Excel, or PowerPoint files.  Unfortunately they often show up as red links in the tool, until the page saved.
=== Adding external links ===
To link to an external web page on another website, the process is the similar:  Choose the "External link" tab, and enter a URL in the box.

[[File:VisualEditor-link tool-external link.png|frameless|border|400px|center]]

External links without labels look like this: [http://example.com].  You may add these by placing your cursor away from any word (e.g., after a space). Open the link tool by clicking on the button or pressing the shortcut keys. Type or paste the URL into the box, and click the "Done" button.

[[File:VisualEditor link tool simple link.png|frameless|border|400px|center]]

=== Removing link ===
To change or remove an existing link, click within the text for that link, then press the "Link" icon that appears near it. The dialog box will appear for editing. (You may also get to the dialog with the {{key press|Ctrl|K}} keyboard shortcut.)

In the link editing dialog, you can then change where the link goes. You can also remove the link altogether by pressing the "Remove" button in the lower left corner of the dialog. You can also open the link's target in another window by clicking on the "⧼visualeditor-linkinspector-open⧽" button. Also, you might want do this to check if an external link is valid.

[[File:VisualEditor-context menu-link tool.png|frameless|border|400px|center]]

== References ==
{{Main|References}}
Saintapedia's Visual Editor has the simplest of Visual editor's three footnote systems.  There is a plan to upgrade to a more sophisticated system.  Until that time, details on the other systems will be stored at [[Help:References (Visual editor)]].

=== Simplest system ===
[[File:VisualEditor cite menu default.png|frameless|border|right|200px]]

The one shown on the right is the simplest system, where the "Cite" menu does not include any citation templates. If your wiki uses this system, then everything you need to know about footnotes is on this page.

=== Adding a new reference ===
To add a citation using the "Cite" menu, place your cursor where you want to add it in the text. Then select the "Basic" citation type in the menu.

In the Reference editor, you can add your citation and there are a number of menus to help you with that process:
* [[#Formatting|Format menu]]
* [[#Linking tool|Linking tool]]
* [[#Insert|Insert menu]]
* [[#Special character insertion|Special symbols]]

{{multiple image
| align     = left
| header    = These are the options for the Insert menu
| width     = 400

| image1    = VE Reference Insert menu.png
| alt1      = Insert menu - collapsed
| caption1  = Insert menu - collapsed

| image2    = VE Reference Insert menu - More 1.png
| alt2      = Insert menu - expanded - part 1
| caption2  = Insert menu - expanded - part 1

| image3    = VE Reference Insert menu - More 2.png
| alt3      = Insert menu - expanded - part 2
| caption3  = Insert menu - expanded - part 2
}}
{{Clear}}

You can make the reference belong to a given group, although normally this is left blank. (This option is used to display groups of references with the "References list" tool.)

[[File:VisualEditor - Editing references 20.png|frameless|border|500px|center]]

If you are using several groups of references, which is relatively rare, you may specify the group in this dialog. Only the references that belong to that group will be displayed on the page at the location where you are placing the group.

[[File:VisualEditor references list-en.png|frameless|border|center|500px]]

The final step in the References list dialog is to click "Insert".

=== References list ===
The References list allows you to specify where the references will appear on a page.  By default they appear at the bottom of the page.  With [[Enhanced editor]], {{tlx|Reflist}} or {{tlx|Add refs}} were used.

If no list of references is on the page (for example, if you're adding the first reference for the page), you need to specify where the list of references, and their text, will be displayed to the reader.  Place the cursor where you want to display the references list (usually at the bottom of the page), open the "Insert" menu and click the "References list" icon (three books).

=== Editing an existing reference ===
To edit an existing reference, click on it where it appears in the text (usually as a bracketed number). You will see either a "Reference" icon (bookmark) or an icon (and name) for the template that was used to create this reference. In either case, clicking on the "Edit" button will open a dialog where you can edit the reference.

[[File:VisualEditor - Editing references 1.png|frameless|border|400x400px|center]]

For the "Reference" icon, clicking "Edit" opens the Reference dialog. To start changing the reference information, click on it.
Many wikis use templates to format references. If a template is used in your reference, then when you move your pointer over the reference information, all the information in that field will be highlighted .

[[File:VisualEditor - Editing references 6.png|frameless|border|center|400x400px]]

=== Re-using an existing reference ===
[[File:VisualEditor cite menu default.png|frameless|border|right|200px]]

If the page already contains a citation that applies to the text you want to source, then you can choose to re-use that existing citation.

To re-use an existing reference, place your cursor in the body of the text where you want to add a new reference (number) for that citation. Then click on the "Re-use reference" item from the "Cite" menu. (Note: When Saintapedia gets the third footnote system described at [[Help:References (Visual editor)]], you'll see a "Re-use" tab, in a dialog, instead of a "Re-use" item on the "Cite" menu.)

In the Reference dialog, look at the list for the reference you want to reuse, and select it. If there are many references, you can use the search box (labeled "Search within current citations") to list only those references that include certain text.

[[File:VisualEditor - Editing references 18.png|frameless|border|500px|center|An example of the list of references available for reuse]]

== Images and other media files ==
=== Adding an image ===
[[File:VisualEditor Media Insert Menu-en.png|frameless|border|200px|right]]
[[File:Adding an image using the visual editor.gif|400px|thumbnail|right|Using the visual editor to add an image to the English Wikipedia article {{W|Suleiman the Magnificent}}]]
[[File:Adjust-image-size-and-location.gif|500x500px|thumbnail|Adjusting an image's size and location]]

To add a new image (or another type of media file) to the page, click the Media item [[File:VisualEditor media icon.PNG|23px]] icon in the "Insert" menu. The image will be added where your cursor is located.

Clicking the "Media" icon opens a dialog box that automatically searches Saintapedia for media files related to the title of the page being edited.

Change the search by changing the text in the dialog's search box.

To choose a file, click on its thumbnail image to place the image onto the page being editing.

[[File:VisualEditor - Media editing 2.png|frameless|border|center|500px]]

{{Anchor|MediaSettings}}
After the image you selected is inserted into the page, another dialog will open. This dialog allows you to add and edit the caption of the image. The caption can contain formatting and links. 

You can use the caption to show a label that shows next to the item for all readers. This is often used to explain why the item is relevant to the context in which it is shown. It should be succinct and informative.

[[File:VisualEditor - Media editing 6.png|frameless|border|center|500px]]

The media dialog also allows you to add alternative text captions, to help users who use screen readers, or who have disabled image display.

You can use this to write a text description for people who can't see the item. The description should be enough for them to understand the purpose and information given by the media item. This is vital for blind users and other people using screen-reader software or text-only browsers.

[[File:VisualEditor - Media editing 7.png|frameless|border|center|450x450px]]

{{Anchor|AdvancedImage}}You can also set various parameters for the image in the "Advanced settings" window. These include the alignment, the type, and size of the image.

[[File:VisualEditor - Media editing 8.png|frameless|border|center|500px]]
* Position - You can set where this media item appears on the page. This is sometimes used to break up a long line of images on one side of the page.
* Wrap text around this item - You can make this media item appear inline with the text of the page instead of floating. You should only do this rarely, as it will break up the flow of the text if you uncheck this box.
* Image type - You can set how the media item appears on the page. This should be the thumbnail format to be consistent with other pages in almost all cases.
* Image size - You can set how large the media item appears on the page. This should almost always be the normal size, as a custom size will interfere with the layout of the page for readers and make it inconsistent.

When you're done, click "Apply changes" to close the dialog and return to editing the page.

[[File:VisualEditor Apply Changes-en.png|frameless|border|center|150px]]

For an existing image, you can add or edit a caption or other settings by clicking on the image, then clicking on the "Media" icon that appears below the picture.
{{Anchor|Resize}}
You can resize an existing image by clicking on it, then moving the resize icon (the two-headed arrow on one or both bottom corners).

You can also drag and drop an image to a place higher or lower on the page.

[[File:VisualEditor - Media editing 3.png|frameless|border|center|360px]]

=== Uploading images ===
{{Main|Help:Upload image wizard}}

You can upload images from a tab in the media dialog.

[[File:VisualEditor - Media upload 1.png|frameless|400px|center]]

Click the "Upload" tab and select an image from your computer. You can type the file name, or drag an image into the box.

[[File:VisualEditor - Media upload 1.png|frameless|400px|center]]

Describe the image and add categories to it so that other people can find it.

[[File:VisualEditor - Media upload 2.png|frameless|400px|center]]

The image will be inserted into the page when you are done.

=== Media galleries ===
[[File:VisualEditor - Gallery1.png|frameless|border|643x643px|right]]

To add a new gallery, click the "Gallery" icon (a set of photos) on the "Insert" menu. (If you don't see this icon on that menu, then your local wiki has decided to delay implementing this functionality in VisualEditor.) 

To edit an existing gallery in VisualEditor, click that gallery. Then, near the bottom of the gallery, click the gallery icon (a set of photos). This brings up the gallery editor, with the full list of images included in the gallery.

[[File:VisualEditor - Gallery2.png|frameless|border|center|500px]]

The gallery editor is currently a simple box that allows you to edit existing galleries using wikitext markup. To add a new image to an existing gallery, type the file name, followed by a bar (<code><nowiki>|</nowiki></code>) and the caption for that image. You must put each image in the gallery on its own line. You can also edit this list to remove or rearrange images or to change captions.

When you click the "Done" button, you will exit the gallery editor. You should then see your changes on the gallery as it will appear to readers.

Remember that exiting the gallery editor does not publish your changes. As with other changes made using the visual editor, you must publish the entire page in order to publish your work.

[[File:VisualEditor - Gallery3.png|frameless|border|center|400px]]

== Templates ==
[[Help:Templates|Templates]] are wiki page in which contents can be displayed in other locations around the wiki. This allow an editor to make a change once and have the changes appear numerous places throughout the wiki.

=== Adding a template ===
To add a new template to a page, place your cursor where you want the template to be inserted, and click on the "Template" link in the "Insert" menu.

[[File:VisualEditor Template Insert Menu-en.png|frameless|border|300px|center]]

Start typing the name of the template you want to insert. When you see it on the list, click on its name. Then click "Add template."

[[File:VisualEditor - Template editing 4.png|frameless|border|500px|center]]

You can also edit a template that is already on the page. When you click on the template to select it, it turns blue, and a box appears with an "Template" link. Then click on the "Edit" link. 

[[File:VisualEditor - Template editing 1.png|frameless|border|300px|center]]

Some templates are not visible to someone reading a page. In VisualEditor, such hidden templates are shown as puzzle icons, such as [[Template:Anchor|Anchor]].

[[File:VisualEditor template not visible.png|frameless|border|center|70px]]

When you select the icon, the context menu is displayed, and you can edit the template.

[[File:VisualEditor template not visible context menu.png|frameless|border|center|300px]]

=== Template parameters ===
When you add a new template or open an existing one, the "[[Transclusion]]" dialog is shown. The contents depends upon whether the template has been documented using the new TemplateData system or not.

The template shown here has no [[TemplateData]] set up for it. The dialog shows a link to documentation for the template. You can read the documentation to figure out if the template has any parameters (fields), and what goes in each field. Use numbers as the name for each nameless parameter. The first un-named parameter is named <code>1</code>, the second is named <code>2</code>, and so forth.

[[File:VisualEditor template with no TemplateData.png|frameless|border|center|400px]]

If a template has been updated to contain {{W|VisualEditor/Portal/TemplateData#What_is_TemplateData.3F|TemplateData}} information, then the dialog will show a list of individual (named) parameters.

[[File:VisualEditor template with TemplateData.png|frameless|border|center|400px]]

For an existing template, you can edit the parameters shown in the dialog, and you can add parameters by clicking "Add more information," at the very bottom of the dialog.

[[File:VisualEditor - Template editing 3.png|frameless|border|center|400x400px]]

When a template embeds other templates, these sub-templates will appear inside the parameters that display them. They can be edited or removed inside the parameter field.

New sub-templates are added by following the steps for adding a parameter. You may need to check the template documentation to make sure that the sub-template is supported. Nested templates can currently be edited as wikitext only, without the facility offered by VisualEditor (see [https://phabricator.wikimedia.org/T52182 phab:T52182]).

[[File:VisualEditor - Template editing 5.png|frameless|border|center|400x400px]]

=== Finishing ===
When finished editing a template, click "Apply changes" to close the dialog and return to editing the main page.

[[File:VisualEditor Apply Changes-en.png|frameless|border|center|150px]]

=== Substituting templates ===
When a template must be [[Help:Substitution|substituted]], type <code><nowiki>subst:</nowiki></code> (colon included) before the template's name.

Autocompletion doesn't work with <code><nowiki>subst:</nowiki></code>. If you want to use autocompletion, first find the template you are looking for, and then add <code><nowiki>subst:</nowiki></code> in front of the template name.

Then, click the green "Add template" button.

Add any parameters as usual and click "Insert".

[[File:VisualEditor - Template editing 7.png|frameless|border|center|400px]]

You will see the template expand on the page after you click "Apply changes."

[[File:VisualEditor - Template editing 8.png|frameless|border|center|400px]]

== Lists ==
[[File:VisualEditor Toolbar Lists and indentation-en.png|frameless|border|250x250px|right]]
You can use VisualEditor to create lists, or to change the format of an existing list. There are two types of lists: unordered (bullet) and ordered (numbered).

To start a new list, just click on one of the two menu items shown here. Or, if you already have typed the list (on separate lines), select (highlight) the list you have typed, then click on one of the menu items. 

{{multiple image
| header    = Two types of bullets
| align     = left
| width     = 150

| image1    = VisualEditor lists 1 unordered bullet.png
| alt1      = Un-ordered bullets
| caption1  = Un-ordered bullets

| image2    = VisualEditor lists 2 ordered numbered.png
| alt2      = Ordered numbered bullets
| caption2  = Ordered numbered bullets
}}
{{Clear}}

Shown here are examples of the two types of lists: unordered (bullet) and ordered (numbered). 

[[File:VisualEditor lists 3 select to indent.png |frameless|border|center|150x150px]]

If you want to change the indentation level of part of an existing list, select the part of the list that you want to change.

[[File:VisualEditor lists 4 indentation menu.png|frameless|border|center|400px]]

Then use the menu, or press the Tab key. (The Tab key increases indentation;  use the shift key plus the Tab key to decrease indentation)

[[File:VisualEditor lists after indenting.png |frameless|border|center|400px]]

Here is the result of increased indentation. 

[[File:VisualEditor lists mixed.png|frameless|border|center|300px]]

You can even mix ordered (numbered) and unordered (bullet) lists, if the list items have different indentations.

== Tables ==
{{Main|Help:Tables}}
[[File:VisualEditor insert table-en.png|frameless|border|right|180x180px]]
[[File:Editing a table using VisualEditor.gif|400px|thumbnail|right|Using VisualEditor to edit a table on the English Wikipedia article {{W|List of Nobel Memorial Prize laureates in Economics}}]]

A '''table''' is an arrangement of columns and rows that organizes and positions data.   You can use VisualEditor to insert and change tables. Please note, you can even import a table by dragging a comma-separated value (.csv) file from your computer into the main editing window.

=== Inserting a table ===
When you click on "Table", in the "Insert" menu, the visual editor inserts a blank four-by-four table.

Now the "Table" menu is available. From that menu, you can add a caption to the top of the table.

[[File:VisualEditor empty table.png|frameless|border|center|164x164px]]

To select a cell, click it once.

[[File:VisualEditor tables select one cell.png|frameless|border|center|400px]]

=== Edit contents ===
To edit the contents of the cell (for example, to add content or to correct a spelling error), double click in the cell. Or you can select the cell and then press Return.

To end your editing of a cell, just click elsewhere.

[[File:VisualEditor tables type inside a cell.png|frameless|border|center|473x473px]]

=== Add or delete a column or a row ===
You can add or delete a column or a row by clicking on a column or a row. 

For rows, you are given the options to:
* Insert above
* Insert below

For columns, you are given the options to:
* Insert before
* Insert after

{{multiple image
| header    = 
| align     = left
| width     = 300

| image1    = VisualEditor_table_editing_add_and_remove_columns.png
| alt1      = Add or remove columns
| caption1  = Add or remove columns

| image2    = VisualEditor - Insert table row.png
| alt2      = Add or remove rows
| caption2  = Add or remove rows
}}
{{Clear}}

=== Merge cells ===
You can merge cells: Select them and then click on "Merge cells" on the popup.

[[File:VisualEditor tables merge cells.png|frameless|border|center|400px]]

If you merge cells, only the text in one cell is kept; any text in the other cells is deleted when you merge the cells. If you decide that you wanted some or all of the text that was deleted, use the Undo button, move or copy the text you want, then merge the cells again.

[[File:VisualEditor tables post-merge cell.png|frameless|border|center|400px]]

=== Un-merge cells ===
You can also split cells that were previously merged.  All the content that was in the merged cell will remain in the first cell when you do the split. You can then cut and paste text to other cells, if you want.

[[File:VisualEditor tables split cells.png|frameless|border|center|400px]]

== Options ==
[[File:VisualEditor More Settings-en.png|327x327px|thumbnail|right|Page options menu]]

The page option menu has the following options:
* [[#Categories|Categories]]
* Page settings 
* Advanced settings
* Languages
* Templates used
* View as right-to-left ({{Keypress|Ctrl}} + {{Keypress|Shift}} + {{Keypress|x}})
* Find and replace ({{Keypress|Ctrl}} + {{Keypress|F}})

When going back into the options, the setting will be show the default option even if another option is currently applied. 

=== Categories ===
To edit categories, on the "Page options" menu, click the "Categories" item.  Clicking on "Categories" opens a dialog that lists existing categories and allows you to add new ones, and to delete existing categories.

You also have the option of setting or changing the general (default) [[#Sorting key|sorting key]], which determines where the page appears when listed with other pages in the same category.

[[File:VisualEditor category editing-en.png|frameless|border|center|500px|Dialog box]]

To add a category for a page, type the name of the category into the field "Add a category". As you type, the visual editor will search for possible matching, existing categories. You can either select an existing category, or you can add a category that doesn't yet have its own category page. (Until that category page is created, your new category will show as a red link after you publish all your editing changes.)

[[File:VisualEditor - Category editing 3.png|frameless|border|center|500px|Adding a category]]

To remove an existing category, click on it and click on the "Remove" icon (trash can) in the dialog that opens.

[[File:VisualEditor - Category editing 2.png|frameless|border|center|400px]]

Click "Apply changes" when you're done editing categories to return to the page editor.

[[File:VisualEditor Apply Changes-en.png|frameless|border|center|150px]]

==== Sorting key ====
You have the option of setting or changing the general (default) sorting key, which determines where the page appears when listed with other pages in the same category.   Clicking on a category also allows you to specify a sorting key for that specific category. Such a sorting key overrides the default sorting key.

You can override how this page is sorted when displayed within a category by setting a different index to sort with instead. This is often used to make pages about people show by last name, but be named with their first name shown first.

For example, the default sorting key for the article "George Washington" is "Washington, George". In the category "Presidents of the United States", the article is listed under the letter "W", not the letter "G".

=== Page settings ===
[[File:VisualEditor page settings item-en.png|frameless|border|346x346px|right]]
To edit a page's settings, click to open the "Page options" menu, in the toolbar, and select the "Page settings" button.  The "Page settings" button opens a dialog that shows several options.

[[File:VisualEditor Page Settings-en.png|frameless|border|center|480x480px]]

Click "Apply changes" when you're done editing the Page options to return to the page editor.

[[File:VisualEditor Apply Changes-en.png|frameless|border|center|300px]]

==== Redirect ====
You can make this page into a redirect, a page which will automatically take readers to another page on this wiki. This is useful for mis-spellings and alternative names or concepts. If you do so, readers will not see the contents of this page.

You can make a page a redirect to another page by checking the "Redirect this page to" checkbox, and then typing the name of the page to which you want to send the reader who tries to go to the page that you're editing.

[[File:VisualEditor Page Settings Redirects-en.png|frameless|border|center|500px]]

At the bottom is the option to prevent page renames from updating this redirect. This is very rarely used. You can prevent this redirect from being updated automatically when the page to which it redirects is moved, in the very rare case that this is needed.

==== Table of contents ====
[[File:VisualEditor Page Settings TOC-en.png|frameless|border|right|500px|TOC options]]
You can change whether the page shows a [[Help:Table of contents|Table of Contents]] by selecting one of these three buttons. There are three options:
# Always - show a Table of Contents regardless the number of headings, if any
# If needed (default) - shows a Table of Contents if there are three or more [[headings]]
# Never - this is the [[Help:Magic words|magic word]] <code><nowiki>__NOTOC__</nowiki></code> (with two underscores on either side of the word)

==== Hiding section edit links ====
You can stop the edit links from appearing next to each section in the unusual case where that is appropriate. You can make a page not show edit links next to each section header by checking this checkbox.

[[File:VisualEditor Page Settings Edit Links-en.png|frameless|border|center|400px]]

==== Advanced settings ====
[[File:FE Advanced settings.png|400px|thumbnail|right|Advanced settings options]]

There are three things that can be changed on Advanced settings:
# Let this page be indexed by search engines
#* You can force search engines to list this page in their relevant results, or force them to not do so. This option does not affect in-site search.
#* Options
#*# Yes
#*# Default
#*# No
# Show a tab on this page to add a new section
#* You can force the display of an extra tab besides the "Edit source" tab on this page which will make it easy to add a new section, or force it to not appear if it otherwise would.
#* Options
#*# Yes
#*# Default
#*# No
#* Please note that [[Enhanced editor]] will be used to add content with the "Add topic" tab
# Display title - You can override how this page's title is displayed by setting a different label to show instead. - {{Color|Red|May not be working}}

==== Languages ====
{{Notice|This is not relevant in Saintapedia at this time.  It is used extensively on [[Wikipedia]].}}
Languages is a list of pages in other languages that are linked to this one. For now, it can only be edited in source mode or on Wikidata.

==== Templates used ====
Templates used is a list [[Templates]] used on the page.  Each template is linked and an "edit" link is listed to the right of it.

[[File:FE Templates used.png|frameless|border|600px|center]]

=== Find and replace ===
[[File:Visual editor - Find and replace.png|600px|thumbnail|left|Find and replace]]

{{Clear}}
==Moving pages==
Moving a page with VisualEditor is functionally the same as moving it using [[Help:Moving a page]].  [[Help:Renaming#How to rename an article]] is shown below for easy reference.

{{#lsth:Help:Renaming|How to rename an article}}

== Keyboard shortcuts ==
{{Main|Help:Keyboard shortcuts (Visual editor)}}

Many editors are used to entering wikitext directly, especially bold, italics and wikilinks. [[Keyboard shortcuts]] allow to quickly insert similar formatting without using toolbar items. Here are the common general shortcuts in VisualEditor:

{| class="wikitable" style="text-align:center; margin:auto;" cellpadding="15"
|-
! PC shortcut
! Action
! Mac shortcut
|-
| {{Key press|Ctrl|B}}
| Bold
| {{Key press|Cmd|B}}
|-
| {{Key press|Ctrl|I}}
| Italics
| {{Key press|Cmd|I}}
|-
| {{Key press|Ctrl|K}}
| Insert link
| {{Key press|Cmd|K}}
|-
| {{Key press|Ctrl|X}}
| Cut
| {{Key press|Cmd|X}}
|-
| {{Key press|Ctrl|C}}
| Copy
| {{Key press|Cmd|C}}
|-
| {{Key press|Ctrl|V}}
| Paste
| {{Key press|Cmd|V}}
|-
| {{Key press|Ctrl|Z}}
| Undo
| {{Key press|Cmd|Z}}
|}

== Session timeouts ==
[[File:Timeout error window.png|thumb|300x300px|Timeout error window]]
If you edit a page for 45 minutes or longer, while not making any others edits on other browser tabs, you will be timed out.  To ensure that your edits are saved, there is simple solution:
# Log in on another tab
# Click try again '''twice'''

== Limits ==
[[File:YouTube video in VisualEditor.png|alt=HTML text of an iframe|thumb|400x400px|Screenshot of a YouTube video in [[VisualEditor]] after it has been selected and the edit button is visible]]
There a few limits when using VisualEditor:
* [[Youtube|YouTube]] videos will show [[HTML]] of the iframe, rather than the video itself
* When [[Help:Formatting#Stacking items|Stacking items]], especially [[templates]], they will be groups together and may not be as easy to edit. In most cases,  {{Tlx|Clear right}}can replace the stack templates and make it easier to edit individual items.
* The alignment of certain items, such as [[images]] and [[infoboxes]], may shift slightly after saving
* The [[Table of contents]] is not shown

== Related ==
* [[Visual editor]]
* [[Help:Keyboard shortcuts (Visual editor)]]
* [[Help:TemplateData]]

== External links ==
* {{W|Wikipedia:VisualEditor}}
* {{W|Wikipedia:VisualEditor/User guide}}
* {{W|Help:Introduction}}

=== Template data ===
* {{Mw|VisualEditor/Portal/TemplateData}}
* {{Mw|Help:TemplateData}}

{{Cats|Help}}
{{Cats|Pages with videos}}