plugin:ckgedit
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:ckgedit [2019-05-15 15:54] – [Last 10 commits] turnermm | plugin:ckgedit [2023-07-27 16:01] (current) – [CKGEdit Plugin] turnermm | ||
---|---|---|---|
Line 3: | Line 3: | ||
---- plugin ---- | ---- plugin ---- | ||
description: | description: | ||
- | author | + | author |
email : turnermm02@shaw.ca | email : turnermm02@shaw.ca | ||
type : syntax, action | type : syntax, action | ||
- | lastupdate : 2019-04-04 | + | lastupdate : 2022-10-06 |
- | compatible : Angua,Adora Belle, Weatherwax, | + | compatible : Detritus, |
depends | depends | ||
- | conflicts | + | conflicts |
- | similar | + | similar |
- | tags : wysiwyg, | + | tags : wysiwyg, |
- | # | + | downloadurl: |
- | downloadurl: | + | |
bugtracker : https:// | bugtracker : https:// | ||
sourcerepo : https:// | sourcerepo : https:// | ||
Line 20: | Line 19: | ||
screenshot_img : http:// | screenshot_img : http:// | ||
---- | ---- | ||
+ | |||
+ | ===== Version 2022-02-27 ===== | ||
+ | ==== This version adds two new features. ==== | ||
+ | - CTRL-Q will exit the editor and save any changes to the document | ||
+ | - Compatibility with [[plugin: | ||
+ | |||
+ | |||
===== Index to Ckgedit documentation on dokuwiki.org ===== | ===== Index to Ckgedit documentation on dokuwiki.org ===== | ||
** [[plugin: | ** [[plugin: | ||
+ | |||
===== About ckgedit ===== | ===== About ckgedit ===== | ||
+ | |||
Ckgedit is a graphical editor for Dokuwiki based on the open source CKEditor. | Ckgedit is a graphical editor for Dokuwiki based on the open source CKEditor. | ||
Line 29: | Line 37: | ||
+ | ===== Changelog ===== | ||
- | ==== History ==== | ||
- | The original of ckgedit was called DokuwikiFCK (about 2007) and was based on a Perl parser which converted HTML into wiki markup for a variety of wikis, including Dokuwiki. | ||
- | |||
- | In the meantime, I came across a javascript HTML parser written by John Resig (creator of jQuery) and realized I could convert html to markup in the browser. | ||
- | |||
- | ===== Changelog ===== | ||
==== Last 15 commits ==== | ==== Last 15 commits ==== | ||
- | {{rss> | + | {{rss> |
===== Installation ===== | ===== Installation ===== | ||
- | For the basic install use the Dokuwiki [[plugin: | + | For the basic install use the Dokuwiki [[plugin: |
- | This version of ckgedit uses the latest release of the CKEDitor (4.10.1). Should you experience any difficulties, | + | This version of ckgedit uses the latest release of the CKEDitor (4.11.4). Should you experience any difficulties, |
**Issues:** You can post issues to the [[https:// | **Issues:** You can post issues to the [[https:// | ||
Line 52: | Line 55: | ||
==== File Browser ==== | ==== File Browser ==== | ||
+ | |||
When the plugin is initally installed, you will get an information message saying that a set of symbolic links have been created. | When the plugin is initally installed, you will get an information message saying that a set of symbolic links have been created. | ||
ln -s path_to/ | ln -s path_to/ | ||
Line 61: | Line 65: | ||
| | ||
In all of the examples, it is assumed you are in '' | In all of the examples, it is assumed you are in '' | ||
+ | |||
+ | For information about creating symbolic links in Windows using the Power Shell, see \\ https:// | ||
For a complete discussion of how to handle the security for this set-up, see the [[http:// | For a complete discussion of how to handle the security for this set-up, see the [[http:// | ||
Line 68: | Line 74: | ||
There are extended instructions for using the file browser on the fckgLite [[http:// | There are extended instructions for using the file browser on the fckgLite [[http:// | ||
- | Many problems can be solved by using the [[plugin: | + | Many problems can be solved by using the [[plugin: |
==== ckgdoku ==== | ==== ckgdoku ==== | ||
Line 93: | Line 99: | ||
- | === Alternate Save Directory === | + | ==== Alternate Save Directory |
- | If you set the [[: | + | In Windows systems, |
- | - You must use the '' | + | |
- | | + | |
- | < | + | |
- | ln -s / | + | |
- | ln -s / | + | |
- | ln -s / | + | |
- | </ | + | |
- | On Windows machines you can create links using '' | ||
+ | For any new save directory, | ||
- | For more information consult | + | On Windows machines you can create links using '' |
- | === CKEditor Upgrades === | + | For these to work properly for images, you have to install one of more lenient '' |
- | The current distribution of ckgedit has been upgraded from CKEditor 4.9 to 4.10. It had previously been upgraded from 4.01 to 4.2.2 and then to 4.4.3, 4.5.1 and 4.7 | + | ==== CKEditor Upgrades |
+ | The current distribution of ckgedit has been upgraded from CKEditor 4.10 to 4.11.4. It had previously been upgraded from 4.01 to 4.2.2 and then to 4.4.3, 4.5.1 and 4.7 | ||
Line 155: | Line 155: | ||
To achieve the same effect when editing in the ckgeditor, you prepend the divaling2 markup elements with the '' | To achieve the same effect when editing in the ckgeditor, you prepend the divaling2 markup elements with the '' | ||
=== numbered headings === | === numbered headings === | ||
- | While the [[plugin: | + | While the [[plugin: |
==== Multi-Line Plugins ==== | ==== Multi-Line Plugins ==== | ||
Line 180: | Line 180: | ||
===== Geshi example ===== | ===== Geshi example ===== | ||
==== Geshi plugin ==== | ==== Geshi plugin ==== | ||
+ | === Basic instructions === | ||
Ckgedit includes a Geshi plugin in the CKEditor toolbar. | Ckgedit includes a Geshi plugin in the CKEditor toolbar. | ||
- | **Video:** [[http:// | + | **Video:** [[http:// |
+ | === Geshi CSS === | ||
+ | The Geshi highlighting does not appear until you reload your page. When you load the page back into the editor a basic level of highlighting will be applied to the snippet. | ||
+ | Remember to clear your browser cache when changing these settings. | ||
+ | === Syntax Highlighting === | ||
+ | Current versions of ckgedit support [[: | ||
+ | <code JavaScript> | ||
+ | /* [enable_line_numbers=" | ||
+ | var de = function() { | ||
+ | return (typeof(window.de) == ' | ||
+ | }(); | ||
+ | </ | ||
+ | For details on the extra highlighting features see the [[: | ||
===== Adding CKEditor plugins to the toolbar ===== | ===== Adding CKEditor plugins to the toolbar ===== | ||
Line 222: | Line 234: | ||
< | < | ||
===== HTML BLOCKS ===== | ===== HTML BLOCKS ===== | ||
- | **Note:** This feature requires that either Dokuwiki' | + | **Note:** This feature requires that either Dokuwiki' |
Feature added 22 Apr 2015. | Feature added 22 Apr 2015. | ||
Line 233: | Line 245: | ||
It could be useful, for instance, to save a complex table that does not parse correctly, despite use of the complex tables setting. | It could be useful, for instance, to save a complex table that does not parse correctly, despite use of the complex tables setting. | ||
- | {{ | + | {{ |
When the html block is loaded back into the editor, it can be edited normally and re-saved with the changes. | When the html block is loaded back into the editor, it can be edited normally and re-saved with the changes. | ||
Line 248: | Line 260: | ||
~~CLOSE_HTML_BLOCK~~ | ~~CLOSE_HTML_BLOCK~~ | ||
</ | </ | ||
- | In this case, when you reload the ckgeditor, you will see only the Start and Close macros, but the html will still be there, as you can see if you use the '' | + | In this case, when you reload the ckgeditor, you will see only the Start and Close macros, but the html will still be there, as you can see if you use the '' |
When an HTML Block is processed by the ckgeditor and saved to the Doukwiki file, it is saved as a code block containing the HTML. When loaded back into the editor, the HTML is extracted from the code block and inserted back into the editor. | When an HTML Block is processed by the ckgeditor and saved to the Doukwiki file, it is saved as a code block containing the HTML. When loaded back into the editor, the HTML is extracted from the code block and inserted back into the editor. | ||
Line 276: | Line 288: | ||
The toolbar is defined in ckeditor/ | The toolbar is defined in ckeditor/ | ||
- | There are three toolbars and each can be changed. | + | There are three toolbars and each can be changed. |
=== Adding Plugins === | === Adding Plugins === | ||
Additional plugins (or '' | Additional plugins (or '' | ||
+ | === The Blockquote toolbar Button === | ||
+ | The Blockquote button has recently been added to the standard toolbar. In the editor, its CSS is controlled by the additional.css file. ((See the [[# | ||
===== Image Drag and Drop ===== | ===== Image Drag and Drop ===== | ||
< | < | ||
Line 298: | Line 312: | ||
It is possible to handle images of 2 - 2.5 MB in Firefox using the MS Word plugin. | It is possible to handle images of 2 - 2.5 MB in Firefox using the MS Word plugin. | ||
- | |||
- | A fool-proof method of copying and pasting is to install the [[plugin: | ||
- | |||
Line 324: | Line 335: | ||
To use relative links for both internal links and media links , the ckgedit relative links configuration option must be set to true. See: [[plugin: | To use relative links for both internal links and media links , the ckgedit relative links configuration option must be set to true. See: [[plugin: | ||
- | + | ===== RSS Feeds ===== | |
+ | You can enter the Dokuwiki RSS feed markup directly into ckgedit' | ||
+ | However, on being reloaded into ckgedit' | ||
+ | {{rss> | ||
+ | will become this: | ||
+ | { { rss> | ||
+ | On being saved it will revert to the original Dokuwiki markup. Secure '' | ||
===== Examples ===== | ===== Examples ===== | ||
For some examples of using plugins with ckgedit and of some other features, such as line spacing, see: | For some examples of using plugins with ckgedit and of some other features, such as line spacing, see: | ||
* [[http:// | * [[http:// | ||
* [[http:// | * [[http:// | ||
+ | |||
===== Language Support, Localization ===== | ===== Language Support, Localization ===== | ||
Line 355: | Line 372: | ||
lang: ' | lang: ' | ||
</ | </ | ||
- | Add your ISO code and a comma lang, e.g.: ' | + | Add your ISO code and a comma, e.g.: ' |
===== Compression ===== | ===== Compression ===== | ||
- | The '' | + | The '' |
===== Editor Window Height ===== | ===== Editor Window Height ===== | ||
The height of the editor window can be set by entering a new value in the '' | The height of the editor window can be set by entering a new value in the '' | ||
- | {{ http:// | + | {{ http:// |
The new height will take effect when the editor is reloaded. | The new height will take effect when the editor is reloaded. | ||
+ | ===== Style Sheets for the CKEditor editing window ===== | ||
+ | Ckgedit comes with a default css scipt for the editing window. | ||
+ | ==== CKEditor editor CSS tool ==== | ||
+ | If you would like the styling of the editing window to match that of your template, you can create a template-specific css file that will be used instead of contents.css. | ||
+ | === additional.css === | ||
+ | |||
+ | To make modifications to your css, you can add rules to a file named '' | ||
===== Short-cut keys ===== | ===== Short-cut keys ===== | ||
- | | CTRL + I |italic| | + | | CTRL + I |
- | | CTRL + B |bold| | + | | CTRL + B |
- | | CTRL + U |underline| | + | | CTRL + U | underline |
- | | CTRL + Z |undo| | + | | CTRL + Z |
- | | CTRL + Y |redo| | + | | CTRL + Y |
- | | CTRL + L |link| | + | | CTRL + L |
- | | ALT + - | + | | ALT + - | numbered list |
- | | ALT + 8 |bulleted list| | + | | ALT + 8 | bulleted list |
- | | ALT + * |bulleted list| | + | | ALT + * | bulleted list |
- | | ALT + m |code| | + | | ALT + m | code | |
+ | | CTRL+Q | ||
The short-cut keys for inserting headers were changed form ALT+n to CTRL+n on 8/30/2013 in order to avoid conflicts with keyboards that use AltGR. | The short-cut keys for inserting headers were changed form ALT+n to CTRL+n on 8/30/2013 in order to avoid conflicts with keyboards that use AltGR. | ||
Line 395: | Line 420: | ||
With this method, the user clicks in the browser and the Dokuwiki Editor opens, loading the section of the page beneath the mouse pointer, just as it would if the section edit button were clicked. | With this method, the user clicks in the browser and the Dokuwiki Editor opens, loading the section of the page beneath the mouse pointer, just as it would if the section edit button were clicked. | ||
- | You may initially have to clear both the browser cache and your Dokuwiki cache. See: [[devel: | + | You may initially have to clear both the browser cache and your Dokuwiki cache. See: [[devel: |
If you do not want this feature, you can turn it off in the Configuration Manager. | If you do not want this feature, you can turn it off in the Configuration Manager. | ||
==== Page Tools Method ==== | ==== Page Tools Method ==== | ||
- | There is a small plugin that gives immediate direct access to the Dokuwiki editor from the Dokuwiki template' | + | The [[plugin: |
- | tpl_toolsevent(' | + | |
- | + | ||
===== Dokuwiki Entities with left-hand angle brackets ===== | ===== Dokuwiki Entities with left-hand angle brackets ===== | ||
Line 466: | Line 491: | ||
'' | '' | ||
==== Using the farmer plugin ==== | ==== Using the farmer plugin ==== | ||
- | The [[plugin: | + | <del>The [[plugin: |
+ | </ | ||
+ | ckgdoku is no longer supported; its functionality has been integrated into ckgedit. | ||
===== Video Clips ===== | ===== Video Clips ===== | ||
You can view various demonstrations on YouTube of how to use ckgedit:\\ | You can view various demonstrations on YouTube of how to use ckgedit:\\ | ||
Line 502: | Line 529: | ||
[[plugin: | [[plugin: | ||
- Unwanted code replacement | - Unwanted code replacement | ||
- | - blank page while click "Broswe | + | - blank page while click "Browse |
- ckgedit for monobook and vector templates (skins) | - ckgedit for monobook and vector templates (skins) | ||
- Importing Documents | - Importing Documents |
plugin/ckgedit.txt · Last modified: 2023-07-27 16:01 by turnermm