Visual Editor is similar to the one used by your favorite word processor. It is a What You See Is What You Get (WYSIWYG) editor which is suitable for first time users or the users who are not comfortable with wiki syntax.

In WikiNote, to edit a page, just click the "Edit" button displayed above the page.

Overview

Toolbar.png
Toolbar of Visual Editor

Toolbar Item / MenuFunction
Bold.png Italic.png Underline.png Strikethrough.pngApplies bold, italic, underline or strikethrough formatting to the selected text. See Text Styles.
Subscript.png Superscript.pngSubscript (x2) or superscript (x2) the selected text. See Text Styles.
RemoveFormat.pngRemove all the styles applied to a piece of text. 
UnorderedList.png OrderedList.pngCreates bulleted or numbered lists. See Lists.
Indent.png Outdent.pngIncreases or decreases the indentation of a list item. See Lists.
Quote.pngInsert a block quote.
Cut.pngCut a text selection.
Copy.pngCopy a text selection.
Paste.pngPaste a text from clipboard.
PasteText.pngPaste from clipboard as plain text.
PasteWord.pngCopy the content of Microsoft Word or Excel documents and paste them into the editor while preserving the structure and styles that were present in the original text.
Undo.png Redo.pngUndo or redo the most recent action taken.
Replace.pngFind and replace a character or a text selection.
AddLink.png RemoveLink.pngAdd or remove a link. See also Create and Edit Links for a detailed description.
AddImage.pngInsert an attached or an external image. See also Insert and Edit Images for a detailed description.
AddTable.pngInsert a table. See also Create and Edit Tables for a detailed description.
AddMacro.pngInsert an XWiki macro. See also Insert and Edit Macros for a detailed descriptiond.
HR.pngInserts a horizontal rule.
Styles.pngChanges the style used by the selected text. See Text Styles.
Heading.pngFormats the text as heading (level 1 to 6) and much more. See Headings.
Source.pngDisplays the wiki source code of the current page.
FullScreen.pngEnables / disables the full screen feature.

Editing Area

RichTextArea.png

The editing area is the place where you type in your text and format your document. It is a rich text area because you can see, while editing, how the text will look like after it is saved. The editing area also allows you to select a piece of text which is useful when you want to format it. If your content becomes larger than the available space in the editing area the scroll bars, vertical or horizontal, will appear. 

Text Formatting

Text Styles

You can change the way your text looks like by using the basic text styles buttons in order to make the the font bold (Bold.png), italic (Italic.png), underlined (Underline.png), stroked through (Strikethrough.png), subscript (Subscript.png) or superscript (Superscript.png). The chosen style affects either the selected text or, if there is just the insertion caret, the next characters you will be writing.

This is a text with bold style
This is a text with italic style
This is a text with underline style
This is a text with strike through style
PABC = LAB + LBC + LCA
E = mc2
Pcancel= x1a + x2b

You can mix any of these styles. To toggle off a text style, click again the associated toolbar button. If you want to remove all the styles at once click on RemoveFormat.png.

You can mix bold and italic styles: Hello user!
You can mix italic and underline styles: Hello user!
You can mix boldand strike through styles: Hello user!

Additionally, you may use the "Styles" drop-down list of the CKEditor toolbar which makes it easy to apply customized styles and semantic values to content created in the editor:

Inline Styles

Marker - associate a marker pseudo-element in order to apply list-style attributes on a given element.
Big - display the content in a <big> tag.
Small - display the content in a <small> tag.
Typewriter - apply the teletype style.

Headings

Headings can be used to organize your text. You can split the content in sections and subsections and then specify a title for each of them. You can choose the heading level to apply from the "Paragraph Format" list box on the toolbar. If you want to remove the heading style, just choose the "Normal" option. Note that formats work on block level which means that you do not need to select any text in order to apply them and entire blocks will be affected by your choice.

HeadingsMenu.png

Lists

You can create two kinds of lists:

  • numbered which are also called ordered because the order of the list items is important.
  • bulleted which are also called unordered because the order of the list items is not important.

The only difference between these two types of lists is the symbol, a number or a bullet, preceding the list items but they behave the same. To start a list, you have to place the caret on the line that you would like to become the first list item in your new list and click on the toolbar button for the type of list you wish to create: UnorderedList.png for a bulleted list or OrderedList.png for a numbered list.

CreateList1.pngCreateList2.png

You can also quickly create a list from a couple of lines by selecting those lines and clicking on the toolbar button for the type of list you wish to create.

