Changes

<div class="overflowbugx" style="overflow:auto; width: 100%;">

{| cellpadding="20"

| colspan=2 | <hr />

|-

| '''{{int:visualeditor-historybutton-undo-tooltip}}''' and '''{{int:visualeditor-historybutton-redo-tooltip}}''' the changes you have made.

|-

| colspan=2 | <hr />

|-

| '''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 "{{int:visualeditor-formatdropdown-format-mw-heading2}}", and subsections are "{{int:visualeditor-formatdropdown-format-heading2}}", "{{int:visualeditor-formatdropdown-format-heading3}}", and so on. The normal format for text is "{{int:visualeditor-formatdropdown-format-paragraph}}".

|-

| colspan=2 | <hr />

|-

|

'''Formatting:''' Clicking the "<u>'''''A'''''</u>" opens a menu.

| colspan=2 | <hr />

|-

| '''Linking tool:''' The chain icon is the [[#Editing links|linking tool]]. Clicking on it (usually after selecting some text) opens the [[#Editing links|link dialog]].

|-

| colspan=2 | <hr />

|-

| '''{{int:Cite-ve-toolbar-group-label}} menu:''' The "{{int:Cite-ve-toolbar-group-label}}" menu is used to add inline citations (also called "footnotes" or "references"). All projects have access to "{{int:Cite-ve-dialogbutton-reference-tooltip}}" reference formatting and the ability to "{{int:Cite-ve-dialog-reference-useexisting-tool}}" citations, using this menu. This menu also gives you quick access to local citation templates, if these are enabled on your wiki.

| colspan=2 | <hr />

|-

| '''{{int:Cite-ve-toolbar-group-label}} button:''' If the citoid service is enabled on your wiki, then you will see a "{{int:Cite-ve-toolbar-group-label}}" button instead of a {{int:Cite-ve-toolbar-group-label}} menu.

| colspan=2 | <hr />

|-

| '''Lists and indentation:''' The first two items allow you to format text as either a "{{int:visualeditor-listbutton-bullet-tooltip}}" or a "{{int:visualeditor-listbutton-number-tooltip}}". The last two items allow you to decrease or increase the indentation level of list items.

|-

| colspan=2 | <hr />

|-

| '''{{int:visualeditor-toolbar-insert}}:''' The "{{int:visualeditor-toolbar-insert}}" menu may be different on some projects. Below is a list of '''all''' options that may appear.

* The "{{int:visualeditor-dialogbutton-media-tooltip}}" icon (a picture of mountains) opens the [[#Editing images and other media files|media dialog]].

|}

<div class="overflowbugx" style="overflow:auto; ">

{| cellpadding="20"

|-

| colspan=2 | <hr />

|-

| The '''{{int:visualeditor-pagemenu-tooltip}}''' 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 [[#Editing categories|add, edit, or delete categories]]; and to see, using the "{{int:visualeditor-annotationbutton-language-tooltip}}" item, the list of articles on the same subject that are in other languages. You can also switch (one-way only) from VisualEditor to the classic wikitext source editor without losing the editing work you've done.

|}

|-

| 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.

|-

| colspan=2 | <hr />

The "{{int:Visualeditor-savedialog-label-resume-editing}}" button returns you to the page you were editing. You can save and publish all of your changes later.

|}

{| cellpadding="20"

|-

| Links can be added through the "{{int:visualeditor-annotationbutton-link-tooltip}}" icon (links in a chain) in the toolbar, or by using the shortcut {{key press|Ctrl|K}} on PC (or {{Key press|Command|K}} on a [[Mac]]).

| colspan=2 | <hr />

|-

| When you use either the button or the shortcut, a dialog will open in which you may type the link.

| colspan=2 | <hr />

|-

| Once you have entered or selected the link, you complete the linking process by pressing {{key press|Enter}} or by pressing the "{{int:visualeditor-dialog-action-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.

|-

| colspan=2 | <hr />

|-

| To link to a web page on another website, the process is the similar: Choose the "{{int:visualeditor-linkinspector-button-link-external}}" tab, and enter a URL in the box.

|-

| colspan=2 | <hr />

|-

| External links without labels look like this: [http://example.com]. You can 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 the URL in the box, and click the "{{int:visualeditor-dialog-action-done}}" button to insert the link.

|-

| colspan=2 | <hr />

|-

| To change or remove an existing link, click within the text for that link, then press the "{{int:visualeditor-annotationbutton-link-tooltip}}" icon that appears near it. The dialog will appear, for editing. (You can also get to the dialog with the {{key press|Ctrl|K}} keyboard shortcut.)

| colspan=2 | <hr />

|-

| To edit an existing reference, click on it where it appears in the text (usually as a bracketed number). You will see either a "{{int:visualeditor-dialogbutton-reference-tooltip}}" icon (bookmark) or an icon (and name) for the template that was used to create this reference. Clicking on this icon will open a dialog where you can edit the reference.

|-

| colspan=2 | <hr />

|-

| If what appears is the "{{int:visualeditor-dialogbutton-reference-tooltip}}" icon, clicking on it opens the Reference dialog, where you can edit the reference's contents.

| colspan=2 | <hr />

|-

| If, instead of the "{{int:visualeditor-dialogbutton-reference-tooltip}}" icon (bookmark), what appears when you click on a reference is an icon for a standard template for citations, clicking on that icon will take you directly to the template mini-editor dialog.

|-

| colspan=2 | <hr />

|-

| Inside the template mini-editor, you can add or remove types of information or change current content. Only fields (template parameters) that are used (have content) should be shown, initially. To add fields, click on "{{int:visualeditor-dialog-transclusion-add-param}}", which is at the very bottom of the mini-editor.

|-

| colspan=2 | <hr />

|-

| Click on "{{int:visualeditor-dialog-action-apply}}" when you're done.

|-

| colspan=2 | <hr />

|-

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

| colspan=2 | <hr />

|-

| In the {{int:visualeditor-dialog-reference-title}} 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 "{{int:visualeditor-reference-input-placeholder}}") to list only those references that include certain text.

|-

| colspan=2 | <hr />

|-

| To add a citation using the "{{int:visualeditor-toolbar-cite-label}}" menu, place your cursor where you want to add it in the text. Then on the "{{int:visualeditor-toolbar-cite-label}}" menu, select the appropriate item.

|-

| colspan=2 | <hr />

|-

| Shown here is what you will see if you select the "{{int:visualeditor-dialogbutton-reference-tooltip}}" item. In the Reference editor, you can add your citation, including formatting.

| colspan=2 | <hr />

|-

| In the Reference dialog, if you want to include a template in your new reference, click the {{int:visualeditor-dialogbutton-template-tooltip}} icon (puzzle piece) in the "{{int:visualeditor-toolbar-insert}}" toolbar menu within the Reference editor.

|-

| colspan=2 | <hr />

|-

| Then, look for the template you want to use, add it and edit it as you would any other template. (See the [[#Editing templates|Editing templates]] section, below, if you need more information about templates.)

| colspan=2 | <hr />

|-

| If there isn't already a list of references 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.

| colspan=2 | <hr />

|-

| If you are using different groups of references (which is unusual), you can specify a group in this dialog, to display only those references that belong to that group.

| colspan=2 | <hr />

|-

| Your local wiki may have added extra citation templates to this menu. This offers quick access to the most-used citation templates. (Instructions for adding extra citation templates to your local wiki are available at [[VisualEditor/Citation tool]].)

| colspan=2 | <hr />

|-

| Clicking on a template icon such as "Cite book" will take you into the template mini-editor for that template. Important information fields may be marked with an asterisk. While the most common fields will be shown, not all of them are required.

|-

| colspan=2 | <hr />

|-

| To add additional parameters, scroll down in the template mini-editor and click on the "{{int:visualeditor-dialog-transclusion-add-param}}" option.

| colspan=2 |The '''[[:mw:Citoid|Citoid service]]'''&nbsp;takes a&nbsp;[[:en:URL|URL]]&nbsp;or&nbsp;[[:en:Digital object identifier|DOI]]&nbsp;for a reliable source, and returns a pre-filled, pre-formatted bibliographic citation. After creating it, you will be able to change or add information to the citation, in the same way that you edit any other pre-existing citation in VisualEditor. Support for ISBNs, PMIDs, and other identifiers is planned. Later, editors will be able to improve precision and reduce the need for manual corrections by contributing to the Citoid service's definitions for each website.

|-

| With [[:mw:Citoid|Citoid]] in VisualEditor, you click the 'book with bookmark' icon (next to the 'Links' icon) in the main toolbar, paste in the URL or DOI of a reliable source, and click 'Lookup'.

|-

| colspan=2 | <hr />

|-

| Citoid looks up the source and returns available citation details as result. Click the green "Insert" button to accept its results and add them to the article.

|-

| To add a new image (or another type of media file) to the page, click the "{{int:visualeditor-dialogbutton-media-tooltip}}" icon (a picture of mountains) in the "{{int:visualeditor-toolbar-insert}}" menu. The image will be added wherever your cursor is.

|-

| colspan=2 | <hr />

This places the image onto the page you are editing.

|-

| colspan=2 | <hr />

|-

| 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.

|-

| colspan=2 | <hr />

|-

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

|-

| colspan=2 | <hr />

|-

| You can also set various parameters for the image in the "{{int:visualeditor-advancedsettings-tool}}" window. These include the alignment, the type, and size of the image.

|-

| colspan=2 | <hr />

|-

| When you're done, click "{{int:visualeditor-dialog-action-apply}}" to close the dialog and return to editing the page.

|-

| colspan=2 | <hr />

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

|}

|-

| To add a new gallery, click the "{{int:visualeditor-mwgalleryinspector-title}}" icon (a set of photos) on the "{{int:visualeditor-toolbar-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.)

|-

| colspan=2 | <hr /> -->

|-

| 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.

|-

| The gallery editor has two tabs, one to add images and their captions, the other controls display options.

Remember that exiting the gallery editor does not save your changes. As with other changes made using VisualEditor, you must 'Publish' the entire page in order to save your work and make it viewable online.

|}

|-

| To add a new template to a page, place your cursor where you want the template to be inserted, and click on the "{{int:visualeditor-dialogbutton-template-tooltip}}" icon (a puzzle piece) in the "{{int:visualeditor-toolbar-insert}}" menu.

|-

| colspan=2 | <hr />

|-

| Start typing the name of the template you want to insert. When you see it on the list, click on its name. Then click "{{int:visualeditor-dialog-transclusion-add-template}}".

|-

| colspan=2 | <hr />

|-

| 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 "{{int:visualeditor-dialogbutton-template-tooltip}}" icon (a puzzle piece). Then click on the "{{int:vector-view-edit}}" link.

|-

| colspan=2 | <hr />

|-

|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]].

|-

| colspan=2 | <hr />

|-

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

|-

| colspan=2 | <hr />

|-

| 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.

|-

| colspan=2 | <hr />

|-

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

|-

| colspan=2 | <hr />

|-

| For an existing template, you can edit the parameters shown in the dialog, and you can add parameters by clicking "{{int:visualeditor-dialog-transclusion-add-param}}", at the very bottom of the dialog.

|-

| colspan=2 | <hr />

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 [[phab:T52182]]).

|-

| colspan=2 | <hr />

|-

| When you have finished editing a template, click "{{int:visualeditor-dialog-action-apply}}" to close the dialog and return to editing the main page.

|-

| colspan=2 | <hr />

Add any parameters as usual and click "{{int:visualeditor-dialog-action-insert}}".

|-

| colspan=2 | <hr />

|-

| You will see the template expand on the page after you click "{{int:visualeditor-dialog-action-apply}}".

|}

{| cellpadding="15"

|-

| 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).

| colspan=2 | <hr />

|-

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

|-

| colspan=2 | <hr />

|-

| 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.

|-

| colspan=2 | <hr />

|-

| 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)

|-

| colspan=2 | <hr />

|-

| Here is the result of increased indentation.

|-

| colspan=2 | <hr />

|-

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

|}

{| cellpadding="15"

|-

| You can use VisualEditor to insert and change tables.

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

|-

| colspan=2 | <hr />

|-

|To select a cell, click it once.

|-

| colspan=2 | <hr />

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

| colspan=2 | <hr />

|-

| You can add or delete a column or a row.

|-

|-

| You can merge cells: Select them, then from the Table menu, click on "Merge cells".

|-

| colspan=2 | <hr />

|-

|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.

|-

| colspan=2 | <hr />

|-

|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.

|}

{| cellpadding="15"

|-

| To edit categories, on the "{{int:visualeditor-pagemenu-tooltip}}" menu, click the "{{int:visualeditor-categories-tool}}" item. If the tool is not visible, first search for three horizontal lines. That's where it is.

|-

| colspan=2 | <hr />

|-

| Clicking on "{{int:visualeditor-categories-tool}}" opens a dialog that lists existing categories and allows you to add new ones, and to delete existing categories.

| colspan=2 | <hr />

|-

| To add a category for a page, type the name of the category into the field "{{int:visualeditor-dialog-meta-categories-input-placeholder}}". As you type, VisualEditor 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.)

|-

| colspan=2 | <hr />

|-

| To remove an existing category, click on it and click on the "{{int:visualeditor-inspector-remove-tooltip}}" icon (trash can) in the dialog that opens.

| colspan=2 | <hr />

|-

| Click "{{int:visualeditor-dialog-action-apply}}" when you're done editing categories to return to the page editor.

|}

{| cellpadding="15"

|-

| To edit a page's settings, click to open the "{{int:visualeditor-pagemenu-tooltip}}" menu, in the toolbar, and select the "{{int:visualeditor-dialog-meta-settings-label}}" button.

|-

| colspan=2 | <hr />

|-

| The "{{int:visualeditor-dialog-meta-settings-label}}" button opens a dialog that shows several options.

|-

| colspan=2 | <hr />

|-

| You can make a page a redirect to another page by checking the "{{int:visualeditor-dialog-meta-settings-redirect-label}}" 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.

| colspan=2 | <hr />

|-

| You can change whether the page shows a Table of Contents by selecting one of these three buttons. The default option is "{{int:visualeditor-dialog-meta-settings-toc-default}}", which shows a Table of Contents if there are three or more headings.

|-

| colspan=2 | <hr />

|-

| You can make a page not show edit links next to each section header by checking this checkbox.

|-

| colspan=2 | <hr />

|-

| Click "{{int:visualeditor-dialog-action-apply}}" when you're done editing the {{int:visualeditor-pagemenu-tooltip}} to return to the page editor.

|}

{| cellpadding="15"

| To add a new mathematical formula to the page, place your cursor where you want it to be inserted, and click on the "{{int:math-visualeditor-mwmathinspector-title}}" icon ("Σ") in the "{{int:visualeditor-toolbar-insert}}" menu on the toolbar.

|-

| colspan=2 | <hr />

|-

| A window will open in which you can type the formula, using LaTeX syntax. VisualEditor will update the formula as you type it, so you can see how it will look as you make changes. Once you are happy with the formula, click the "{{int:visualeditor-dialog-action-done}}" button.

|-

| colspan=2 | <hr />

|-

| To edit an existing mathematical formula on the page, click on it and then click on the "Σ" icon that appears. This will open up the formula window, where you make changes.

|-

| colspan=2 | <hr />

|-

| Mathematical formulae can be placed inline or centered as a block.

|}

{| cellpadding="15"

| Some items, such as association lists, poems, and musical scores, are not yet fully supported by VisualEditor.

|-

| colspan=2 | <hr />

|-

| In most cases, the existing items can be edited, but new ones cannot be inserted in VisualEditor.

|-

| colspan=2 | <hr />