EditLive! FAQ

1. How do I customize the hyperlink dialog in EditLive!?
2. How do I customize the image dialog in EditLive!?
3. Are there any patches/fixes required to the EditLive! software to comply with the Daylight Saving Time changes in March 2007?
4. Does EditLive! support Firefox browser on Windows, Linux and Mac Operating system?
5. How does EditLive! generate XHTML?
6. A user is having spell checker problems?
7. How can I disable/enable the spell checker?
8. Can menu titles be translated in different languages?
9. Are ‘bmp’ local image types supported?
10. Why do Japanese characters show square boxes?
11. The editor creates a <BR> instead of a <P>?
12. Why is #38 being added after the ampersand when adding hyperlinks with url variables?
13. When I copy and past from MS-Word to EditLive! I get a question mark?
14. What is the difference between EditLive! and EditLive! for XML?
15. How do I generate a console log in the EditLive! Swing SDK edition?
16. Is it possible to change the background color of the menu and tool bars?
17. How do I add license details in EditLive! using  the Configuration Tool?
18. How do I remove the Ephox logo and the ‘About’ menu item?
19. How do I install EditLive! on a Mac?

You may also find answers to your questions by searching our developer documentation. Enter your key words into the box at the top right-hand corner of any page.

For licensing issues please see our Licensing FAQ.

Does EditLive! support Firefox browser on Windows, Linux and MAC Operating system s?

EditLive! supports Firefox on Windows, Mac, Linux etc with Firefox 1.5 and above with any JRE above 1.4.  On Windows, Editlive! also supports Firefox 1.0 with JRE version 1.4.2_07.  The release of EditLive! where this support has become official is EditLive! 5.0.5.

^top

How does EditLive! generate XHTML?

We generate XHTML output by setting the outputXhtml tag to ‘true' in the configuration file. To ensure EditLive! provides valid XHTML content where required, ensure that allowUnknowntags  is set to 'false' and outputXHTML is set to true in the htmlFilter tag.

^top

A user is having spellchecker problems?

The user might be downloading the spell checker jar with the configuration setting "useNotModified" attribute set to "false" in spell check tag in configuration XML file as seen in the log file. The error "An error occurred while downloading the spell checking component. Spell checking will be unavailable" is there because your user needs to set the "useNotModified" to true to allow the downloading spelling jar file.

