Archive:Tutorial:Editing with Rich Editor

Editing articles in Statistics Explained can be done either directly in the markup code or using the Rich Editor. Both have their advantages, but working with the Rich Editor is more intuitive and straightforward, rather like simplified MS Word.

This article gives an overview of the features of the Rich Editor and explains how to use them. For a task-oriented rather than this tool-oriented perspective, consult the tutorials on creating a statistical article or a glossary page.

The Rich Editor essentially consists of pre-formatted word processing buttons supplemented with new ones specially created for Statistics Explained. Those additional buttons, in the bottom row, activate templates for the most frequent actions in Statistics Explained, usually inserting a specific link (to Eurostat publications and Database, to a legal text in EUR-Lex, to Glossary pages etc.).

Opening Statistics Explained, 'edit' mode and Rich Editor

Entering and navigating Statistics Explained

Go to the Main Page (URL: http://epp.eurostat.ec.europa.eu/statistics_explained). To navigate within Statistcis Explained, use the hierarchical theme tree, the categories or the search function (alt-f). The easiest way to access a page you know the name of, start typing the name in the search box (top left of any page) and if the page name appears in the lists displayed, click it.

Logging in and entering 'edit' mode

In order to edit pages, you have to log in:

click 'Log in' on the top right;
complete the boxes (both 'Username' and 'Password' are the regular ones for logging in the system when starting your pc, 7-digit and at least 10-digit, resp.) and click 'Login';
click 'Edit' or 'Edit draft' (if a draft already exists - in that case, all differences with the last validated stable page will be displayed next one another).

Activating and disabling the Rich Editor

Click just above the editing frame, to the right, [Rich Editor] or, if you prefer,[Open Rich editor in new window].

Loading a Model

The box 'Select boilerplate' allows you to load a model of a statistical article, image or different types of glossary page (general concept, nomenclature, statistical concept, statistical indicator, statistical method, survey or data collection). The models already contain the predefined structure, all headings and templates which could be useful, all in their appropriate place.

WARNING: loading a model from the boilerplate will overwrite all existing content! If you want to preserve text already there, select and copy it, load the appropriate model and then paste it back in. If you have inadvertently overwritten something, you can always go to 'history' and roll back or undo.

To load a model:

open the menu under 'Select boilerplate' above the edit frame (see image above);
select the appropriate model;
click 'Load';
click 'Save page' (below the edit frame, on the left).

Inserting content

You can either write new content from scratch or, alternatively, convert existing material to Statistics Explained. This is very easy, essentially by copying the original text from a Word document, pdf file, web page, ... and pasting it in the appropriate place. If you are preparing a new article, it may be convenient to write a draft in MS Word, using its advanced possibilities, and paste this in Statistics Explained.

WARNING: only the text itself can be pasted in, not the formatting! So while writing in Word, avoid any but the most basic formatting. The actual formatting has to be done in Statistics Explained, using the Rich Editor functions described below. It is fairly straightforward and simple: inserting paragraph separation lines, headings, bullets, indents, bold, italic, etc.

Text formatting (Row I)

The first two lines of Rich Editor buttons are essentially for formatting selected text, printing, searching, spelling check etc. If you work with MS Word, most should already be familiar. They are briefly explained below, in order of appearance; between brackets is their location: row I, II or III, position 1,2,3 etc.

Wikitext (I1)

Click Wikitext to change the view in the editing frame to wiki markup which can be directly edited (see Tutorial on editing in markup); it switches off the Rich Editor (thus having the same effect as clicking 'Disable rich editor' on the right above the editing frame). Click 'Wikitext' again to revert to the Rich Editor.

Cut (I2)

Click Cut to remove selected text.

Copy (I3)

Copying selected text by clicking Copy may not work; instead, after having selected the text you want to copy, click ctrl+c.

Note: copying directly in markup may be an easier alternative (select + rightmouseclick 'copy').

Paste (I4)

Similarly, clicking Paste in order to paste copied text to the location your cursor is positioned, opens a window in which you can paste the text (via ctrl+v or right mouse button/select and click 'Paste') and insert it by clicking 'OK'.

Note: copying and pasting directly in markup may be an easier alternative (select + rightmouseclick 'copy', position cursor + rightmouseclick 'paste').

Print (I5)

Click Print to print the page or a selection, in page view. TO BE VERIFIED

Undo (I6)

Click Undo to undo the last action performed, then the next-to-last one etc.

Redo (I7)

Click Redo to redo the last action undone, then the next one etc.

Find (I8)

Click Find to open a window Find and replace which allows you to search for the text inserted in the box Find what; if you click the second option Replace, you can replace the text inserted in the first box Find what with an alternative one inserted in the second box Replace with. If you tick Match case, only text exactly matching as to upper and lower case is found (and replaced); if you tick Match whole word only complete words, and not parts of other words, are found (and replaced).

Replace (I9)

Click Replace to open a window Find and replace which allows you to replace the text inserted in the first box Find what with an alternative one inserted in the second box Replace with. By clicking the other option Find, you can simply search for the text inserted in the Find what box. If you tick Match case, only text exactly matching as to upper and lower case is found (and replaced); if you tick Match whole word only complete words, and not parts of other words, are found (and replaced).

Select all (I10)

Click Select all to select the whole text.

Remove format (I11)

Click Remove format to convert selected text back to unformatted 'Normal' text (removing bold, italic, underline, bullets, heading etc).

Insert special character (I12)

Click Insert special character to open a window Select special character; select and click the one you want to insert (at the location where your cursor was positioned).

Insert horizontal line (I13)

Click Insert horizontal line to insert a horizontal line below the cursor position. Use this feature sparingly! Normally there is no need in Statistics Explained for horizontal lines.

Check spelling (I14)

Select the text to be checked as to spelling (or click Select all, I10) and click Check spelling.

About FCKeditor (I15)

Click About FCKeditor to find version and similar information on the Rich Editor 'FCKeditor' as well as links to further information.

Text formatting (Row II)

Format (II1)

Next to Format click dropdown menu, select and click the format required. Normal is regular text, Heading 1 is page title (not to be used in text itself!), Heading 2 to Heading 6 are the possible levels of headings (don't exaggerate, going beyond Heading 4 is not recommended).

Bold (II2)

Click Bold to convert the selected text to bold.

Italic (II3)

Click Italic to convert the selected text to italic.

Underline (II4)

Click Underline to underline the selected text.

Strike Through (II5)

Click Strike Through to display the selected text ~~struck through~~.

Subscript (II6)

Click Subscript to display the selected text as _subscript.

Superscript (II7)

Click Superscript to display the selected text as ^superscript.

Insert/Remove Numbered List (II8)

Click Insert/Remove Numbered List to display the line selected or where the cursor is positioned as (part of)

a numbered list.

Click Insert/Remove Numbered List again to remove the numbered list.

Insert/Remove Bulleted List (II9)

Click Insert/Remove Bulleted List to display the line selected or where the cursor is positioned as (part of)

a bulleted list.

Click Insert/Remove Bulleted List again to remove the bulleted list.

Blockquote (II10)

Click Blockquote to

blocquote the slected text.

Click Blockquote again to remove the blockquote.

Maximize the editor size (II11)

Click Maximize the editor size to display the Rich Editor editing frame in its maximum size.

Important !

In the following sections, the focus is on the insertion of links and objects, but any time afterward they can also be edited and modified at wish: just select the inserted link or object and click the corresponding button (for publication, data, EUR-lex or glossary link, etc.).

If, for instance, you want to change the text displayed in the link to a Eurostat publication: select the publication link and click the button Publication, make the change and click OK.

Alternatively, you can modify directly in the template itself: select the link, rightclick mouse, select 'Template properties', make the change and click OK.

Insert/Edit Image (II12)

Before you can insert an image in a page, you first have to upload it in Statistics Explained, see Tutorial:Creating a Statistical article#Inserting_an_Image (http://epp.eurostat.ec.europa.eu/statistics_explained/index.php/Tutorial:Creating_a_Statistical_article#Inserting_an_Image).

To insert an image in a page, click Insert/Edit Image and in the window which opens:

paste or type the image file name (or some key words) in the first box Image file name;
in the second box Automatic search results (start typing in the above field/ x images found), image file names now appear which contain the text in the first box; if you see the image file you want to insert, click it and it will be displayed in the first box; a preview is shown to the right;
in the box Caption insert or paste the text you want to appear as a caption below the image; normally this is the title of the image file you can copy/paste (without underscores!) preceded by 'Table/Graph/Map x:';
in the box Special Type choose how the image is to be displayed (normally Thumbnail);
in the box Align choose where the image is to be positioned (normally Right);
in the box Width insert the size of the image (normally 350 pixels);
the box Height need not be completed;
click OK.

Paste Table (II13)

To paste an Excel table (or part) in Statistics Explain, click Paste Table and in the window which opens:

paste the table in the box;
below, in the HTML Result preview box, a preview is displayed (if not, position your cursor in the table you inserted and move it);
edit the table, if necessary (you can also do so directly in the Rich Editor edit view):

.

if the HTML Result preview is satisfactory, click OK.

Insert/Edit Table (II14)

If you want to insert the formatting for a table (without data, content can easily be inserted afterward, directly in the Rich Editor frame), position your cursor on the location you want to insert the table and click Insert/Edit Table. In the window Table Properties which then opens, specify the table properties:

Rows: insert number of rows required (default 3);
Columns: insert number of columns (default 2);
Headers: specify whether you want a row and/or column header by selecting either None, First row, First column or Both (first row and column):
Border size: default 1
Alignment: select either <Not set>, Right, Center or 'Left; normally tables are aligned left;
Width:
Height:
Cell spacing:
Cell padding:
Caption: insert the text you want to be shown as a caption above the table (preceded by Table x: );
Summary:

Remark: you can always try out the different settings and click Show preview, see how it looks and then go down to the edit frame again to modify - but be careful: your changes are not saved, do not click edit again or you lose them!

Inserting links and objects (Row III)

Insert/Edit Link (III1)

Select the text you want to add a link to and click Insert/Edit Link.

In the window Link which now opens type or paste in the box Link:

a URL starting with 'http:// ' for an external link (a link going outside Statistics Explained, which includes the rest of the Eurostat website);
the name of the page in Statistics Explain you want to link to, for an internal link (in Statistics Explained); this starts an automatic search displayed in the box Automatic search results (start typing in the above field) below; if you see the page you want to link to, select it by clicking it, then click OK.

If you want to edit or change an existing link, select the linked text and click Insert/Edit Link, make the necessary changes.

Remove Link (III2)

Select the text with the link you want to remove, click Remove Link.

Publication (III3)

To insert a link to the download page of a Eurostat publication:

click Publication;
in the window which opens, insert the Publication code in the first box (the 9-digit publication code can be found in the URL of the publication on the Eurostat website or at the back of the printed version);
in the second box insert the Text to display: the exact title of the publication as it appears in the target page, supplemented if necessary by the edition (e.g. '2010 edition') or additional information (e.g. 'Statistics in focus 10/2010');
click OK.

Data (III4)

To insert a deep link to a specific dynamic table in the Eurostat Database:

click Data;
in the window which opens, insert the Data code in the first box (the list of available data codes can be found here: );
in the second box insert the Text to display: the exact title as it appears above the target table (do not include the data code, this will be displayed automatically behind the title, between brackets);
click OK.

EUR-Lex (III5)

Each EUR-Lex document can be identified by a unique code consisting of number, type and year.

To insert a deep link to the download page of a legal text (Regulation, Directive, Decision or COM final document) in the EUR-Lex database:

click EUR-Lex;
in the window which opens, complete the 3 first boxes:

Year: YYYY
Type: choose one of the four types to assign code R, L, D or DC, for Regulation, Directive, Decision or COM final document, respectively;
Number: NNNN

the fourth box Language is fixed at EN (at the moment English-language only);
EURLex product code in the fifth box is generated automatically from the first four entries;
as is the Text to display in the fifth box; if the number consists of less than four digits, it may be necessary to remove the 0, 00 or 000 in front.
click OK.

Glossary (III6)

To insert a link to a Glossary page:

select the word(s) you want to link;
click Glossary;
in the window which opens, the selected text is displayed in the first box;*at the same time the Rich Editor automatically searches for Glossary pages containing the selected word(s) and displays the result in the second box - only the Glossary Namespace is searched (pages preceded by 'Glossary:');
if one or more results are displayed, select the Glossary page you want to link to by clicking on it, then click OK;*if no Glossary page containing the exact word or words is found, you can change the text in the first box and the search will automatically adapt; you can shorten it, for instance, from 'employees' (no results) to 'employee' and link to one of the results of this search, 'Glossary:Employee' - as a result, a link will be created from 'employees', the originally selected word, to 'Glossary:Employee;
the word or words linked to a Glossary page can also be modified directly in the text.

Insert/Edit categories (III7)

To assign a page to one or more categories (by adding a category link on the page):

click Insert/Edit categories;
in the window which opens, the first box Selected categories displays any categories to which the page is already assigned;*the third box Category tree (start typing in the above field) shows all categories - the categories in blue are higher-level categories containing subcategories which can be opened by clicking them;
by typing text in the second box Search category the categories displayed in the third box are limited to the ones containing the search term(s);
select a category in the third box and click Add new;*if you have added all categories required, click OK.

Insert/Edit Template (III8)

To insert a link to a Eurostat publication:

click Insert/Edit Template;
in the window which opens, type or paste a template in the box Template raw definition (from Template:To);**click OK.

Insert/Edit Special Tag (III9)