Help:VisualEditor/User guide: Difference between revisions

no edit summary
No edit summary
No edit summary
Line 607:
| Pressing on "{{int|visualeditor-categories-tool}}" 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) [[Specialmw:MyLanguage/Help:Sorting#Sort order|sorting key]], which determines where the page appears when listed with other pages in the same category.
 
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".
Line 630:
 
{{anchor|Editing page settings}}
== Editing page settings ==
 
{| cellpadding="15"
|-
| [[File:VisualEditor page settings item-en.png|frameless|border|500px|center]]
| To edit a page's settings, press to open the "{{int|visualeditor-pagemenu-tooltip}}" menu, in the toolbar, and select the "{{int|visualeditor-dialog-meta-settings-label}}" button.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor Page Settings-en.png|frameless|border|center|500px]]
| The "{{int|visualeditor-dialog-meta-settings-label}}" button opens a dialog that shows several options.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor Page Settings Redirects-en.png|frameless|border|center|500px]]
| 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 are editing.
 
At the bottom is the option to prevent page renames from updating this redirect. This is very rarely used.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor Page Settings TOC-en.png|frameless|border|center|500px]]
| 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 />
|-
| [[File:VisualEditor Page Settings Edit Links-en.png|frameless|border|center|400px]]
| You can make a page not show edit links next to each section header by checking this checkbox.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor Apply Changes-en.png|frameless|border|center|300px]]
| Press "{{int|visualeditor-dialog-action-apply}}" when you are done editing the {{int|visualeditor-pagemenu-tooltip}} to return to the page editor.
|}
 
== Editing maps ==
{| cellpadding="15"
| [[File:Visual editor showing editing an existing map.jpg|frameless|border|400px|center]]
| You can add and change maps. See [[mw:Help:VisualEditor/Maps]].
|}
 
{{anchor|Editing mathematical formulae}}
== Editing mathematical formulae ==
 
{| cellpadding="15"
| To add a new mathematical formula to the page, place your cursor where you want it to be inserted, and press on the "{{int|math-visualeditor-mwmathdialog-title}}" icon ("Σ") in the "{{int|visualeditor-toolbar-insert}}" menu on the toolbar.
| [[File:VisualEditor Formula Insert Menu-en.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| A window will open in which you can type the formula, using LaTeX syntax. the visual editor 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, press the "{{int|visualeditor-dialog-action-insert}}" button.
| [[File:VisualEditor formula-en.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| To edit an existing mathematical formula on the page, press on it and then press on the "Σ" icon that appears. This will open up the formula window, where you make changes.
| [[File:VisualEditor - editing existing mathematical formula.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| Mathematical formulae can be placed inline or centered as a block.
|[[File:VisualEditor mathematic formula inline.png|frameless|border|400px|center]]
|}
 
== Editing musical scores ==
{| cellpadding="15"
| To add a new musical notation to a page, place your cursor where you want the musical notation to be inserted. Then, from the "Insert" menu on the toolbar, press the "Musical notation" option.
 
To edit an existing musical notation on the page, double press on it.
| [[File:VisualEditor-Insert-Musical-Notation.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| This will open the "Musical notation" dialog. Here the notation can be edited by scale, either in ABC or in Lilypond format. You can also link the notation to an audio or MIDI file. Once you are finished, press the "Done" button to close the dialog and publish your changes.
| [[File:Musical.png|frameless|border|400px|center]]
|}
 
== Editing poems and other special items ==
 
{| cellpadding="15"
| Some items, such as association lists and poems, are not yet fully supported by the visual editor.
| [[File:VisualEditor editing poem 1.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| In most cases, the existing items can be edited, but new ones cannot be inserted in the visual editor.
 
Until they are fully supported, you can copy an existing one from another page, or edit the source wikitext directly.
 
| [[File:VisualEditor editing poem 2.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|}
 
== Switching between the visual and wikitext editors ==
 
{| cellpadding="15"
|
To switch from the visual editor to the wikitext editor, press the <code>[[ ]]</code> button on the far right of the toolbar.
| [[File:VisualEditor toolbar Page options - Switch to wikitext - Save.png |frameless|border|200px|center]]
|-
| colspan=2 | <hr />
|-
|
If you've done any editing, you'll be asked whether you want to keep your changes. Normally you'll press on "Keep changes".
| [[File:VisualEditor bi-directional switching to wikitext.png |frameless|border|300px|center]]
|-
| colspan=2 | <hr />
|-
|
You'll see a diff. (If you pressed on "Discard changes", you'll just see wikitext, ready to edit with the wikitext editor.)
 
Scroll down, and you'll see the wikitext editing area.
| [[File:VisualEditor bi-directional switching diff before wikitext.png |frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
|
You can also switch from the wikitext editor to the visual editor. To do that, press the pencil icon on the far right of the toolbar.
| [[File:VisualEditor bi-directional switching pencil icon in wikitext.png |frameless|border|150px|center]]
|-
| colspan=2 | <hr />
|-
|
After you press the pencil icon, if you've done any editing you'll be asked whether you want to keep your changes. If you press "Keep changes", you'll go to the visual editor. If you press "Discard changes", you'll be asked to confirm that is what you want to do (press on "Leave Page" to confirm) before the visual editor will start.
| [[File:VisualEditor bi-directional switching to visual editing.png|frameless|border|300px|center]]
|}
 
== Keyboard shortcuts ==
 
Many editors are used to entering wikitext directly, especially bold, italics and wikilinks. [[mw:VisualEditor/Portal/Keyboard shortcuts|Keyboard shortcuts]] allow to quickly insert similar formatting without having to use toolbar items. Here are the common general shortcuts in the visual editor:
 
{| style="text-align:center; margin:auto;" cellpadding="15"
|-
! PC shortcut
! Action
! Mac shortcut
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|B}}
| Bold
| {{Key press|Cmd|B}}
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|I}}
| Italics
| {{Key press|Cmd|I}}
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|K}}
| Insert link
| {{Key press|Cmd|K}}
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|X}}
| Cut
| {{Key press|Cmd|X}}
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|C}}
| Copy
| {{Key press|Cmd|C}}
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|V}}
| Paste
| {{Key press|Cmd|V}}
|-
| colspan=3 | <hr />
|-
| {{Key press|Ctrl|Z}}
| Undo
| {{Key press|Cmd|Z}}
|}
<!-- Close **both** <div>s here -->
</div>