2.2 Visual editing


BlueSpice uses a slightly customized version of the MediaWiki extension VisualEditor as editing tool. This editor supports all common edit tasks that are useful in a wiki environment. You can refer to the official documentation for basic help. Here in the BlueSpice Helpdesk, we only give some hints and tips for using the editor.

What is the visual editor?

VisualEditor
VisualEditor

The visual editor is optimized for editing wiki pages. Important characteristics and functions are:

  1. Page structuring with headings.
  2. Consistent text formatting.
  3. Linking of contents.
  4. Inserting special content (files/media, tables, templates, magic words)
  5. Adjusting page options.

Text editing

Typical text formatting options such as bold, italics, or text color are available as a context menu. When you highlight text, a menu with common formatting elements appears. For example, you can apply a different text color.

Applying text color

Pasting content from your clipboard

Undo

If you paste content from your clipboard (e.g., copied from MS Word or MS Excel), you usually also paste many unnecessary formatting tags from the original application. To avoid, this you should paste the content as plaintext.

If you already pasted text which resulted in undesirable formatting, you can use the undo function in VisualEditor to remove the content again if you have not yet saved the page or switched between visual and source editing mode.

To paste content as plain text instead, use the shortcut Ctrl+Shift+v.

Shortcuts

If you want to apply multiple formatting options at the same time, shortcuts are often the quickest way. For example, to show text in bold and italic, highlight the text and press Ctrl+b (for "bold") and Ctrl+i (for "italics"). Even a link can be quickly inserted by pressing Ctrl+k. Pressing Ctrl+b again will cancel the bold. Multiple formats can be removed after text selection with Ctrl+m.

All available keyboard shortcuts are marked accordingly in VisualEditor next to each menu item.


Menu items with shortcuts
Menu items with shortcuts


Note:For a list of all available shortcuts, click on "Keyboard shortcuts" in the Visual Editor help menu (the question mark menu item).


Inserting other content

Many typical page elements such as images, files and tables can be integrated into your page from the Insert menu.

  • File formats with a preview option: jpg/jpeg, png, gif, pdf
  • File formats without preview option are always inserted as links (e.g., Microsoft Office formats)

If you want to learn more about inserting these elements, go to the following help pages:

Wiki-specific content

Some functions in the Insert menu are little known from traditional word processing, but are quite typical for working with a wiki. Therefore, they are briefly introduced here. Find more information on the help pages here in the helpdesk or at mediawiki.org:

  • Comment: Add comments to the page. These are only visible in the source code.
  • Gallery: A simple picture gallery can support many process flows.
  • Magic word: Wiki features such as signature, word counter, category tree or even process diagrams with draw.io can be integrated as a "magic word".
  • Your signature: Only works on pages that allow signatures. Pages in the Namespace "Pages" are not included.
  • Codeblock: Programming code is displayed here in clean code blocks, optionally with line numbers.
  • References list: Creates footnote references.
  • Chemical formula: The formula rendering uses an external service via Wikimedia's REST API.
  • Math formula: An editor opens for entering a mathematical formula.

Switching between edit modes

When creating or editing a page, the page usually loads in visual editing mode. If you are familiar with the formatting language of MediaWiki ("Wikitext"), you can easily switch to source editing mode using the "Switch editor" menu item and edit your page content there:

edit modes

Hints and tips

VisualEditor is optimized for editing web pages. That's why it has exactly the features that are often needed to create a wiki page. The consistent formatting of content supports the readability of your wiki content.

Text formatting

In the text formatting menu, the following additional options are available when a text passage has been selected:

Text color: different text colors can be selected via an inspector menu.

Center align: Text can be selected and centered paragraph by paragraph.

Indent: Text can be indented once (note: multiple indentation is only possible via the source text).

Text formatting options
Text formatting options
Text formatting
Undo function

Manual:error.png

Left arrow: Undo last action (greyed out: there is no last action yet)

