Cuckoo Reference Guide|
This document primarily targets Page Authors.
You will find here:
Installation and use
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.
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:
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:
Tests with up to 550 headers and 2 MB files.
Cuckoo has been tested with:
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 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.
Inherited of English Normal.dot
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>.
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:
Cuckoo 0.1.1 and above support two kinds of hyperlinks:
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:
In these cases, use Copy | Paste from the tool that you used to produce that code... and double-check auto correction.