[Sommaire] [Imprimer]

   1  
   2          ------------------------------------
   3          eZ publish online editor user manual
   4          ------------------------------------
   5  
   6  The editor looks like a familiar WYSIWYG word program. Some functions are 
   7  integrate with eZ publish which we will explain in more detail in this
   8  manual. No technical experience is needed to use OE.
   9  
  10  Using the toolbar
  11  -----------------
  12  
  13  1. Text style
  14  
  15  From the dropdown list of the editor, you can choose text style of what you 
  16  are going to write. The most common style is 'normal' and other six styles 
  17  the editor supports is from 'heading 1' to 'heading 6'.
  18  
  19  2. Redo writing
  20  
  21  You can reverse the 'Undo' command by click the 'Redo' button. To reverse 
  22  more than one 'Undo' action, keep clicking the 'Redo' button.
  23  
  24  3. Undo writing
  25  
  26  You can reverse the last command or delete last entry you have written by 
  27  click the 'Undo' button. To reverse more than one action, keep clicking the
  28  'Undo' button.
  29  
  30  4. Bold format
  31  
  32  To make selected text bold, simply click on the 'Bold' button. If the 
  33  selected text is already bold, you can remove the formatting by clicking the 
  34  'Bold' button.
  35  
  36  5. Italic format
  37  
  38  To make selected text italic, simply click on the 'Italic' button. If the 
  39  selected text is already italic, you can remove the formatting by clicking 
  40  the 'Italic' button.
  41  
  42  6. Numbered list
  43  
  44  To make paragraphs as numbered list, click on the 'Numbered list' button. To
  45  continue another numbered paragraph, press 'Enter' and keep writing. Press 
  46  'Back space' when you want to stop numbered list. You can remove numbered list
  47  formatting by clicking the 'Numbered list' button if the selected text is 
  48  already numbered list. You can use 'Increase list indent'/'Decrease list indent' 
  49  to make nested list.
  50  
  51  7. Bullet list
  52  
  53  To make paragraphs as bullet list, click on the 'Bullet list' button. To 
  54  continue another bullet paragraph, press 'Enter' and keep writing. Press 
  55  'Back space' when you want to stop bullet list. You can remove bullet list
  56  formatting by click on the 'Bullet list' button if the selected text is 
  57  already bullet list. You can use 'Increase list indent'/'Decrease list indent' 
  58  to make nested list.
  59  
  60  8. Decrease list indent
  61  
  62  This button will be enabled only if you are editing list text. Click on the 
  63  'Decrease list indent' button to decrease indent for list.
  64  
  65  
  66  9. Increase list indent
  67  
  68  This button will be enabled only if you are editing list text. Click on the 
  69  'Increase list indent' button to increase indent for the list.
  70  
  71  
  72  10. Insert object
  73  
  74     10.1 Insert object
  75  
  76     Before inserting an object, make sure the object is in the list of related
  77     objects. Otherwise, you should add the inserting object to related objects
  78     list or upload local image/file first.
  79         
  80         10.1.1. Add an object to the related objects list
  81  
  82         To add an object to the related object list you can press 'Add existing'
  83         button in the main content edit window. Then you find the object you want 
  84         to add and tick off that object and click 'Select’. Now you will find the 
  85         object in the related objects list. You can also press 'Upload new' button
  86         to upload a file/image and add it as related object.
  87  
  88         10.1.2. Upload local image/file directly from insert object window.
  89         
  90         You can upload local image/file from insert object window directly by pressing
  91         'Upload new' button, choose a local image/file in the insert object window, 
  92         specify the name of the image/file, choose location from list and then click 
  93         'OK' button.
  94  
  95         10.1.3  Insert image object
  96        
  97         When the 'Insert object' button is clicked, a window will pop up where 
  98         you can choose an inserting object and specify size, alignment and 
  99         class of this object. Custom attributes can be added by clicking 'New attribute' 
 100         button. To remove custom attributes, select one or more attributes and then 
 101         press 'Remove selected' button. If the object type is an image, the real image 
 102         will be inserted into the editor after you have pressed 'OK' button.
 103           
 104         10.1.4  Insert general object
 105  
 106         If you have chosen an another type of object, note that attribute size is disabled. 
 107         Specify alignment and class of this object. Custom attributes can be added by 
 108         clicking 'New attribute' button. To remove custom attributes, select one or more 
 109         attributes and then press 'Remove selected' button. An object image 
 110         will be inserted into the editor after you have pressed 'OK' button.
 111    
 112     10.2 Edit object
 113        
 114         10.2.1  Edit image object
 115  
 116         Move your mouse to the image object, and when a cross double-arrow 
 117         appears, click the left button of the mouse and the image will be in a
 118         rectangle frame. Click on the 'Insert object' button on the toolbar, 
 119         the insert object window will pop up and the editing object is 
 120         selected in the related objects list. You can edit the image size, 
 121         alignment and class by selecting different value and then click 
 122         'OK' button. If no changes need to be done, simply click 'Cancel' 
 123         button. 
 124           
 125         10.2.2  Edit general object
 126  
 127         Move your mouse to the object, and when a cross double-arrow appears, 
 128         click the left button of the mouse and the object will be in a rectangle
 129         frame. Click on the 'Insert object' button on the toolbar, the insert 
 130         object window will pop up and the editing object is selected in the
 131         related objects list. You can edit the object by selecting different attribute
 132         values and then click the 'OK' button. If no changes need to be done,
 133         simply click 'Cancel' button. 
 134  
 135  11. Link
 136    
 137     11.1 Insert link
 138  
 139     When clicking the 'Insert link' button on the toolbar a window will pop up
 140     where you can fill up link text, link url and choose link type or class. If 
 141     the checkbox 'Open in new window' is checked, the inserted link will be 
 142     showed in a new window when the link is clicked, otherwise, the link will be
 143     showed in the parent window. You can also select text in the editor and then 
 144     click the 'OK' button. The selected text will then be filled in 
 145     'Text' textfield as link text. 
 146     
 147     11.2 Edit link
 148  
 149     Move the mouse to the link text and click, make sure that the cursor is 
 150     inside the link text and click the 'OK' button on the toolbar. After 
 151     the insert link window popped up, you can edit the link.
 152  
 153  12 Anchors
 154     
 155     12.1 Insert anchor
 156  
 157     When you click the 'Insert anchor' button, a window will pop up where you can 
 158     fill in an anchor name. Click on 'OK' button in this window to
 159     insert it, an anchor-like image will be inserted into the editor.
 160    
 161     12.2 Edit anchor
 162  
 163     Move your mouse to the anchor image object, when a cross double-arrow appears, 
 164     click the left button of the mouse. The anchor image will now be in a 
 165     rectangle frame. Click on the 'Insert anchor' button in the toolbar and the 
 166     insert anchor window will pop up and the anchor name can be changed.
 167    
 168  13 Custom tag
 169  
 170     13.1 Insert custom tag
 171  
 172     If you have already created some custom tags for eZ publish 3, the pop up 
 173     window will show a list of all available custom tags when you click on the 
 174     'Insert custom tag' button on the toolbar. Select the name of the custom tag
 175     you want to insert, checkbox 'Inline' will be checked if the selected custom 
 176     tag is of type 'inline', otherwise, the checkbox will not be checked and 
 177     textfield 'Text' is disabled. Whether a custom tag is inline or not is 
 178     defined in file content.ini under directory settings.Custom attributes can be 
 179     added by clicking 'New attribute' button. To remove custom attributes, 
 180     select one or more attributes and then press 'Remove selected' button. 
 181     Write tag content in textfield 'Text' and click the 'OK' button if the tag is 
 182     of type 'inline', a small custom tag icon will be added to the editor. If 
 183     selected custom tag is not of type 'inline', simply click 'OK' button and a 
 184     single column and single row table with sky-blue background will be added into 
 185     the editor field, then you can write tag content inside the table cell.
 186  
 187     13.2 Edit custom tag
 188  
 189     Move your mouse to the custom tag object (table or image), when a cross 
 190     double-arrow appears, click the left button of the mouse. The object will 
 191     now be in a rectangle frame. Click on the 'Insert custom tag' button in the 
 192     toolbar and a window will pop up where you can edit the tag.
 193  
 194  14 Literal input
 195  
 196     14.1 Insert literal
 197     
 198     By clicking the "Insert literal" button, a window will pop up where you can
 199     choose 'class' if you have defined available literal classes in content.ini.
 200     Click 'OK', a single column and single row table with purple background will 
 201     be added into the editor field. In this field, you can write text with tags. 
 202     For example, if you want to publish some xml formatted document, write them 
 203     inside the purple table and it will show exactly what you have written. You 
 204     can also use it as a html code editor by classify it to, for example, 'html' 
 205     class, then use eZ publish override system to render it as html code, not 
 206     literal text.
 207  
 208     14.2 Edit properties of literal
 209  
 210     Move your mouse to the literal tag object, when a cross double-arrow appears, 
 211     click the left button of the mouse. The object (table) will now be in a 
 212     rectangle frame. Click on the 'Insert literal' button in the toolbar and a 
 213     window will pop up where you can assign it to a different class.
 214  
 215  15 Special character
 216     
 217     By clicking the "Insert special character" button, special character window 
 218     will pop up. Simply choose a character and click on it, then the character 
 219     will be inserted into the editor.
 220  
 221  16 Tables
 222  
 223     16.1 Insert table
 224  
 225     A window will pop up when the 'Insert table' button is clicked. Specify table
 226     rows, columns, border, width and class, then click on the 'OK' button. 
 227     If the table border is 0, the table will be showed with red border colour.
 228  
 229     16.2 Edit table
 230  
 231      16.2.1 Edit table rows or columns
 232  
 233      Move your mouse to one of the table cells and the 'Insert row', 'Insert 
 234          column', 'Delete row' and 'Delete column' buttons on the toolbar will be 
 235          activated. By clicking the insert or delete command buttons you can add 
 236          rows and columns the way you want. 
 237      
 238      16.2.2 Split cell
 239  
 240      Move your mouse to the table cell you want to split, 'Split cell' button
 241          on the toolbar will be activated. Simply click this button, the cell 
 242          will be divided into two cells.
 243  
 244      16.2.3 Merge cells
 245  
 246      Select cells in the same row, when 'Merge cell' button on the toolbar 
 247          is activated, click it and all selected cells will be merged into one
 248      cell.
 249      
 250      16.2.4 Edit table properties
 251  
 252      Move the mouse to the table you want to edit and when a cross 
 253          double-arrow appears, click the left button of the mouse. The table 
 254          will be selected in a rectangle frame. Click the 'Insert table' button 
 255          on the toolbar and the insert table window will pop up. Note that only 
 256          table border, width and class are activated and can be changed. If no 
 257          changes need to be done, simply click 'Cancel' button.
 258  
 259      16.2.5 Remove entire table
 260      
 261      Move your mouse to the table you want to delete. When a cross 
 262          double-arrow appears, click the left button of the mouse and the table 
 263          will be selected in a rectangle frame. Then simply press 'Delete' key.
 264  
 265  17 Find text
 266  
 267  Click 'Find' button on the toolbar, a standard find text window will pop up.
 268  Note that this button is hidden for mozilla based browsers.
 269  
 270  18 Online help
 271  
 272  Click 'Help' button on the toolbar, the online help menu will show. 
 273  
 274  
 275  Using the context menu
 276  ----------------------
 277  
 278  1. Insert object, link, anchor, literal, custom tag, table.
 279  
 280  Right click mouse button and choose one of the insert commands from context 
 281  menu.
 282      
 283  2. Edit table.
 284  
 285  Move mouse to a table cell and right click mouse button and choose command 
 286  from context menu. You can insert row, insert column, delete row, delete 
 287  column, split cell or insert object, table, link, anchor, custom tag and 
 288  literal tag. To set table cell as table header, choosing "TH" from context
 289  menu; To merge cells in different rows choosing command 'Merge down' from 
 290  context menu; To edit table cell properties, choosing "Cell Properties" from
 291  context menu, a window will pop up where you can set cell width and cell 
 292  class. You can set width and class either to the selected cell, to the same
 293  row as the selected cell or to the same column as the selected cell by 
 294  choosing radio button Cell, Row, Column, respectively.
 295      
 296  3. Edit properties of object, anchor, literal, custom tag, table.
 297  
 298  Move mouse to the object (image or table), and when a cross double-arrow 
 299  appears, click the left button of the mouse. The object will be in a 
 300  rectangle frame. Right click mouse button and choose "Properties" from 
 301  context menu, the object property window will pop up. Then you can edit 
 302  properties of the object. If no changes need to be done, simply click 
 303  'Cancel' button. 
 304     
 305  4. Edit link.
 306  
 307  Move mouse to the link text and right click the mouse button. Select 
 308  "Link properties" from the context menu if you want to edit link properties;
 309  Select "Remove Link" if you just want to remove the link.
 310  
 311  5. Edit class attribute of tag header, bold, italic, ol or ul.
 312  
 313  Move mouse to the text and right click the mouse button and choose command 
 314  "Properties" from the context menu, a window will pop up where you can assign
 315  class to this tag ( You need to define available classes for this tag in 
 316  content.ini ).
 317  
 318  
 319  Tips
 320  ----
 321    
 322  1. You can add a paragraph by pressing 'Enter'.
 323  
 324  2. You can add a line break by holding the Shift key down and type 'Enter'.
 325  
 326  3. The status bar will show the current tag name, all its parent tags and 
 327     class information of the tag.
 328  
 329  4. You can make image as link by selecting the image first and then either
 330     clicking the link button in the toolbar or choose command "Insert Link" 
 331     from context menu.
 332  
 333  5. You can change the view of editor by editing editor.css under directory 
 334     extension/ezdhtml/design/standard/stylesheets/ezdhtml/.
 335  
 336  6. You can edit wordmatch.ini under directory extension/ezdhtml/settings/ 
 337     to make text copied from word directly assigned to desired class.