Right arrow: Restore last action (greyed out: there's nothing to restore yet)

Format Paragraph

Manual:paragraph.png

Here text can be defined as heading or specific paragraph type. Note: If you work in a table, the options will change accordingly (content cell and header cell):
alternative-text=VisualEditor-paragraph2

Style text

Manual:VE character formatting.png

If no text has been selected before clicking on the " A" button and on a button, the text will be formatted from the current position of the cursor.

(More Info at mediawiki.org/wiki/Help:VisualEditor/User_guide/en#Getting_Started:_The_VisualEditor-Toolbar])

Insert hyperlink

Manual:VE Insert hyperlink.png

If no text was selected before the hyperlink dialog was opened, the link will be generated with a number:

[1] To subsequently change the hyperlink description, just click on the link to open the edit menu. In a table, you may need to double-click the cell first and then click the hyperlink again.

Cite

Manual:VE cite.png

The citation menu is used to insert footnote references within the text.
Structure

Manual:VE structure new.png

Formats ordered and unordered lists. If paragraph breaks or images need to be inserted within a bullet point, use Shift+Enter to avoid creating a new list item.

If you want to style numbered lists like 1, 1.1, 1.1.1, etc., you need to add some additional CSS instructions to the page MediaWiki:Common.css.


Insert special content

Insert special content
Insert menu

Manual:insert.png

Use the "insert" menu to insert various media (images, videos) and text formats:
Media

Manual:VE media.png

Inserting pictures and videos

(Details on MediaWiki])

Templates

Manual:VE template.png

Include a template in the page.
Tables

Manual:VE table.png

Tables are an important tool for formatting tabular page content.
Comment

Manual:VE comment.png

Comments are not visible to readers, but only in edit mode. A comment can be inserted anywhere on a page. It is text-based and cannot be formatted.
Magic word  -v4.2.x

Manual:VE magic word.png

With a "magic word" you can insert certain wiki tags in your page.

More about Magic words

Gallery

Manual:VE gallery.png

Allows to display a set of images as a gallery. Formatting examples for the different settings can be found at

mediawiki.org/wiki/Help:Images#Gallery_syntax

Your signature

Manual:VE your signature.png

This option allows to add your wiki signature (User name and timestamp) at any location in the page.
Code block

Manual:VE code block.png

With code block various code examples can be entered, like e.g. in HTML syntax. The code is then displayed properly formatted:
<span style="color: red">red text</span>
References list

Manual:VE refernces list.png

This menu item creates a <references /> tag at the location where it is inserted. The footnote references up to this point are then displayed at that location instead of the end of the page. Remaining footnotes in the page are still shown at the end of the page.
Chemical formula

Manual:VE chemical formula.png

The formula rendering uses an external service via Wikimedia's REST API.
Math formula

Manual:VE math formula.png

It opens an editor for entering a mathematical formula.

[[on MediaWiki]]

Special Characters

Manual:VE special characters.png

Opens a panel to select special characters that are not available on your keyboard. To close the panel, click the menu item again.

Page options

Page options
Options menu
alternative text=VisualEditor-options
The options menu allows editing of all page settings. It is not
Options

Manual:VE options.png

This button allows the page settings and page information to be updated simultaneously within a dialog box. To change any page options on the page, you need to be in visual editing mode.
Categories

Manual:VE categories.png

Here, you assign the page to one or more categories while in edit mode.
Page Settings

Manual:VE page settings.png

Page redirection: When the page is redirected, the content of the page is no longer displayed, but the target page is loaded directly.


Show Table of Contents: By default, a table of contents is shown if a page has more than three headings. You can use this setting to always force or suppress the table of contents.

Advanced Settings

Manual:VE advanced settings.png

  • Let this page be indexed by search engines: Only applies to public search engines. The wiki's internal search is not affected.
  • Show a tab on this page to add a new section: Not supported in BlueSpice 4 Discovery skin.
  • Display title: Sets a title that is shown as page heading. It can be found by the search and is used in page lists created by Semantic MediaWiki inline queries.
  • Title visibility: This setting hides the entire title section of a page and is often applied on the main page or other portal pages of the wiki. If the title is not visible, the edit button is also not available. In this case, you can click on all actions... > Edit in the page tools.
    Screenshot of the "all actions" menu
    "all actions" Menu
Languages

Manual:languages.png

Screenshot of the right-hand buttons fot he top menu bar with interlanguage menu item highlighted
Menu item to access interlanguage links
Shows wiki pages on different wikis that are connected via Interlanguage links. Depending on the wiki's skin, the links are shown in a specific location. In the BlueSpice 4 Discovery skin, the interlanguage links are shown in the top menu.


mediawiki.org/wiki/Help:Links#Interwiki_links

Templates used

Manual:VE templates used.png

List the templates that are embedded on the page.
View as right-to-left

Manual:VE view as right-to-left.png

Support for languages that are read from right to left. Clicking this button right-side formats the page text. Click again to set the text flush left.
Find and replace

Manual:VE find and replace.png

Words or characters can be searched and replaced directly on the page. The "Undo" button can be used to cancel the change.

Troubleshooting: Visual editing is disabled

If you only have the source editing option in your editor toolbar, please contact an administrator of your wiki. The following settings must be checked in this case:



To submit feedback about this documentation, visit our community forum.