CALS to Formex 4 converter¶
Description¶
The convert_cals2formex()
converter is a function designed to convert tables from an CALS document (which respects the schema defined in CALS table format) in the Formex 4 format.
The conversion is done in the source XML document by replacing the tables of the CALS format with those transformed in the Formex 4 format. In other words, the general structure of the source XML document is retained except for tables.
The Cals2FormexConverter
converter is composed of:
a
CalsParser
parser that allows you to parse tables in CALS format,The tutorial CALS tables parser describes the usage of this parser and gives some examples.
a
FormexBuilder
builder that allows you to build tables in the Formex 4 format.The tutorial Formex 4 tables builder describes the usage of this builder and gives some examples.
Conversion options¶
The tables parsing and building can be parameterized using the options described below:
Common parsing options:
encoding
(default: “utf-8”):- XML encoding of the destination file.
CALS parser options:
cals_ns
(defaultNone
):- Namespace to use for CALS elements and attributes parsing.
Set
None
(or “”) if you don’t use namespace in your XML.
Formex 4 builder options:
use_cals
(default:False
):- Generate additional CALS-like elements and attributes to simplify the layout of Formex document in typesetting systems.
cals_ns
(default: “https://lib.benker.com/schemas/cals.xsd”):- Namespace to use for CALS-like elements and attributes (requires:
use_cals
). SetNone
(or “”) if you don’t want to use namespace. cals_prefix
(default: “cals”):- Namespace prefix to use for CALS-like elements and attributes (requires:
use_cals
). width_unit
(default: “mm”):- Unit to use for column widths (requires:
use_cals
). Possible values are: ‘cm’, ‘dm’, ‘ft’, ‘in’, ‘m’, ‘mm’, ‘pc’, ‘pt’, ‘px’.