CreateList3.pngCreateList4.png

Once you have a list, you can add more list items by using the Enter key. Pressing Enter in the middle of a list item splits that list item in two. Typing Enter at the end of a list item creates a new empty list item.

You can create sub-lists by indenting list items. To do this click the Indent.png button from the toolbar. Note that you can indent just one level because a sub-list must always have a parent list. You can indent multiple list items at once though, by selecting them first. The outdent feature, Outdent.png, is the opposite of indent. Unlike indent, you can outdent a list item multiple levels. Outdenting a top level list item transforms it in plain text.

Finally, you can mix bulleted lists with numbered lists.

CreateList5.pngCreateList6.png

After you created the list, click on the toolbar button for the associated list type to go back to plain text.

In order to create a link, you usually select the text that you would like to become the label of the link, then click on the AddLink.png menu and choose the right option based on the type of link you wish to create. You can change the label of the link later, by editing the link after it was created or directly in the editing area. 

If you don't provide a label when creating a link, the editor will use the page name / attachment name / URL / mail address. Moreover, you may use an image as the link label.

To edit the link properties, just click again on the AddLink.png menu. To select a link, you can either place the caret inside the link label or select a piece of the link label. If the link label is an image then you have to select that image.

To remove a link (unlink) you have to select it and click the RemoveLink.png menu. Note that the link label (text or image) is not deleted from the page content. 

You cannot create links inside links but unlike the old Wysiwyg editor, the CKEditor allows to create a link if the selected label spans through multiple blocks of text.

Link to a Wiki Page

To create a link to a wiki page, select the text or image you wish to become the link label and click on the AddLink.png menu which will open the options box. To quickly search for wiki pages, simply use the text box that will offer you suggestions based on the results matching your input.

Link2PageSuggestBox.png

In case you are not sure about the page name, click the file icon and either select it from the page tree or search for it using the integrated finder.

Link2PageTree.png

Advanced users can also specify a query string for the page URL (this is useful for instance when you need to create a link to the page comments or attachments) or an anchor.

Link2PageQueryString.png

Link to a Page Attachment

To create a link to an attachment, select the text or image you wish to become the link label and click on the AddLink.png menu which will open the options box. Next, click the downward icon next to the text input, select the "Attachment" option

Link2Att.png

and either use the suggestion box

Link2AttaSuggestBox.png

or click the paperclip icon and use the page tree to search for the attachment.

Link2AttTree.png

Similarly to wiki page links, you may specify a query string for the attachment URL. If the file doesn't exist in the wiki, click the "Upload" tab, choose a file from your computer and click on "Send it to the server".

Link2AttUpload.png

If you go back to the "Link Info" tab you will notice that the newly uploaded file was attached to the current page.

Link2AttFileUploaded.png

Link to a Web Page

To create a link to a web page, select the text or image you wish to become the link label and click on the AddLink.png menu. Next, click the downward icon in the "Link Info" window, select the "URL" option

Link2Att.png

and enter the web address in the text input.

Link2URL.png

Link to an Email Address

To create a link to an email address, select the text or image you wish to become the link label and click on the AddLink.png menu. Next, click the downward icon in the "Link Info" window, select the "Mail Address" option,

Link2Att.png

enter the recipient email and / or the message subject and body, then hit "Ok".

Link2Email.png

This way, each time you click the link, you will be able to send an email to the selected recipient and with the chosen subject and / or body.

Insert and Edit Images

Insert an Image

To insert an image, place the caret where you want it to be displayed and click the AddImage.png menu. You have three ways to specify which image to insert:

1) Search for an image attachment using the text input.

AddImageSuggestBox.png

2) Click the paperclip icon and use the page tree and its integrated finder.

AddImageTree.png

3) Upload a new image to the edited page as explained in link to attachment section before.

Browse to the image on your computer system and click "Send it to the Server". Then click OK.

https://network.xwiki.com/xwiki/bin/download/DocXE821En/CKEditorAttachments/Link2AttUpload.png

Edit the Image Properties

Before the image is inserted, you can edit the image properties:

  • the image width and height on the page - to lock the image aspect ratio, click the open lock icon
  • an alternative text that is printed instead of the image when the image cannot be displayed
  • the image alignment
  • whether the image is captioned or not

ImageParameters.png

Provided the "Captioned Image" option is checked, you will notice a default Caption text below or next to the inserted image (depending on the selected alignment) that you can use to add a description.

