Ignore:
Timestamp:
11/27/08 07:55:55 (3 years ago)
Author:
KennethLavrsen
Message:

Item295: Rebranding TinyMCEPlugin docs. Added the FAW doc that was in t.o. in an updated version
This info is so basic that it should be available locally.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/TinyMCEPlugin/data/System/TinyMCEPlugin.txt

    r878 r1004  
    1313The integration uses the Foswiki:Extensions.WysiwygPlugin to translate text to and from a format that !TinyMCE can edit. 
    1414 
    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. 
     15Unlike 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. 
    1616 
    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. 
     17The 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. 
    1818 
    1919---++ 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'. 
     20The 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'. 
    2121 
    2222---++ Installation Instructions 
    2323 
    2424__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. 
    2828 
    2929First follow the installation instructions to install the Plugin: 
     
    5050   relative_urls : false, 
    5151   remove_script_host : false, 
    52    setupcontent_callback : TWikiTiny.setUpContent, 
     52   setupcontent_callback : FoswikiTiny.setUpContent, 
    5353   urlconverter_callback : "TWikiTiny.convertLink", 
    5454   hide_instance_callback : TWikiTiny.switchToRaw, 
     
    106106%INCLUDE{"%SYSTEMWEB%.WysiwygPluginSettings"}% 
    107107 
    108 #InstallingOnOldTWikis 
    109 ---++ 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 
     110The topic TinyMCEFrequentlyAskedQuestions contains more help with things like: "How do I configure the buttons in my skin?", "How do I disable the WYSIWYG?" etc. 
    111111 
    112112---++ Plugin Info 
    113113 
    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! 
     114Another 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! 
    115115 
    116 |  Plugin Author(s): | TWiki:Main.CrawfordCurrie | 
     116|  Plugin Author(s): | Foswiki:Main.CrawfordCurrie | 
    117117|  Plugin Version: | 03 Aug 2008 %$VERSION% | 
    118118|  Copyright: | &copy; 2007-2008 Crawford Currie http://c-dot.co.uk | 
Note: See TracChangeset for help on using the changeset viewer.