PageBox: servlet running in sandbox on J2EE PageBox

Presentation FAQ Reference Customisation Runtime Forms Demo Math Verification Downloads Troubleshooting

Cuckoo Reference Guide


This document primarily targets Page Authors.

You will find here:

  1. How to use Cuckoo

  2. How to write Word documents for Cuckoo

Installation and use

  1. Open a Command window. Move to cuckoo_installation_dir\math\bin and run regsvr32 math.dll.

  2. Copy in your template directory.

  3. Start Word, open and select Tools | Macro | Visual Basic Editor. On the Visual Basic Editor, select Tools | References... Check the reference to the math dll:


You must also refer to Microsoft Scripting Runtime (WSH) and to Microsoft MSXML (3 or above) that you should have installed as written in the download page.

Create a new document using the cuckoo template.

You should see a toHTML button:

When you want to convert your document to HTML, click on the toHTML button. You should get this form:

Enter the full path of the file where you want to store your HTML document and of the Style directory file, then click save. Cuckoo starts the default browser to display the generated page.

The filename and style you entered are saved. The next time you click on the toHTML button, the filename and style fields are set with the former values. You just need to change them if needed.

The drive that you specify must exist and you must be able to write in the HTML document directory. Cuckoo creates the directory if it doesn't exist. You get warnings if the style sheets, cuckoo.xsl and cuckoo.css or if the Javascript file, cuckoo.js are not in the target directory. Then Cuckoo copies these files from the Style directory to the HTML document directory.





XSL file name


Used by MSXML to merge the converted document and the site file


CSS file name


Used to display the HTML page


JavaScript file


The delivered version only handles mouse overs


If you don’t set the File name, the HTML document has the same name as the Word document but with a .html extension. You don’t need to set the Style directory if cuckoo.xsl, cuckoo.css and cuckoo.js are already in the HTML document directory.

See the customization guide for a brief introduction of XSL and CSS and a description of the deliveries.

If you need to use names different of cuckoo.xsl, cuckoo.css and cuckoo.js , click on the Setting button. You should get this form:

You can set the XSL file name, the CSS file name and the JavaScript file. Those names are saved across Cuckoo sessions. You can switch the trace on or off. In that case a file log.txt is filled in the same directory as the XML and HTML file. You can also set different standard style names for Normal, Heading i , Comment Text and Title.

The latter feature is useful when you use a non-English version of Word and especially when you need to process an existing document. The screenshot above shows the appropriate setting for the French version of Word. In the same way the directory where images are saved (forImg_files in English, which is the default) can be set. In French the appropriate setting is forImg_fichiers (though a correct translation would be pourImg_fichiers.) To find the directory name for a given language create a Word document with an image, save this document as HTML and see in which directory the image is saved.

On the right side of the form you can define:

  • Table tags: the tags to use with <table>, <th> and <td>. Cuckoo supports two kinds of tables, standard tables and invisible tables (identified because you used an InvisibleTable style in Word).

  • Custom styles: you can define styles and the CSS class to use to render them in HTML.

The latter feature is useful when you use a non-Latin version of Word. In this case your Word styles cannot be used as CSS class name as it is made by default: a CSS class name must be an ASCII string.


Whatever modification you do except on the Custom Style mapping section, you must click on the Set button at the bottom to commit the change.

For Custom Style mapping:

  1. To add a custom style, enter the style name on the upper TextBox and click on the Add button

  2. To set the CSS class name, first select the style name with the ComboBox, then enter the class name on the lower TextBox and click on the Set button

  3. To delete a custom style, first select the style name with the ComboBox and then click on the Delete button.


  • You can define a custom style as an alias to a standard style. In that case specify the name you gave to this standard style. For instance if you mapped Heading 1 to Entete 1, specify Entete 1 in the CSS class name.

  • Except when you specify a standard style name in the CSS class name, don’t put blanks in the CSS class name and use ASCII characters only

  • If you don’t set CSS class name then the Normal style will be used


Tests with up to 550 headers and 2 MB files.