ImageCaptionBefore.pngImageCaptionAfter.png

You can resize the image inside the editing area by dragging the resize handlers or move it around using the drag & drop handlers.

ResizeImage.png

Create and Edit Tables

To create an empty table, place the caret where you would like the new table to be inserted and click the AddTable.png menu. In the opened dialog you can specify the table properties:

  • the number of rows and columns the new table should have 
  • the width and height of the table
  • whether the table header is the first row, first column or both
  • the border size
  • the cell padding and spacing
  • the table alignment: Left, Center, Right or none
  • the table caption
  • the table summary

TablePropertiesBox.png

Advanced users have the option to associate an ID and a CSS class for styling the table.

AdvancedTableProperties.png

After hitting "Ok" you should see the table in the editing area and you can navigate from cell to cell using the arrow keys.

TableAdded.png

Unlike the old Wysiwyg editor, the CKEditor allows to insert a table inside another table.

If you need a new column, you can insert one before or after an existing column. Just place the caret in one of the cells from the reference column, right-click your mouse, hover the "Column" option and choose the appropriate action from the menu. You can also delete columns in the same manner: place the caret in one of the cells from the column to be deleted and choose "Delete Columns" from the "Column" menu.

ColumnMenu.png

Inserting a new row or a cell is much like inserting a new column. First you choose a reference row / cell, then you choose the appropriate option from the "Row" / "Cell" menu. 

RowMenu.pngCellMenu.png

The "Cell" menu also has options for merging or splitting cells and for editing cell properties including:

  • width and height (in pixels or percents)
  • horizontal and vertical alignment
  • cell type: data or header
  • rows and columns span
  • background and border color
  • whether to enable word wrap or not

CellProperties.png

To delete a table or edit its properties, place the caret in any of its cells, right-click your mouse and choose the "Delete Table" or the "Table Properties" option respectively from the menu.

Insert and Edit Macros

A macro is a piece of code that you can reuse in your pages in order to do common things like displaying an information box, a table of contents or the avatar for a specific user. Start by clicking the AddMacro.png menu - you should see a dialog with all the available macros, but you can also filter then by category: Content, Development, Formatting, Internal, Navigation, Social. Each macro has a short description that will give you a hint about what it does. To access an exhaustive list of XWiki macros, please refer to the "Related Pages" section.

MacroPropertiesBox.png

Supposing you wish to use the "Page Tree" macro, just click on "Select" - parameters control the behavior and the output of a macro and some of them are mandatory. Next, click on "Submit" to insert the macro, 

PageTreeMacroProperties.png

then save the page in order to load the tree.

PageTreeMacroView.png

Paste Office Content

The PasteWord.png button of the CKEditor allows to copy the content of Microsoft Word or Excel documents and paste it to the rich text area while preserving the structure and styles that were present in the original text. Just paste what you have copied from the office application in the text area that you can see on the opened dialog and click the "Ok" button.

PasteFromWordBox.png

Page Title Behavior

Pages have both names and titles. The page name is used in the URL to the page while the title is used to display a user-friendly short description of the page. The title is used for example as the top level headings when viewing a page.

Page titles can be set while editing documents.

Common edit actions

All edit modes have some or all of the elements in the following image:

Edit Actions
Edit and Save Actions

Cancelcauses the changes to be discarded and forwards to the document view mode.
Preview

It shows the document as it would look with the current changes saved, but does not actually change the document.

From the preview mode, the user will be able to cancel the changes, return to edit mode or save the changes. This button is not available in all edit modes.

Save & ContinueIt submits the current changes and returns to the current edit mode.
Save & ViewIt submits the current changes and returns to the document view mode.
minor edit

This checkbox is meant to mark the fact that superficial changes were made to the document. Such changes may include, but are not restricted to: spelling error corrections, text rearrangements, formatting. It is the editor's responsibility to distinguish between major and minor changes.

By default, minor edits do not appear in the "What's New" page and in the document history. The option "Show minor edits" will list all the versions, including minor ones.

Version summaryThis field allows entering a short description of the changes made to the document in the version that is being saved. It is displayed in the history page and it is meant to increase comprehensibility of the content's evolution.
AutosaveThis feature automatically saves the document you're working on as a minor version at a given interval. Just check the Autosave checkbox next to the action buttons, at the bottom of the editing area. You can optionally change the autosave interval by entering the desired number of minutes in the input following the checkbox.
Tags:
Created by Vishal E on 2019/01/11 13:41