Upgrading to EditLive! for Java 3.5

August 2004

Upgrading the EditLive! for Java Source

In order to update to EditLive! for Java 3.5 the new EditLive! for Java redistributables must be placed on the relevant Web server.  These files can be found in the INSTALL_HOME/webfolder/redistributables directory of the EditLive! for Java 3.5 SDK, where INSTALL_HOME represents the location of the EditLive! for Java 3.5 SDK install.

These files can be used to replace the existing EditLive! for Java 3.0 files.  

Note:  EditLive! for Java 3.5 is not compatible with the spell checker dictionaries used with previous versions of EditLive! for Java .  The next section of this document details how to upgrade the spell checker dictionaries for EditLive! for Java.

Updating the Spell Checker Dictionaries

The spell checker dictionaries used with EditLive! for Java can be found in the INSTALL_HOME/webfolder/redistributables/editlivejava/dictionaries folder of the EditLive! for Java install, where INSTALL_HOME represents the location of the EditLive! for Java SDK install.  The spell checker dictionaries for EditLive! for Java contain the relevant version number within their file name.  Thus the US English spell checker dictionary for EditLive! for Java 3.0 is named en_us_3_0.jar whereas the equivalent EditLive! for Java 3.5 spell checker dictionary is named en_us_3_5.jar.  

In order to update the spell checkers for use with EditLive! for Java 3.5 the relevant files from the INSTALL_HOME/webfolder/redistributables/editlivejava/dictionaries must be placed in the same location as those for use on the live Web site with EditLive! for Java. Also, the EditLive! for Java configuration file must be changed to reflect the change in file name which has occurred.  This is done by changing the jar attribute of the <spellCheck> element to reflect the new file name.  The example below shows the <spellCheck> element from an EditLive! for Java 3.0 configuration file and then an EditLive! for Java 3.5 configuration file:

EditLive! for Java 3.0:

<spellCheck jar="../../editlivejava/dictionaries/en_us_3_0.jar" />

EditLive! for Java 3.5:

<spellCheck jar="../../editlivejava/dictionaries/en_us_3_5.jar">

Updating Toolbar Configuration

EditLive! for Java 3.5 introduces new flexibility in the configuration of toolbars.  Developers can now add an unlimited number of toolbars to the EditLive! for Java interface and can also customize the user interface for existing toolbar commands.  For more information on how to take advantage of the new toolbar customizations please see the article titled Customizing the EditLive! for Java Interface in the EditLive! for Java 3.5 SDK.

Note:  EditLive! for Java 3.5 will continue to function with configuration files which implement the previous means of configuring the toolbars.

Fully Customizable Menu and Toolbar Items

EditLive! for Java 3.5 allows developers to fully customize existing menu and toolbar items.  Developers can provide custom images, menu or tooltip text and mnemonics for any existing interface command.  This is achieved through the use of new text, imageURL and mnemonic attributes for the <menuItem> and <toolbarButton> elements.  An example of how the New menu item from the File menu can be customized is shown below:

...
<menuBar>
    ...
    <menu name="&ampFile">
        <menuItem
            name="New"
            text="Create New"
            imageURL="http://server/customImage.gif"
            mnemonic="C"
        />
    </menu>
    ...
</menuBar>
...

For more information see the article titled Customizing the EditLive! for Java Interface in the EditLive! for Java 3.5 SDK.

New HTML Filter Options

EditLive! for Java 3.5 includes new HTML filter options.  These options can be set via attributes (as named below) in the <htmlFilter> element in the EditLive! for Java configuration file.

  • encloseText - If set to true content will be automatically be wrapped with paragraph (<p>) tags if it has not been properly enclosed with block tags. This is done to ensure that the content inside EditLive! for Java is valid.
  • allowUnknownTags - If set to true tags not recognized in HTML or XHTML will be interpreted as custom tags inside EditLive! for Java.  This will preserve the unknown tags.  When set to false unknown tags will be HTML encoded e.g. "<unknownTag>" will be converted to "&lt;unknownTag&gt;"