downCast 1.8

User Manual and Reference

Christian Roth

infinity-loop GmbH

Information in this document is subject to change without any prior notice. The software described in this document is furnished under a license agreement. The software may be used or copied only in accordance with the terms of the license agreement.

All product names identified throughout this document are trademarks or registered trademarks of their respective owners.

No part of this publication may be reproduced in any form or distributed in any form by any means, in whole or in part, without the prior written permission of infinity-loop GmbH.

Changed content (compared to the previous release) is marked with a beige sidebar on the right.

New content (compared to the previous release) is marked with a green sidebar.

Revision History
Revision 12003-04-09cr
initial version
Revision 22003-04-27cr
changes for RC1
Revision 32003-08-11cr
changes for downCast 1.0.0 (Builds 23) and later: WordLink, RTF to DOC
Revision 42003-10-19cr
changes for downCast 1.0.2
Revision 52003-11-16cr
updated for custom encodings and use of stdfonts.config
Revision 62004-03-07cr
updated for version 1.5 release
Revision 72004-06-23cr
version 1.5.1 release - no changes
Revision 82004-07-28cr
version 1.5.2 release - no changes
Revision 92004-08-19cr
version 1.5.3 release: added -ilx-following-style property description
Revision 102004-09-21cr
property descriptions added and updated
Revision 102004-09-22cr
updated for downCast 1.5.4: Commandline interface, whitespace handlers, global parameters
Revision 112005-05-12cr
updated for downCast 1.6: API error handling, updated CSS property listing
Revision 122005-06-30cr
updated for downCast 1.6.2: updated for stdfonts.config, -ilx-style-update
Revision 132005-11-01cr
updated for downCast 1.7.0
Revision 142008-04-04cr
no changes for downCast 1.8

Table of Contents

I. downCast Manual
1. Product Overview
1. Features
2. Architecture
2. Getting started
1. Installation
1.1. Windows 95/98/2000/NT/XP
1.2. Mac OS X
1.3. Unix/Linux/Solaris
2. Running the application
2.1. Windows 95/98/2000/NT/XP
2.2. Mac OS X
2.3. Unix/Linux/Solaris
3. Supplying a License file
3.1. Importing a license
3.2. File based licensing
3.3. JAR based licensing
3. Using downCast
1. Basic operations
1.1. Choosing the source file
1.2. Choosing an XSLT processing sheet
1.3. Choosing the destination folder
1.4. Generating Word binary (.doc) files
1.5. Setting the default image resolution
1.6. Setting the Whitespace Handler
1.7. The conversion process
1.8. Aborting a running conversion
2. Working with Configurations
2.1. What is a configuration?
2.2. Saving a configuration
2.3. Opening a configuration
2.4. A special configuration: preferences.plist
3. Logging
4. WordLink
5. Magic Folders and Locations
4. XML Document Contents
1. Grammar: The upCast DTD
2. Including a CSS Stylesheet
3. Parts, Sections, Headings and Paragraphs
3.1. Styling a part
3.2. Styling a heading
4. Fields
5. Table of Contents
6. Tabulators
7. Lists
8. Tables
9. Page Headers and Footers
10. References
11. Hyperlinks
5. Stylesheet Contents
1. @charset declaration
2. Specifying page sizes
3. Selectors
4. Paragraph and Character Styles
5. @media rules
6. Contents Language: xml:lang
6. Menu Reference
1. File
2. Extras
3. Help
7. Configuration File Format Reference
1. General format description
8. Stylesheet Property Reference
1. CSS2 properties
1.1. font-family
1.2. font-size
1.3. color
1.4. border-top-width, border-right-width, border-bottom-width, border-left-width
1.5. border-top-color, border-right-color, border-bottom-color, border-left-color
1.6. border-top-style, border-right-style, border-bottom-style, border-left-style
1.7. text-align
1.8. text-indent
1.9. list-style-type
1.10. width, height
1.11. margin-left, margin-top, margin-right, margin-bottom
1.12. padding-left, padding-top, padding-right, padding-bottom
1.13. text-decoration
1.14. text-underline-style
1.15. text-underline-mode
1.16. text-underline-color
1.17. text-line-through-style
1.18. font-variant
1.19. font-weight
1.20. text-transform
1.21. line-height
1.22. vertical-align
1.23. font-style
1.24. background-color
1.25. widows, orphans
1.26. page-break-inside, page-break-after
1.27. page-break-before
1.28. page
1.29. word-break-inside
1.30. border-spacing
1.31. letter-spacing
1.32. float
1.33. position
1.34. top, left, right, bottom
1.35. z-index
1.36. clear
1.37. -ilx-column-count
1.38. -ilx-column-width
1.39. -ilx-column-gap
1.40. -ilx-column-rule
1.41. display
1.42. table-layout
2. Custom Properties
2.1. -ilx-list-group, -ilx-list-level
2.2. -ilx-marker-format
2.3. -ilx-marker-offset
2.4. -ilx-marker-align
2.5. -ilx-marker-follow
2.6. -ilx-marker-font-family
2.7. -ilx-marker-font-size
2.8. -ilx-header-offset, -ilx-footer-offset
2.9. -ilx-paragraph-outline-level
2.10. -ilx-reference-presentation-type
2.11. -ilx-default-font-family
2.12. -ilx-footnote-style-type, -ilx-endnote-style-type
2.13. -ilx-footnote-numbering-policy, -ilx-endnote-numbering-policy
2.14. -ilx-footnote-position, -ilx-endnote-position
2.15. -ilx-tab-stops
2.16. -ilx-image-source
2.17. -ilx-wrap-distance-horizontal, -ilx-wrap-distance-vertical
2.18. -ilx-list-numbering-absolute
2.19. -ilx-gutter
2.20. -ilx-facing-pages
2.21. -ilx-mirror-margins
2.22. -ilx-editing-rights
2.23. -ilx-footnote-marker
2.24. -ilx-following-style
2.25. -ilx-style-update
2.26. -ilx-page-numbering-start
2.27. -ilx-page-numbering-mode
2.28. -ilx-page-numbering-style
2.29. -ilx-text-visibility
9. downCast API Reference
1. Concepts
2. Using the API
3. General programming steps
3.1. Setup
3.2. The DowncastEngine object
3.3. Converting a document
3.4. Setting global parameters
4. Method reference
5. Global Parameters reference
6. Error Handling
6.1. Coding pattern
6.2. Tidbits
10. downCast Commandline Interface
1. Reference
2. Example
3. Commandfile syntax
11. Technical Details
12. upCast DTD
13. Support file formats
1. stdfonts.config
1.1. Properties and Values
1.2. Options
1.3. File structure
1.4. Matching Algorithm
2. Custom Encodings
2.1. How it works
2.2. Associating a Font with an Encoding
2.3. File format
3. base.css
4. XML Catalog
4.1. downCast Catalog support
4.2. How-To: Adding new local DTDs
A. System Requirements
1. General
2. Windows 95/98/2000/NT/XP
3. Mac OS X
4. Unix/Linux/Solaris
B. Technical Support
C. Copyright, Licenses, Legal, Acknowledgements