Cuckoo Reference Guide
|Table of content|
This document primarily targets Page Authors.
You will find here:
How to use Cuckoo
How to write Word documents for Cuckoo
Open a Command window. Move to cuckoo_installation_dir\math\bin and run regsvr32 math.dll.
Copy cuckoo.dot in your template directory.
Start Word, open cuckoo.dot 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.
XSL file name
Used by MSXML to merge the converted document and the site file
CSS file name
Used to display the HTML page
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:
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:
To add a custom style, enter the style name on the upper TextBox and click on the Add button
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
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 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
We better support IE 5, IE 6, Mozilla and Netscape 6.2 because their implementation of DOM is better.
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:
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.
In comments, doesn’t generate a class attribute
Other paragraph styles
Other character styles
<p class="paragraph_style"/> or
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>.
Only style name matters: feel free to change style definition
test-style and test-style2 are there to check the installation. They are processed just like any other paragraph style
<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=checkbox checked/>
<input type=radio checked/>
The text is copied ditto in the generated XML document
<p class="test-style"/> or
<p class="test-style2"/> or
<p class="test-style3"/> or
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" />
<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
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 .