XMLmind XSL-FO Converter - User©s Guide Jean-Yves Belmonte Hussein Shafie XMLmind Software <[email protected]> XMLmind XSL-FO Converter - User©s Guide Jean-Yves Belmonte Hussein Sha®e XMLmind Software <[email protected]> Publication date February 23, 2021 Abstract This guide describes how to install the XMLmind XSL-FO Converter engine and use its command-line executables. It also explains how to integrate this software component into your application. Table of Contents 1. Introduction ............................................................................................................................ 1 2. Installing XMLmind XSL-FO Converter ................................................................................... 2 1. System requirements ........................................................................................................ 2 2. Installation ...................................................................................................................... 2 3. Contents of the installation directory ................................................................................. 2 3. Command-line executables ....................................................................................................... 4 4. Integrating XMLmind XSL-FO Converter into your application ................................................. 8 1. Compiling and running the code samples .......................................................................... 8 2. Converting an XSL-FO ®le to RTF ................................................................................... 8 3. Converting an XML document to RTF .............................................................................. 9 4. Implementing a custom IGraphicFactory and registering it with XMLmind XSL-FO Converter .......................................................................................................................... 10 5. Support of the XSL-FO v1.0 standard ..................................................................................... 14 1. Features ........................................................................................................................ 14 2. Limitations .................................................................................................................... 16 3. Conformance statement .................................................................................................. 16 4. Implementation speci®cities ........................................................................................... 28 4.1. Page references ................................................................................................... 28 4.1.1. RTF/WML/OOXML ................................................................................ 28 4.1.2. OpenDocument ........................................................................................ 28 4.2. Lists ................................................................................................................... 28 4.2.1. The xfc:label-format extension attribute ............................................... 28 4.3. Leaders .............................................................................................................. 30 4.4. Other extension attributes .................................................................................... 31 4.4.1. The xfc:outline-level extension attribute .............................................. 31 4.4.2. The xfc:render-as-table extension attribute .......................................... 31 4.5. Special uses of fo:block-container .................................................................. 32 4.5.1. Using fo:block-container to temporarily switch the page orientation from portrait to landscape .................................................................................. 32 4.5.2. Using fo:block-container to rotate the content of a table cell .................. 33 4.6. Adding language information to the documents created by XFC ............................ 34 4.7. Adding metadata to the documents created by XFC .............................................. 35 4.7.1. Standard metadata .................................................................................... 35 4.7.2. Custom metadata ...................................................................................... 39 4.8. Restricting editing in the documents created by XFC ............................................ 39 4.9. Special characters ............................................................................................... 40 4.10. Special support for East Asian fonts ................................................................... 40 4.11. Multiple page layouts ........................................................................................ 41 4.12. Adding a watermark to the generated document .................................................. 42 4.13. Expressions ...................................................................................................... 42 6. XSL-FO extension for generating named styles ....................................................................... 43 1. Why generate named styles? ........................................................................................... 43 2. How it works ................................................................................................................. 43 2.1. Putting named styles to work ............................................................................... 43 2.2. The effect of the xfc:user-style extension attribute on an XSL-FO element ........ 44 3. Style reference ............................................................................................................... 45 3.1. The styles element ............................................................................................ 46 3.2. The text-style element ..................................................................................... 46 3.3. The paragraph-style element ........................................................................... 47 3.4. The numbering element ...................................................................................... 49 iii XMLmind XSL-FO Converter - User©s Guide 3.5. The xfc:user-style extension attribute .............................................................. 51 3.6. The xfc:restart-numbering extension attribute ................................................. 51 4. A comprehensive example .............................................................................................. 54 5. Adding named styles support to an existing XSLT stylesheet ............................................ 55 6. Troubleshooting ............................................................................................................. 56 7. XSL-FO extension for Of®ce Open XML ............................................................................... 58 1. Introductory example ..................................................................................................... 58 2. How it works ................................................................................................................. 61 2.1. Text ®eld example ............................................................................................... 61 2.2. Drop-down list example ...................................................................................... 62 2.3. Specifying a Custom XML Data template ............................................................. 63 2.4. Extracting the Custom XML Data part ................................................................. 63 3. Reference Material ........................................................................................................ 63 3.1. Generic attributes ................................................................................................ 64 3.2. sdt:text-®eld ....................................................................................................... 65 3.3. sdt:drop-down-list ............................................................................................... 65 3.4. sdt:list-entry ....................................................................................................... 66 3.5. sdt:combo-box .................................................................................................... 67 3.6. sdt:date .............................................................................................................. 67 3.7. sdt:picture .......................................................................................................... 69 3.8. sdt:image-data .................................................................................................... 69 3.9. sdt:con®guration ................................................................................................. 70 iv List of Figures 6.1. The style editor of MS-Word 2007 ....................................................................................... 44 7.1. Text ®eld (initial display) .................................................................................................... 61 7.2. Text ®eld (selected) ............................................................................................................. 61 7.3. Text ®eld (®lled) ................................................................................................................