The problem might be related to your "jar" file path specified in the configuration file. The path might be pointing to the wrong location. The jar exists at that URL relative to where the page with the editor lies (ie: if the page with the editor is at http://localhost/ then the 'jar' path should be set to 'redistributables/editlivejava/dictionaries/...'. Assuming you have the base Editlive! directory (web folder) mapped to http://localhost/.)

Setting the proper url to download the jar may resolve the issue.

^top

How can I disable/enable the spell checker?

You need to use the EditorCommandHandler class to use the braodcastEditorEvent (TextEvent) event to enable or disable the button operation. You need to call an action TextEvent.BACKGROUND_SPELL_CHECKING. This will emulates what pressing the button does.

e.g.:

Assuming your EditorCommandHandler object is called edCommand

edCommand.broadcastEditorEvent (new TextEvent(this, TextEvent.BACKGROUND_SPELL_CHECKING, null, 0));

This will toggle your editor depending on your editor current setting.

^top

Can menu titles be translated into a different language?

Currently we do not provide such a feature.

EditLive! supports a full range of international character sets.

EditLive! is also provided with interface translations and international spell checking dictionaries in the editor.

^top

Does EditLive! support bmp local image file types?

We don't support bmp images right now.

Currently we support image files that have the extensions jpg, jpeg, tiff, png, gif.

We are also support the other file types such as Macromedia Flash (.swf) and Apple Quick Time (.mov).

^top

Why do Japanese characters show square boxes?

By default EditLive! will use ASCII as the document character set.

If you wish to use a character set other than ASCII (e.g. SJIS or UTF8) you will need to set it in the XML configuration file.

If you are using a Japanese system then everything should render correctly. If you are using an English system with a Japanese IME and JRE 1.4.x then you will need to explicitly set the font in the editor to one that supports the characters you require. Alternately JRE 1.5 includes support for font fallback which will automatically detect the correct font to use and won't require explicitly setting the font. We generally recommend installing either JRE 1.5 or using a native system as they solve most rendering issues.

^top

The editor creates a <BR> tag rather than a <P> tag.

You have set 'encloseText' to false.

When encloseText is set to false it will insert BR tags into the body instead of P tags. If you want to insert P tags instead then you should set encloseText to 'true'.

^top

Why is a #38 being added after the ampersand (&) when adding hyperlinks with url variables?

It is related to either the outputXHTML or outputXML attributes of the htmlFilter element in the configuration file being set to 'true'. In that case ampersands and other entities will be escaped to make them XML compliant.

If you do not wish to escape entities set both of these attributes to 'false'.

^top

When I copy and paste from MS-Word I get a question mark?

This happens when you are trying to copy from ISO8519-1 or any other non-UTF type to UTF-8. EditLive! supports only UTF-8 for copy and pasting.

The problem can be resolved by setting the document character set to UTF-8 instead of ISO-8859-1 or any other non-UTF document character set.

You will have to set your wordImport to clean mode for copying the data from MS Word to EditLive!

^top

What is the difference between EditLive! and EditLive! for XML? 

On a base level, the main difference between EditLive! and EditLive! for XML is the type of content they edit. EditLive! allows users to create HTML within a field on a web based form, whereas EditLive! for XML enables users to create XML within a web-application.

With respect to the differences in the interface, EditLive! provides a rich-text editing field and the editable content in the editor is the HTML document. With EditLive! for XML, this technology is used as a replacement for a HTML Web form. EditLive! for XML includes the full-rich text editing capabilities of EditLive! and also enables other form fields such as text and date fields to be embedded in the document. This provides more of a form-based interface which allows for validation of data against constraints defined in a schema. EditLive! for XML is also packaged with templating to allow developers to create document and form templates using industry standard views and schemas. As the content produced by EditLive! for XML is standard XML, this product is recommended for applications which are XML-enabled.

^top

How do I generate a Java console log in the EditLive! Swing SDK edition?

Set the following properties in you application before instantiating the EditLive! Swing object.

System.setProperty("org.apache.commons.logging.Log", "org.apache.commons.logging.impl.SimpleLog");
System.setProperty("org.apache.commons.logging.simplelog.log.httpclient.wire", "debug");
System.setProperty("org.apache.commons.logging.simplelog.log.org", "info");
System.setProperty("org.apache.commons.logging.simplelog.log.com.ephox.editlive", "debug");
System.setProperty("org.apache.commons.logging.simplelog.log.org.w3c", "info");
System.setProperty("org.apache.commons.logging.simplelog.log.com.
ephox.editlive.java2.editor.xml.ElementNFA", "debug");

System.err.println(System.getProperty("java.version"));
System.err.println(System.getProperty("java.vm.vendor"));

^top

Is it possible to change the button colors of the menu and toolbars? 

Within the 'wysiwygEditor' tag of the XML configuration there is an attribute you can set to determine a background color called 'interfacebgcolor' which takes a hexadecimals style color as its value. (e.g. #FFFFFF).

However, it is recommended that you avoid changing the background color as this interferes with the system's Look and Feel, and may also have unpredictable results.

^top

How do I add licensing details to the configuration file? 

To register EditLive! within your application you will need to:

1. Save the attached license file to your web server.
2. Open the EditLive! Configuration Tool. The EditLive! Configuration Tool.
3. Add the EditLive! License File to your EditLive! XML configuration file.

To add EditLive! License File:

1. On the File menu, click Open.
2. Browse to your XML configuration file and open it.
3. Click on the Licenses tab.
4. Click Import License From File.
5. In the Open License File dialog, select the .lic EditLive! License file you would like to add.
6. Click OK.
7. Add the number of licensed seats
8. Save the XML file.

^top

How do I remove the Ephox logo and the 'About' menu item?

The Ephox logo and associated About dialog may be removed from the menu interface. The removal of this menu option is achieved through setting the showAboutMenu attribute of the <menuBar> element to false.

For example, the following XML would remove the Ephox branding and associated About dialog from the menu:

<editLive>

...

<menuBar showAboutMenu="false">

...

</menuBar>

...

</editLive>

^top

How do I install EditLive! on a Mac?

To integrate EditLive! into your website you will need to install the redistributable files on your webserver. EditLive! will automatically install the first time that the editor is accessed from the Mac.

More integration instructions

^top