Help:VisualEditor/User guide: Difference between revisions

no edit summary
(Send 'em over to MW.org)
No edit summary
Line 131:
| The '''switch to source editing''' button is next to the '''{{int|publishchanges}}''' button. It allows you to switch to the wikitext editor.
|}
 
== Publishing changes ==
 
{| cellpadding="20"
|-
| When you are finished editing, press the blue "{{int|publishchanges}}" button in the toolbar. If you have made no changes, the button will be disabled (grayed out). To cancel all your editing changes, close your browser window, or press the "{{int|vector-view-view}}" tab above the edit toolbar.
| [[File:VisualEditor toolbar actions-en.png|frameless|border|300px|center]]
|-
| colspan=2 | <hr />
|-
| Pressing the blue "{{int|publishchanges}}" button opens a dialog. You can then enter a brief summary of your actions, mark your edit as minor, and/or add the page to your {{int|mywatchlist}}. The box for the summary is the equivalent of the {{int|summary}} field in the wikitext editor.
 
You can also review your changes using the "{{int|visualeditor-savedialog-label-review}}" button to confirm that they will function as intended before saving your changes. This is similar to the "{{int|showdiff}}" button in the wikitext editor.
 
The "{{int|Visualeditor-savedialog-label-resume-editing}}" button returns you to the page you were editing. You can publish all of your changes later.
| [[File:VisualEditor save dialog-en.png|frameless|border|center|500px]]
|}
{{anchor|Editing links}}
== Editing links ==
 
{| cellpadding="20"
|-
| [[File:VisualEditor - Toolbar - Linking.png|frameless|border|300px|center]]
| 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}} (or {{Key press|Command|K}} on a Mac).
 
If you select (highlight) text and then press the "{{int|visualeditor-annotationbutton-link-tooltip}}" button, that text will be used in creating the link. For a link that involves only one word, you can either select that word or just put the cursor within that word.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor-link tool-search results-en.png|frameless|border|center|400px]]
| When you use either the button or the shortcut, a dialog will open in which you may type the link.
The link tool will try to help with '''internal''' links by searching for likely matches.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor link tool 2015.png|frameless|border|center|400px]]
| 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 page, but as with other changes to the page, it will not be published until you publish the ''entire'' page.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor-link tool-external link.png|frameless|border|400px|center]]
| To link to a web page on another website, the process is similar: Choose the "{{int|visualeditor-linkinspector-button-link-external}}" tab, and enter a URL in the box.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor link tool simple link.png|frameless|border|400px|center]]
| 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 pressing on the button or pressing the shortcut keys. Type the URL in the box, and press the "{{int|visualeditor-dialog-action-done}}" button to insert the link.
|-
| colspan=2 | <hr />
|-
| [[File:VisualEditor-context menu-link tool.png|frameless|border|400px|center]]
| To change or remove an existing link, press 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. When a link is selected, it appears as blue framed.
 
In the link editing dialog, you can then change where the link goes. You can also remove the link entirely by pressing the "{{int|visualeditor-inspector-remove-tooltip}}" button in the upper right corner of the dialog. You can also open the link's target in another window by pressing on the copy of the link in the dialog box. (You might want do this to check if an external link is valid.)
 
If you want to exit the link label (the text displayed as a link) or continue to write after this link, you can press {{Key press|→}}:
 
*Pressing it once will escape the link editing dialog and put your cursor at the end of the element linked (blue framed, to edit this element)
*Pressing it twice will put the cursor after the element linked, ready to type the rest of your text.
To edit the link label of an existing link, press within the link label and type the new one. But if you want to replace the entire label, please note:
* If you have selected (highlighted) the entire link label, the link will be deleted by typing any key. You may link it from start.
* To keep the link directly, you may press within that link label, use backspace and delete key without pressing it once more than necessary, and a narrow blue link area will remain there. Now you may type in the new label for the kept link.
* You can also [[mw:Help:VisualEditor/User guide/Links|link to categories, files and more]].
|}
{{anchor|EditingReferences}}