Changeset 1004 for trunk/TinyMCEPlugin/data/System/TinyMCEPlugin.txt
- Timestamp:
- 11/27/08 07:55:55 (3 years ago)
- File:
-
- 1 edited
-
trunk/TinyMCEPlugin/data/System/TinyMCEPlugin.txt (modified) (3 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/TinyMCEPlugin/data/System/TinyMCEPlugin.txt
r878 r1004 13 13 The integration uses the Foswiki:Extensions.WysiwygPlugin to translate text to and from a format that !TinyMCE can edit. 14 14 15 Unlike the other editor integrations in TWiki, which install "Word in a Browser" style editors, this plugin is able to swap out the _standard_ text areas in an edit and replace them with WYSIWYG editors. This means you get WYSIWYG editors for textareas in forms, as well as for the main text of the topic. It can also co-exist alongside other WYSIWYG editors, such as Kupu.15 Unlike the other editor integrations in Foswiki, which install "Word in a Browser" style editors, this plugin is able to swap out the _standard_ text areas in an edit and replace them with WYSIWYG editors. This means you get WYSIWYG editors for textareas in forms, as well as for the main text of the topic. It can also co-exist alongside other WYSIWYG editors, such as Kupu. 16 16 17 The editor automatically "switches itself off" (i.e. reverts to the old text-only window) when editing topics that contain TWiki content it can't handle, such as complex macros.17 The editor automatically "switches itself off" (i.e. reverts to the old text-only window) when editing topics that contain Foswiki content it can't handle, such as complex macros. 18 18 19 19 ---++ Editor Notes 20 The editor uses a translator module to convert from TWiki markup language (TML) to HTML and back. The translator converts special macros - such as %<nop>MACROS% - to plain text, and encloses them within HTML spans using a special style called =WYSIWYG_PROTECTED=. In this way the editor can detect text that is not meant to be HTML formatted. This style is _also_ used to protect special text you enter into the editor from being interpreted when the topic is translated back into TML. If you want to add any special features that are sensitive to formatting, such as =Set= statements, then you have to format those regions using 'Protect on save' or 'Protect forever'.20 The editor uses a translator module to convert from Foswiki Topic Markup Language (TML) to HTML and back. The translator converts special macros - such as %<nop>MACROS% - to plain text, and encloses them within HTML spans using a special style called =WYSIWYG_PROTECTED=. In this way the editor can detect text that is not meant to be HTML formatted. This style is _also_ used to protect special text you enter into the editor from being interpreted when the topic is translated back into TML. If you want to add any special features that are sensitive to formatting, such as =Set= statements, then you have to format those regions using 'Protect on save' or 'Protect forever'. 21 21 22 22 ---++ Installation Instructions 23 23 24 24 __NOTES:__ 25 * This plugin comes pre-installed on TWiki 4.2.X. You should only need to re-install if there is an upgrade to the plugin.26 * It requires the very latest revision of WysiwygPlugin. It will *not* work with the version shipped with TWiki 4.1.2.27 * When installed, it *replaces* the old "textarea" editor. If you want to maintain access to the old editor from the standard screens, follow the instructions under [[#InstallingOnOldTWikis][Configuring the buttons on TWiki < 4.2.0]].25 * This plugin comes pre-installed on Foswiki. You should only need to re-install if there is an upgrade to the plugin. 26 * It requires the very latest revision of WysiwygPlugin. 27 * When installed, it *replaces* the old "textarea" editor. The default Foswiki skin provides access to the plain text editor by adding a Raw Edit link at the bottom of the page. 28 28 29 29 First follow the installation instructions to install the Plugin: … … 50 50 relative_urls : false, 51 51 remove_script_host : false, 52 setupcontent_callback : TWikiTiny.setUpContent,52 setupcontent_callback : FoswikiTiny.setUpContent, 53 53 urlconverter_callback : "TWikiTiny.convertLink", 54 54 hide_instance_callback : TWikiTiny.switchToRaw, … … 106 106 %INCLUDE{"%SYSTEMWEB%.WysiwygPluginSettings"}% 107 107 108 #InstallingOnOldTWikis109 ---++ Configuring the buttons on TWiki < 4.2.0 110 When installed on TWiki versions before 4.2.0, this plugin *replaces* the old textarea editor with the !TinyMCE editor. The shock of this change can be too much for some older contributors, so we have written instructions for reconfiguring your templates in Foswiki:Extensions.TinyMCEFrequentlyAskedQuestions.108 ---++ Frequently Asked Questions 109 110 The topic TinyMCEFrequentlyAskedQuestions contains more help with things like: "How do I configure the buttons in my skin?", "How do I disable the WYSIWYG?" etc. 111 111 112 112 ---++ Plugin Info 113 113 114 Another great TWiki extension from the <a style="text-decoration:none" href="http://wikiring.com"><img src="%ATTACHURLPATH%/wikiringlogo20x20.png" alt="" /> *WikiRing* </a> - working together to improve your wiki experience!114 Another great Foswiki extension from the <a style="text-decoration:none" href="http://wikiring.com"><img src="%ATTACHURLPATH%/wikiringlogo20x20.png" alt="" /> *WikiRing* </a> - working together to improve your wiki experience! 115 115 116 | Plugin Author(s): | TWiki:Main.CrawfordCurrie |116 | Plugin Author(s): | Foswiki:Main.CrawfordCurrie | 117 117 | Plugin Version: | 03 Aug 2008 %$VERSION% | 118 118 | Copyright: | © 2007-2008 Crawford Currie http://c-dot.co.uk |
Note: See TracChangeset
for help on using the changeset viewer.