Cuckoo has been tested with:

  • MSXML 3 and MSXML 4

  • Internet Explorer 5.5 and 6

  • Mozilla 0.96 and Mozilla 1

  • Netscape 6.2

  • Netscape 4.77 and 4.79

  • Opera 5.11 (Mouse over only display characters)

  • Opera 6 (Mouse over only display characters)

  • Word 97 and 2000

  • IIS 5 for ASP pages

  • Tomcat 3.22 for JSP pages

  • PHP 4.06 for PHP pages

  • Tomcat 4.01/Cocoon 2.0

  • Resin 2.04

We better support IE 5, IE 6, Mozilla and Netscape 6.2 because their implementation of DOM is better.


Bullet and numbering

Cuckoo supports nested bullets and numbering as you can see in the Installation Verification below.

You can also define paragraphs at the same level as a bullet/numbering. However you must use Word [indent] and not tabs.

As a rule don’t use tabs and blanks with Cuckoo:

  • Cuckoo ignore tabs

  • HTML ignores blanks but the first one

Cuckoo identifies bullets and numbering but not the sort of bullet/numbering. It processes in the same way:

  • Square

  • Circle


  1. Alphabetic

  2. Numeric

You define the shape of your bullets in the CSS.


Use Edit|Paste Special... to paste you image in the Word document.

When you are displayed the form below uncheck Float over text.


With Word 97, images are in GIF format.

With Word 2000, images are in JPEG or GIF format.

You can also insert images with Insert|Picture|From File.


Inherited of English


HTML translation



Heading 1


Heading 2


Heading 3


Heading 4


Heading 5


Heading 6




Comment Text

In comments, doesn’t generate a class attribute

Other paragraph styles

<p class="paragraph_style"/>

Other character styles

<p class="paragraph_style"/> or

<font class="character_style"/>

If you use a non-English version of Word, your standard style names can be different. Then use the Setting macro described above to define a different mapping. Let's assume that your Heading 1 style is MyHeading1. On the Settings form you map MyHeading1 to Heading 1. Then when Cuckoo finds a MyHeading1 style, it will generate a <h1>...</h1>.

  1. Only style name matters: feel free to change style definition

  2. test-style and test-style2 are there to check the installation. They are processed just like any other paragraph style


HTML translation


<meta name="Description"/>


<meta name=" Keywords"/>


In tables only: to create <th> rather than <td>


In tables only: if the first paragraph of a table cell has this style then the table is rendered with cuckoo-itable style and the cells with cuckoo-itd style


<input type=submit/>


<input type=checkbox/>


<input type=checkbox checked/>


<select type=text/>


<input type=radio/>


<input type=radio checked/>


<input type=text/>


<hr />


The text is copied ditto in the generated XML document


<p class="test-style"/> or

<font class="test-style">


<p class="test-style2"/> or

<font class="test-style2">


<p class="test-style3"/> or

<font class="test-style3">

You cannot name a style Hyperlink, Bookmark or bookmark.


Cuckoo 0.1 and above support bookmarks.

You create and reference a bookmark for Cuckoo as you do normally in Word:

  • You create the bookmark with Insert | Bookmark...

  • You reference a bookmark with Insert | Hyperlink... and then with Place in this document


Cuckoo 0.1.1 and above support two kinds of hyperlinks:

  • Hyperlink in the same Window: <a href="..." target="_self">

  • Hyperlink in a new Window: <a href="..." target="_blank">


Cuckoo 0.2.2 support inserting XHTML tags in the document. When you click on the toHTML document the text of the paragraphs in Ditto style is copied ditto in the generated XML document.


Character styles are ignored in a paragraph in Ditto style

You must use Latin characters.

You must insert well-formed XHTML. For instance insert:

<img src="polaris1.jpg" alt="Show Polaris1 image" />

and not

<IMG SRC="polaris1.jpg" ALT="Show Polaris1 image">

It is better to write the XHTML using lower case characters but the most important is to close the tag (/> and not > here). It is easy to forget especially with <img> and <br>.

The last trap is Word auto correction. For instance, in an English document Word converts " in “. It doesn’t a big difference for the reader but it is enough to prevent the generation of the HTML document. Use Ditto only when you have no other solution, for instance:

  • To include a Web control, a JSP tag

  • To include an image hosted on another site

  • To include a mapped image

  • To include document-specific Javascript

In these cases, use Copy | Paste from the tool that you used to produce that code... and double-check auto correction.
2001-2004 Alexis Grandemange. Last modified .