Visual Editor - Mediawiki
Opening the visual editor
Getting started: the visual editor's toolbar
The visual editor's toolbar appears at the top of the screen when you begin editing. It includes some familiar icons:
- Undo / redo
- Headings pull-down menu
- Formatting: Clicking the "A" opens a menu
- Linking tool: The chain icon is the linking tool. Clicking on it (usually after selecting some text) opens the link dialog.
- Cite menu: The "Cite" menu is used to add inline citations (also called "footnotes" or "references").
- Lists and indentation: 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.
- Insert: The "Insert" menu allows you to add a few different types of objects (including images)
- The Page options menu is to the left of the Save page button. On this menu there are options to adjust page settings. This is also where you can switch to Source editing.
When you're done editing, click the blue Save page button in the toolbar. If you have made no changes, the button will be disabled (grayed out). To cancel all your editing changes, just close your browser window, or click use the "esc" button on your keyboard to cancel.
Pressing the blue "Save page" button opens a dialog. You can then enter a brief summary of your actions, mark your edit as minor, and add the page to your Watchlist.
Links can be added through the "Link" icon (links in a chain) in the toolbar, or by using the shortcut Ctrl+K (or ⌘ Command+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 on that word.
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.
Once you have entered or selected the link, you complete the linking process by pressing ↵ Enter or by pressing the "Done" button. Your link will immediately appear on the page, but as with other changes to the page, it will not be saved until you save the entire page.
Editing images and other media files
Important: Adding images to a page happens AFTER the image has been uploaded to the wiki.
To add a new image (or another type of media file) to the page
- Click the "Media" icon (a picture of mountains) in the "Insert" menu. The image will be added wherever your cursor is.
- Clicking the "Media" icon opens a dialog that automatically searches the local wiki for media files related to the title of the page you're editing.
- You can change the search by changing the text in the dialog's search box to locate previously uploaded media
- To choose a file, click on its thumbnail image.
- This places the image onto the page you are editing.
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.
- 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 also set various parameters for the image in the "Advanced settings" window. These include the alignment, the type, and size of the image.
- When you're done, click "Apply changes" to close the dialog and return to editing the page.
Editing existing images
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. 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.
Uploading images is currently still handled via the legacy File upload tool and not via the Visual Editor (look for this to change in later versions).
You can use the visual editor 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.
You can use the visual editor to insert and change tables. You can even import a table by dragging a comma-separated value (.csv) file from your computer into the main editing window.
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.
- To select a cell, click it once.
- 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.
- 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".
Making Tables Accessible
Please see Accessibility of table header cells for instructions on making tables more accessible when rendered on non-visual media.
Editing page settings
Switching between the visual and wikitext editors
To switch from the visual editor to the wikitext editor, click the [ ] button Switch to Source Editor option in the Page Settings menu
This article was developed using materials from mediawiki.org Visual Editor User Guide.