Do not be surprised because XMLmind XSL-FO Converter Evaluation Edition generates output containing random duplicate letters. Of course, this does not happen with Professional Edition!
Four command-line executables are provided: fo2rtf, fo2wml, fo2docx and fo2odt, to convert an XSL-FO file to RTF, WML, Open XML (.docx) and OpenDocument (.odt) respectively. The general syntax of a command line is:
fo2rtf [<options>] <input> [<output>]
where <input> is the input XSL-FO file name and <output> the output file name. If no output file is specified the conversion output is written to the standard output stream. Options are specified as:
-<name>=<value>
where <name> is the option name and <value> the option value. Option names and values are described below.
Commonly used options:
Specifies the output encoding. Supported values depend on the target output format:
For RTF output, supported values are ASCII, Cp1250 (Windows Eastern European), Cp1251 (Windows Cyrillic) and Cp1252 (Windows Latin-1). The default value is Cp1252 (Windows Latin-1).
For WML output, all encodings available in the current JVM are supported. The option value may be either the encoding name (e.g. ISO8859_1) or the charset name (e.g. ISO-8859-1). The default value is Cp1252 (Windows Latin-1).
For Open XML output (.docx), this option specifies the encoding of XML content in the output document. Supported values are UTF-8 and UTF-16. The default value is UTF-8.
For OpenDocument output (.odt), this option specifies the encoding of XML content (files styles.xml and content.xml) in the output document. All encodings available in the current JVM are supported. The option value may be either the encoding name (e.g. ISO8859_1) or the charset name (e.g. ISO-8859-1). The default value is UTF8.
Default image resolution in DPI. A positive integer. Used to compute the intrinsic size of an image, but only when an image file does not contain resolution or absolute size information.
Default value: 96.
Image scaling policy. true or false. Default: false.
Specify prescaleImages=true to minimize output document size. By default (prescaleImages=false), the original size of images is preserved and scaling directives are inserted in the output document.
Note that:
Property prescaleImages=true will never create an image which has larger dimensions than the original image. It can only create an image which has smaller dimensions than the original image.
Property prescaleImages=true is honored only for true raster graphics. Vector graphics (WMF, EMF) are never prescaled. Pre-rasterized vector graphics (SVG, MathML) are always prescaled (by the competent renderer, e.g. Batik or JEuclid, not by XMLmind XSL-FO Converter itself).
May be used to map the generic font families serif, sans-serif, monospace, fantasy and cursive to actual font families.
Syntax:
map -> entry [',' entry]*
entry -> generic_family '=' actual_family
generic_family -> 'serif' | 'sans-serif' | 'monospace'
| 'cursive' | 'fantasy'Example: "-genericFontFamilies=fantasy=Impact,cursive=Comic Sans MS".
The default mapping depends on the output format: the generic font families serif, sans-serif, monospace are mapped to "Times New Roman", Arial, "Courier New" for RTF, WML and Open XML (.docx) and to "DejaVu Serif", "DejaVu Sans", "DejaVu Sans Mono" for OpenDocument (.odt).
Note that by default, generic font families fantasy and cursive are not mapped.
Arial Unicode MS"Font family "Arial Unicode MS" is often used to render east asian (CJK) text. However, this typeface has no bold, italic and bold+italic fonts. That why specifying "sans-serif=Arial Unicode MS" is equivalent to specifying "sans-serif=Arial", except that some special instructions will be inserted in the output file to specify that typeface Arial is to be used to render western text and "Arial Unicode MS" is to used to render east asian text.
This specificity is supported by the ODT, WML and DOCX output formats, but not by the RTF output format.
graphic_factory_name.parameter_nameSets parameter parameter_name on graphic factory called graphic_factory_name (case-insensitive). A graphic factory is a software component in charge of processing one or more graphic formats. Examples of such graphic factories: ImageIO, WMF, EMF, SVG, MathML. Only few graphic factories may be parameterized this way.
graphic_factory_name | parameter_name | Value | Default | Description |
|---|---|---|---|---|
SVG | resolution | Dot Per Inch (DPI), positive integer | 192 | Resolution used to convert SVG vector graphics to PNG raster images. |
MathML | resolution | Dot Per Inch (DPI), positive integer | 288 | Resolution used to convert MathML equations (may be seen as vector graphics) to PNG raster images. |
mathsize | Point (pt), positive integer | 12 | The base font size of MathML equations. |
Examples:
-set.svg.resolution=300 -set.MathML.mathsize=11 -set.mathml.resolution=300
Specifies single-sided page layout. By default RTF, WML and Open XML (.docx) output documents are given a double-sided page layout regardless of the input document properties. This option may be set to true to force a single-sided page layout.
Specifies the location of an XML file containing the set of user styles to be used during the conversion. More information about user styles in "XSL-FO extension for generating named styles".
This location is an URL in its string form (e.g. "file:///C:/My%20Folder/styles.xfc") or a filename (e.g. "C:\My Folder\styles.xfc"). A relative filename is relative to the current working directory.
The XML file must conform to the styles.xsd schema.
By default, XMLmind XSL-FO Converter generates only direct formatting (RTF, WordprocessingML, .docx) or automatic styles (.odt).
Rarely used options:
Default image resolution in DPI. A positive integer. Used to compute the intrinsic size of an image, according to the image renderer (that is, MS-Word or OpenOffice), when an image file does not contain resolution or absolute size information.
The default value depends on the output format. Generally 96. It is strongly recommended to use this default value.
Screen resolution in DPI. A positive integer. Used to convert px lengths to other units (in, mm, cm, pt, etc).
Default value: 96.
Specifies the base URL of relative paths in attribute values (typically the src attribute of the external-graphic element). By default, paths are taken relative to the input source URL.
Specifies the target RTF viewer. Currently the only supported value is MSWord. This option may be needed to circumvent an obscure bug in the RTF loader of MS-Word, which does not handle table cell padding tags correctly. When this option is set to MSWord, XFC will swap top and left padding values in table cells to work around this bug.
Boolean (false or true) specifying whether images contained in Office Open XML (.docx) files should be represented using the deprecated VML markup rather than the DrawingML markup.
Default: false.
Boolean (false or true) specifying whether JPEG images should be transcoded to PNG. If true, do not attempt to save JPEG images as JPEG files in the output file. Instead always transcode JPEG images to PNG.
Default: false.