close   


DokuwikiFCK is no longer being supported.
It has been superceded by fckgLite and ckgedit.
close   
namespace:
close   
All questions, bug fixes, and feature requests should go through the mailing list. To subscribe to the list, do one of the following:

1. Send an email to fckglite-request@freelists.org with 'subscribe' in the Subject field
2. Visit the fckgLite page at http://www.freelists.org/list/fckglite
3. Or click the subscribe link below

Subscribe
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
faq [2014/10/15 09:51]
tower [How do I make a change to the toolbar?]
faq [2016/07/15 10:06] (current)
tower
Line 4: Line 4:
  
 \\ \\
-You can change the position of a toolbar item or remove an item by  opening the file fckg/​fckeditor/​fckconfig.js and editing ​ FCKConfig.ToolbarSets[“Dokuwiki”]+You can change the position of a toolbar item or remove an item by opening the file fckg/​fckeditor/​fckconfig.js and editing FCKConfig.ToolbarSets[“Dokuwiki”]
  
-FCKConfig.ToolbarSets["​Dokuwiki"​] = [  \\ +FCKConfig.ToolbarSets["​Dokuwiki"​] = [\\ 
-['​Bold','​Italic','​Underline','​StrikeThrough','​-','​Subscript','​Superscript'​], ​ \\+['​Bold','​Italic','​Underline','​StrikeThrough','​-','​Subscript','​Superscript'​],​\\
 ['​OrderedList','​UnorderedList','​insertHtml','​insertHtmlunorderedList',​ '​insertHtmlCode'​ ],\\ ['​OrderedList','​UnorderedList','​insertHtml','​insertHtmlunorderedList',​ '​insertHtmlCode'​ ],\\
-['​Rule',​ '​Smiley',​ '​SpecialChar',​ '​Style'​],​ [],​['​fonts'​], ​ \\ +['​Rule',​ '​Smiley',​ '​SpecialChar',​ '​Style'​],​ [],​['​fonts'​],​\\ 
-['​Cut','​Copy','​Paste','​PasteText','​PasteWord',​ '​SpellCheck',​ '​Find'​], ​ \\ +['​Cut','​Copy','​Paste','​PasteText','​PasteWord',​ '​SpellCheck',​ '​Find'​],​\\ 
-['​FontFormat'​],​ ['​Undo','​Redo','​RemoveFormat',​ '​-','​Table'​ ],  \\ +['​FontFormat'​],​ ['​Undo','​Redo','​RemoveFormat',​ '​-','​Table'​ ],\\ 
-['​Plugin_Tool', ​ '​Delete_P'​ ],​['​FitWindow'​],​\\ +['​Plugin_Tool',​ '​Delete_P'​ ],​['​FitWindow'​],​\\ 
-['​Link','​Unlink'​],​ ['​Image',​ '​Source','​geshi'​ ],  \\ +['​Link','​Unlink'​],​ ['​Image',​ '​Source','​geshi'​ ],\\ 
-['​About','​keyboard'​] ​ \\+['​About','​keyboard'​]\\
 ] ; ] ;
  
-If you want Fontformat, for instance, at the top left  of the toolbar, move it to the top of the list:+If you want Fontformat, for instance, at the top left of the toolbar, move it to the top of the list:
  
 ['​FontFormat'​],​['​Bold','​Italic','​Underline','​StrikeThrough','​-','​Subscript','​Superscript'​],​ ['​FontFormat'​],​['​Bold','​Italic','​Underline','​StrikeThrough','​-','​Subscript','​Superscript'​],​
Line 23: Line 23:
 All of the toolbar items are self-explanatory except for: All of the toolbar items are self-explanatory except for:
  
-    ​* **insertHTML**:​ adapted for nested ordered list +  ​* **insertHTML**:​ adapted for nested ordered list 
-    * **insertHTMLCode**:​ adapted for footnote editor+  * **insertHTMLCode**:​ adapted for footnote editor
 You can remove an item by removing it from the list. You can remove an item by removing it from the list.
- 
  
 ===== PHP in Code Block ===== ===== PHP in Code Block =====
- 
  
 <​file>​ <​file>​
-<?​php ​+<?php
  ​foreach($list as $plugin) {  ​foreach($list as $plugin) {
    ​if(preg_match('/​fckg_dwplugin/',​$plugin)) continue;    ​if(preg_match('/​fckg_dwplugin/',​$plugin)) continue;
Line 45: Line 43:
    ​if(!empty($indices)) {    ​if(!empty($indices)) {
        ​foreach($indices as $index) {        ​foreach($indices as $index) {
-          $labels[] = "​$index:​ " . $patterns[$index]; ​        ​ +          $labels[] = "​$index:​ " . $patterns[$index];​ 
-          $pattern = $patterns[$index]; ​      ​ +          $pattern = $patterns[$index];​ 
-          $regex .= "​|$pattern"; ​      ​+          $regex .= "​|$pattern";​
        }        }
     }     }
Line 53: Line 51:
 ?> ?>
 </​file>​ </​file>​
- 
  
 The way to achieve the best result is to type your text into a plain text editor and then copy and paste the text into the code block. The way to achieve the best result is to type your text into a plain text editor and then copy and paste the text into the code block.
- 
  
 ==== Geshi ==== ==== Geshi ====
- 
  
 Here is a piece of the above code in a Geshi code block. Here is a piece of the above code in a Geshi code block.
- 
  
 <code php> <code php>
Line 68: Line 62:
        ​foreach($indices as $index) {        ​foreach($indices as $index) {
           $labels[] = "​$index:​ "           $labels[] = "​$index:​ "
-           . $patterns[$index]; ​        ​ +           . $patterns[$index];​ 
-      $pattern = $patterns[$index]; ​      ​+      $pattern = $patterns[$index];​
       $regex .= "​|$pattern";​       $regex .= "​|$pattern";​
      }      }
     }     }
 </​code>​ </​code>​
- 
  
 For more details on Geshi code blocks see the [[:​features#​geshi_code_blocks_and_downloadable_snippets|features]] page. For more details on Geshi code blocks see the [[:​features#​geshi_code_blocks_and_downloadable_snippets|features]] page.
- 
  
 ===== Smileys ===== ===== Smileys =====
  
- +Smileys can be created with either the FCKeditor'​s smiley toolbar item or with Dokuwiki'​s smiley markup. Using Dokuwiki markup, for instance, this:<​nowiki>​ :</​nowiki>​-P will give you this :-P . Dokuwiki smileys cannot be aligned, but FCKeditor smileys can.
-Smileys can be created with either the FCKeditor'​s smiley toolbar item or with Dokuwiki'​s smiley markup. Using Dokuwiki markup, for instance, this:<​nowiki>​ :</​nowiki>​-P will give you this :-P .  Dokuwiki smileys cannot be aligned, but FCKeditor smileys can. +
  
 This is a smiley selected from the FCKeditor smiley menu: {{  http://​www.mturner.org/​fckgLite/​lib/​plugins/​fckg/​fckeditor/​editor/​images/​smiley/​msn/​regular_smile.gif?​direct&​}} This is a smiley selected from the FCKeditor smiley menu: {{  http://​www.mturner.org/​fckgLite/​lib/​plugins/​fckg/​fckeditor/​editor/​images/​smiley/​msn/​regular_smile.gif?​direct&​}}
  
- +When using the FCKeditor smileys you can set your alignment as for any other image, left, right, middle, or baseline. The above example is right-aligned. You can also re-size these smileys, as for any other image:
-When using the FCKeditor smileys you can set your alignment as for any other image, left, right, middle, or baseline. The above example is right-aligned. ​ You can also re-size these smileys, as for any other image: +
  
 {{  http://​www.mturner.org/​fckgLite/​lib/​plugins/​fckg/​fckeditor/​editor/​images/​smiley/​msn/​omg_smile.gif?​direct&​40x40 ​ }} {{  http://​www.mturner.org/​fckgLite/​lib/​plugins/​fckg/​fckeditor/​editor/​images/​smiley/​msn/​omg_smile.gif?​direct&​40x40 ​ }}
  
 +Distributions of fckgLite starting with May 8 2010 enable users to select Dokuwiki smileys from the smileys toolbar menu. They will initially be inserted as Dokuwiki text markup. But they will appear as images in the browser and in subsequent editing sessions. The administrator has the option in the configuration manger of having Dokuwiki smileys always appear as text in the editor (and, of course, images in the browser).
  
-Distributions of fckgLite starting with May 8 2010 enable users to select Dokuwiki smileys from the smileys toolbar menu.  They will initially be inserted as Dokuwiki text markup. ​ But they will appear as images in the browser and in subsequent editing sessions. ​ The administrator has the option in the configuration manger of having Dokuwiki smileys always appear as text in the editor (and, of course, images in the browser). +The difference between FCKeditor smileys and Dokuwiki smileys can have an important side-effect if you move your wiki pages to a new server or to a new domain. Dokuwiki smileys will always be available, because they are saved in native Dokuwiki format as ascii texts. But the FCKeditor'​s smileys are saved as __external__ ​ images with the full URL. Therefore when the pages are moved to a new server or domain, the domain name is no longer the same as before and the image will be lost. To overcome this, there is a configuration option, ''​smiley_hack'',​ which will enable you to convert the old URLs to URLs consistent with the new server–and this is done during the editing process. That is, when the page is loaded into the editor the new URL replaces the old, and when the document is saved the new URL is saved. See the [[:​configuration|configuration options]].
- +
- +
-The difference between FCKeditor smileys and Dokuwiki smileys can have an important side-effect if you move your wiki pages to a new server or to a new domain. ​ Dokuwiki smileys will always be available, because they are saved in native Dokuwiki format as ascii texts. ​ But the FCKeditor'​s smileys are saved as __external__ images with the full URL.  Therefore when the pages are moved to a new server or domain, the domain name is no longer the same as before and the image will be lost.  To overcome this, there is a configuration option, ''​smiley_hack'',​ which will enable you to convert the old URLs to URLs consistent with the new server–and this is done during the editing process. ​ That is, when the page is loaded into the editor the new URL replaces the old, and when the document is saved the new URL is saved. ​ See the [[:​configuration|configuration options]].+
  
 ===== Single Spacing ===== ===== Single Spacing =====
  
- +To single-space in the editor, hold down the shift key and press return. This will create a Dokuwiki newline:<​nowiki>​ \\</​nowiki>​.
-To single-space in the editor, hold down the shift key and press return. ​ This will create a Dokuwiki newline:<​nowiki> ​ \\</​nowiki>​.+
  
 ===== HTML and Dokuwiki Escapes ===== ===== HTML and Dokuwiki Escapes =====
  
- +HTML tags are automatically recognized and escaped by the fckgLite parser. So you can type in something like this:
-HTML tags are automatically recognized and escaped by the fckgLite parser. ​ So you can type in something like this: +
  
 <​b>​bold</​b>​ face or <​i>​italics</​i>​ <​b>​bold</​b>​ face or <​i>​italics</​i>​
- 
  
 See [[:​features#​html_conflicts|html_conflicts]] on the features page. See [[:​features#​html_conflicts|html_conflicts]] on the features page.
  
- +The **html conflicts** ​ section of the features page also describes how to manually esape HTML tags, as was necessary in earlier versions of fckgLite. If for some reason the parser fails to recognize your HTML , you can manually escape the tags as described there or use monospace (see [[:​faq#​monspace|below]] ).
-The **html conflicts** section of the features page also describes how to manually esape HTML tags, as was necessary in earlier versions of fckgLite. ​ If for some reason the parser fails to recognize your HTML , you can manually escape the tags as described there or use monospace (see    [[:​faq#​monspace|below]] ). +
  
 ==== Code Blocks ==== ==== Code Blocks ====
  
- +In code blocks html brackets are escaped by means of spacing < b > bold < /b > when displayed in the editor. But when they appear in the html output, the spaces are removed.
-In code blocks html brackets are escaped by means of spacing < b > bold < /b > when displayed in the editor. ​ But when they appear in the html output, the spaces are removed. +
  
 As of the July 25 2010 distributions,​ it is possible to include a text representation of a code block inside a file block and vice versa: As of the July 25 2010 distributions,​ it is possible to include a text representation of a code block inside a file block and vice versa:
- 
  
 <​code>​ <​code>​
Line 133: Line 110:
 </​file>​ </​file>​
 </​code>​ </​code>​
- 
  
 <​file>​ <​file>​
- <​code> ​ + <​code>​
       This is a code block displayed inside a file block.       This is a code block displayed inside a file block.
 </​code>​ </​code>​
 </​file>​ </​file>​
- 
  
 === Code blocks in tables and lists === === Code blocks in tables and lists ===
  
 +Code blocks can be included in tables as long as the code block is the first item in the cell.
  
-Code blocks can be included in tables as long as the code block is the  first item in the cell. +|row 1 cell 1 | <​code>​
- +
- +
-|row 1   ​cell 1 | <​code>​+
  
 row 1 row 1
Line 155: Line 128:
 |row 2 cell 1 |row 2 cell 2 | |row 2 cell 1 |row 2 cell 2 |
  
- +Code blocks cannot be inserted into lists. The FCKeditor cannot deal with this configuration of elements.
-Code blocks cannot be inserted into lists. ​ The FCKeditor cannot deal with this configuration of elements. +
- +
- +
-\\+
  
 === Code block hack for IE === === Code block hack for IE ===
  
 +Prior to distributions dated before September 15 2010, IE failed create non-parsed blocks, either standard Code blocks or File blocks. From that date onward, selecting NPB (i.e. Code) or File from the Style menu in IE will produce a valid Code block. To create a File block use the following work-around:​
  
-Prior to distributions dated before September 15 2010, IE failed create non-parsed blocks, either standard Code blocks or File blocks. ​ From that date onward, selecting NPB (i.e. Code) or File from the Style menu in IE will produce a valid Code block. ​ To create a File block use the following work-around:​ +  ​- create a Code block, with or without enclosed text elements 
- +  - put your cursor back into the block and once again go to the **Style** ​ menu and select File. You will get a normal File block.
- +
-    ​- create a Code block, with or without enclosed text elements +
-    - put your cursor back into the block and once again go to the **Style** ​     menu and select File. You will get a normal File block+
- +
- +
-If you are using a distribution earlier than Sep 25 2010, you can use this two-step method to create a block of either type.  The block will be the type of the last type selected.+
  
 +If you are using a distribution earlier than Sep 25 2010, you can use this two-step method to create a block of either type. The block will be the type of the last type selected.
  
 ==== Monspace ==== ==== Monspace ====
  
- +You can select monospace from the **Style** ​ menu to escape HTML : ''<​b>​bold</​b>''​
-You can select monospace from the **Style** ​    ​menu to escape HTML   ​: ''<​b>​bold</​b>'' ​ +
  
 This feature has been implemented as of July 25 2010. This feature has been implemented as of July 25 2010.
- 
  
 ==== Escaping Dokuwiki Escapes ==== ==== Escaping Dokuwiki Escapes ====
  
 +It is always a good idea to escape double percent signs: ''​%''''​%''​. The way to do this is to escape each one separately as monospace.
  
-It is always a good idea to escape double percent signs: ​ ''​%''''​%''​. ​ The way to do this is to escape each one separately as monospace. +The reason for escaping double per cent signs has to do with the way Dokuwiki handles these characters. All formatting between two pairs of these escapes will be lost; so if you are going to have only one pair on your page, it's not necessary to escape them. But if you have one at the top of your page and another in the middle, everything between them will be gobbled up into a single string.
- +
- +
-The reason for escaping double per cent signs has to do with the way Dokuwiki handles these characters. ​ All formatting between two pairs of these escapes will be lost; so if you are going to have only one pair on your page, it's not necessary to escape them.  But if you have one at the top of your page and another in the middle, everything between them will be gobbled up into a single string. +
  
 So this: So this:
  
- +  ​* ''​%''''​%'' ​ one 
-    ​* ''​%''''​%'' ​    ​one +  * two 
-    * two +  * three ''​%''''​%''​
-    * three ''​%''''​%'' ​ +
  
 unescaped will become this: unescaped will become this:
  
- +  ​* one<​nowiki>​*</​nowiki>​ two<​nowiki>​*</​nowiki>​ three
-    ​* one<​nowiki>​*</​nowiki>​ two<​nowiki>​*</​nowiki>​ three +
  
 ==== nowiki ==== ==== nowiki ====
- 
  
 fckgLite accepts the nowiki tag, inserted directly into the editor: fckgLite accepts the nowiki tag, inserted directly into the editor:
- 
  
 <​nowiki><​nowiki>​This is a **text** that has been marked up</​nowiki></​nowiki>​ <​nowiki><​nowiki>​This is a **text** that has been marked up</​nowiki></​nowiki>​
  
- +The markup is preserved. This is a link: <​nowiki>​[[http://​www.dokuwiki.org|http://​www.dokuwiki.org]] </​nowiki>​ is preserved as markup because it is held between nowiki tags.
-The markup is preserved. ​ This is a link: <​nowiki>​[[http://​www.dokuwiki.org|http://​www.dokuwiki.org]] </​nowiki>​ is preserved as markup because it is held between nowiki tags. +
  
 See [[http://​www.dokuwiki.org/​syntax#​no_formatting|http://​www.dokuwiki.org/​syntax]]. See [[http://​www.dokuwiki.org/​syntax#​no_formatting|http://​www.dokuwiki.org/​syntax]].
- 
  
 When a text is placed between nowiki tags and loaded back into the FCKeditor, the text will appear as though formatted: When a text is placed between nowiki tags and loaded back into the FCKeditor, the text will appear as though formatted:
- 
  
 Instead of <​nowiki><​nowiki>​[[:​http:​www.example.com|www.example.com]] </​nowiki></​nowiki>​ Instead of <​nowiki><​nowiki>​[[:​http:​www.example.com|www.example.com]] </​nowiki></​nowiki>​
- 
  
 you will see <​nowiki><​nowiki></​nowiki>​http:​[[http://​www.example.com|www.example.com]].<​nowiki></​nowiki></​nowiki>​ you will see <​nowiki><​nowiki></​nowiki>​http:​[[http://​www.example.com|www.example.com]].<​nowiki></​nowiki></​nowiki>​
- 
  
 But when the text is displayed in the browser, the text and its native Dokuwiki markup will be displayed. But when the text is displayed in the browser, the text and its native Dokuwiki markup will be displayed.
- 
  
 ==== nowiki, percent escapes, plugin syntax ==== ==== nowiki, percent escapes, plugin syntax ====
  
- +This is primarily for developers. Versions of fckgLite as of Jan 12 1011 will check for for pairs of the following characters: ~#:^ and for these pairs: {} <>. If they are bracketed by Dokuwiki percent escapes, the percent characters will be converted to nowiki tags on saves. For instance:
-This is primarily for developers. ​ Versions of fckgLite as of Jan 12 1011 will check for for pairs of the following characters: ~#:^ and for these pairs: {} <>​. ​  ​If they are bracketed by Dokuwiki percent escapes, the percent characters will be converted to nowiki tags on saves. ​ For instance: +
  
 <​nowiki>​%%<​note important>​%%</​nowiki>​ <​nowiki>​%%<​note important>​%%</​nowiki>​
- 
  
 becomes: becomes:
- 
  
 <​file>​ <​file>​
 <​nowiki><​note important></​nowki>​ <​nowiki><​note important></​nowki>​
 </​file>​ </​file>​
- 
  
 As of Jun 28 2011 percent escapes can be used on most text elements. But the safest markup is to use the nowiki tags. This would be particularly true of texts which contain asterisks. As of Jun 28 2011 percent escapes can be used on most text elements. But the safest markup is to use the nowiki tags. This would be particularly true of texts which contain asterisks.
- 
  
 ===== Short-Cut Keys ===== ===== Short-Cut Keys =====
  
- +fckgLite has a set of CTRL-based short-cut keys. See the [[:​short_cut_keys|short_cut_keys]] page.
-fckgLite has a set of CTRL-based short-cut keys.  See the [[short_cut_keys]] page.+
  
 ===== Font Tool Examples ===== ===== Font Tool Examples =====
- 
  
 ==== Font Tool Example ==== ==== Font Tool Example ====
  
- +<font 12pt:​bold/​Times New Roman;;​inherit;;​inherit ​ >This is a sample of Times 12 pt bold</​font>​
-<font 12pt:​bold/​Times New Roman;;​inherit;;​inherit ​ >This is a sample of Times 12 pt bold</​font> ​ +
  
 The font tool cannot be used in conjunction with Dokuwiki'​s standard typographic formatting features; they will be silently removed. The font tool cannot be used in conjunction with Dokuwiki'​s standard typographic formatting features; they will be silently removed.
  
 ==== Font Tool and Color ==== ==== Font Tool and Color ====
- 
  
 As of distributions beginning Jan 20 2011, the font tool can set forground and background colors for As of distributions beginning Jan 20 2011, the font tool can set forground and background colors for
- 
  
 text. text.
  
- +<font 9pt:​normal/​Times New Roman;;​red;;​yellow ​      >​Red type on yellow background in 10 pt Times New Roman</​font>​
-<font 9pt:​normal/​Times New Roman;;​red;;​yellow ​      >​Red type on yellow background in 10 pt Times New Roman</​font> ​ +
  
 <font 14pt:​bold/​auto;;​blue;;​inherit ​      >​Blue type in 14 pt bold</​font>​ <font 14pt:​bold/​auto;;​blue;;​inherit ​      >​Blue type in 14 pt bold</​font>​
  
 ===== Using fckgLite in the Single User Configuration ===== ===== Using fckgLite in the Single User Configuration =====
- 
  
 If you have a single user installation or your users have complete access to the file system, you can create a completely open file browsing configuration,​ using the following configuation options: If you have a single user installation or your users have complete access to the file system, you can create a completely open file browsing configuration,​ using the following configuation options:
  
- +  ​* open file browsing: true 
-    ​* open file browsing: ​ true +  * enable folder creation: y 
-    * enable folder creation: y +  * Default file browsing access: none
-    * Default file browsing access: none +
  
 For more details on configuration options, see [[:​configuration|configuration]]. For more details on configuration options, see [[:​configuration|configuration]].
- 
  
 ===== What is the Version Number? ===== ===== What is the Version Number? =====
  
- +The fckgLite version is found by clicking on the question mark icon in the toolbar and then clicking on the 'About fckgLite” tab. This will tell you the version you are using and its date. For instance 06-10-Feb_25-09_28,​ which is version 06 created on Feb 25 2010 at 9:28.
-The fckgLite version is found by clicking on the question mark icon in  the toolbar and then clicking on the 'About fckgLite” tab.  This will  tell you the version you are using and its date.  For instance 06-10-Feb_25-09_28,​ which is version 06 created on Feb 25 2010 at  9:28. +
  
 You can also find the version in the version file found in plugins/​fckg/​ You can also find the version in the version file found in plugins/​fckg/​
Line 307: Line 233:
 ===== Firefox 3.6 Windows ===== ===== Firefox 3.6 Windows =====
  
 +There is an issue with Firefox 3.6, which may fail when large files are uploaded using the file browser. This issue appears to affect only Firefox 3.6 in Windows and may be an issue only if the development tool Firebug is installed. If you wish to continue to use Firefox, and are having this problem with 3.6, you can upgrade your Firefox or revert to an earlier version by going to:
  
-There is an issue with Firefox 3.6, which may fail when large files are  uploaded using the file browserThis issue appears to affect only  Firefox 3.6 in Windows and may be an issue only if the development tool  Firebug is installed. If you wish to continue to use Firefox, and are  having this problem with 3.6, you can upgrade your Firefox or revert to  an earlier version by going to: +[[ftp://ftp.mozilla.org/​pub/​mozilla.org/​firefox/​releases/​|ftp://​ftp.mozilla.org/​pub/​mozilla.org/​firefox/​releases/​]].
- +
- +
-[[ftp://​ftp.mozilla.org/​pub/​mozilla.org/​firefox/​releases/​]].+
  
 ===== Asking Questions ===== ===== Asking Questions =====
- 
  
 When asking questions on the Forum or the Mailing List, you should try to provide the following information:​ When asking questions on the Forum or the Mailing List, you should try to provide the following information:​
  
 +  - The browser(s) where the problem has occurred, and does it happen in all browsers or just certain browsers?
 +  - The operating system on which the browser is installed
 +  - The version of fckgLite (See [[:​faq#​what_is_the_version_number|above]] )
 +  - The Dokuwiki version
 +  - The operating system on which Dokuwiki is installed
 +  - The web server (apache or something else).
 +  - The php version
  
-    - The browser(s) where the problem has occurred, and does it happen in all browsers or just certain browsers? +\\
-    - The operating system on which the browser is installed +
-    - The version of fckgLite (See [[:​faq#​what_is_the_version_number|above]] ) +
-    - The Dokuwiki version +
-    - The operating system on which Dokuwiki is installed +
-    - The web server (apache or something else). +
-    - The php version+