Benker

===================

Bug fix release

Fixed
-----

Use an alternative implementation of :class:`~benker.common.lxml_qname.QName`
for lxml versions v4.2 and earlier (rather than v4.0).


Other
-----

Change in the documentation:

* Fix a broken and redirected links in the documentation.
* Add the missing documentation for the :mod:`benker.schemas` module.
* Correct the TOC in the API documentation.
* Remove 3.10 from the dependency matrix (not yet validated).
* Improve the layout of the API documentation.

===================

Bug fix release

Fixed
-----

Fix `13 <https://github.com/laurent-laporte-pro/benker/issues/13>`_:
ooxml2formex4 conversion – Loss of image calls in table conversion.

* Modification of the OOXML parser to improve empty cells detection for Formex4 conversion (``<IE/>`` tags management).

* Modification of the Formex4 builder to better deal with empty cells (management of ``<IE/>`` tags).

* Change in the CALS parser: improved empty cells detection for Formex4 conversion (``<IE/>`` tag management).

===================

Bug fix release

Fixed
-----

* Documentation: improve API documentation for CALS table builder.

* Change in the Formex/CALS builders and parsers:
Add support for the ``cals:cellstyle`` attribute (extension).
This attribute is required for two-way conversion of Formex tables to CALS and vice versa.
If the ``CELL/TYPE`` and the ``ROW/TYPE`` are different, we add a specific "cellstyle" style.
This style will keep the ``CELL/TYPE`` value.

* Fix in ``calstblx.xsd``: change the definition of ``tgroup``: ``tfoot`` may be placed after ``tbody`` (extension).

===================

Bug fix release

Changed
-------

Add the :func:`~benker.units.parse_width` function used to parse a width and return the value and its unit.


Fixed
-----

* Documentation: add missing link to ``convert_cals2formex`` in the main page.

* Fix `4 <https://github.com/laurent-laporte-pro/benker/issues/4>`_: Remove superfluous attributes in cals2formex.

Change in the :class:`~benker.builders.formex.FormexBuilder` class:
Add the :meth:`~benker.builders.formex.FormexBuilder.drop_superfluous_attrs` method:
drop superfluous CALS-like attributes at the end of the Formex building.

* Fix `5 <https://github.com/laurent-laporte-pro/benker/issues/5>`_: The title generation should be optional.

Change in the :class:`~benker.builders.formex4.Formex4Builder` class:
Add the *detect_titles* option: if this option is enable, a title will be generated
if the first row contains an unique cell with centered text.
The *detect_titles* options is disable by default.

* Change in the :class:`~benker.builders.formex4.Formex4Builder` class:
Allow empty strings for *cals_ns* and *cals_prefix* options.

* Fix `6 <https://github.com/laurent-laporte-pro/benker/issues/6>`_: Formex 2 Cals conversion: missing ``entry/valign``.

Change in the :class:`~benker.parsers.formex.FormexParser` class:
The "vertical-align" style is built from the ``cals:valign`` attribute.

Change in the :class:`~benker.parsers.cals.CalsParser` class:
The "vertical-align" style is built from the ``cals:valign`` attribute.

Change in the :class:`~benker.builders.formex.FormexBuilder` class:
The ``cals:valign`` attribute is built from the "vertical-align" style.

Change in the :class:`~benker.builders.cals.CalsBuilder` class:
The ``cals:valign`` attribute is built from the "vertical-align" style.

* Fix `7 <https://github.com/laurent-laporte-pro/benker/issues/7>`_: Formex 2 Cals conversion: missing ``table/width``.

Change in the :class:`~benker.builders.cals.CalsBuilder` class:
Add support for the ``width`` attribute (table width).

Change in the :class:`~benker.builders.formex.FormexBuilder` class:
Add support for the ``width`` CALS-like attribute (table width).

* Minor change in the :class:`~benker.parsers.ooxml.OoxmlParser` class:
XML indentation between cell paragraphs is ignored.

* Fix `9 <https://github.com/laurent-laporte-pro/benker/issues/9>`_: Cals 2 Formex conversion:
Text and PIs lost in entries.

Add the :meth:`~benker.builders.base_builder.BaseBuilder.append_cell_elements` method:
Append XML elements, PIs or texts to a cell element.

Change in the :class:`~benker.builders.cals.CalsBuilder` and :class:`~benker.builders.formex.FormexBuilder` classes:
Preserve processing instruction in cell content.

* Fix `10 <https://github.com/laurent-laporte-pro/benker/issues/10>`_: Formex 2 Cals conversion: ``GR.NOTES`` should be preserved.

Change in :class:`~benker.parsers.formex.FormexParser` class:
``GR.NOTES`` elements can be embedded if the *embed_gr_notes* options is ``True``.

Change in the :class:`~benker.builders.formex.FormexBuilder` class:
During ``GR.NOTES`` extraction, existing ``GR.NOTES`` are moved before the ``CORPUS``
(or created if missing).

Change in the :func:`~benker.converters.formex2cals.convert_formex2cals` function:
Add the *embed_gr_notes* options to allow ``GR.NOTES`` element embedding.


* Fix `11 <https://github.com/laurent-laporte-pro/benker/issues/11>`_: Cals 2 Formex conversion: missing ``CORPUS/width``.

Change in the :class:`~benker.parsers.cals.CalsParser` class:
Add the ``width_unit`` option, and add support for the ``cals:width`` attribute (table width).

* Fix `12 <https://github.com/laurent-laporte-pro/benker/issues/12>`_: Cals 2 Formex conversion: missing ``colspec`` attributes.

Change in the :class:`~benker.builders.formex.FormexBuilder` class:
Add support for CALS-like attributes: ``colnum``, ``align``, ``colsep``, and ``rowsep``
in the ``colspec`` element.

Change in the :class:`~benker.builders.cals.CalsBuilder` class:
The ``colsep`` and ``rowsep`` attributes are generated.


Other
-----

* Change link to the Formex documentation to "https://op.europa.eu/en/web/eu-vocabularies/formex".

* Change Tox & AppVeyor configuration to use lxml v4.3.3 on Windows (for Python 3.4),
because lxml v4.3.5 is not available for this platform.

===================

Minor release

Changed
-------

* Refactoring (rename "Formex4" to "Formex"):

- the module ``benker/builders/formex4.py`` is renamed ``benker/builders/formex.py``,
- the module ``benker/converters/ooxml2formex4.py`` is renamed ``benker/converters/ooxml2formex.py``,
- the module ``benker/parsers/formex4.py`` is renamed ``benker/parsers/formex.py``,
- the class ``Formex4Builder`` is renamed ``FormexBuilder``,
- the class ``Ooxml2Formex4Converter`` is renamed ``Ooxml2FormexConverter``,
- the function ``convert_ooxml2formex4`` is renamed ``convert_ooxml2formex``,
- the class ``Formex4Parser`` is renamed ``FormexParser``,

* Change in the class :class:`~benker.table.Table`:
add the method :meth:`~benker.table.Table.fill_missing` to fill the missing cells in a table.

* Change in the class :class:`~benker.builders.cals.CalsBuilder`:
Add support for the ``cals:rowstyle`` attribute (extension).
The ``colnum`` and ``align`` attributes are generated for the ``<colspec>`` element.
The new options *cals_ns* and *cals_prefix* allow the used of namespaces in CALS.
The option *tgroup_sorting* can be used to sort the ``thead``, ``tbody`` and ``tfoot`` elements.

* Change in the method :class:`~benker.parsers.base_parser.BaseParser.parse_file`:
Always generate the XML declaration in the destination file.

Added
-----

* Change in the converter: :func:`~benker.converters.ooxml2formex.convert_ooxml2formex`:
Add the option *use_cals* (and related options: *cals_ns*, *cals_prefix* and *width_unit*):
This options is used to generate additional CALS-like elements and attributes
to simplify the layout of Formex document in typesetting systems.

* Add support for the Table/Cell shading in the OOXML parser.

* Add support for ``bgcolor`` (Table/Cell background color) in the CALS builder.

* Add support for ``bgcolor`` (Table/Cell background color) in the Formex 4 builder
(only with the *use_cals* option).

* New parser: :class:`~benker.parsers.cals.CalsParser`: CALS tables parser.


Fixed
-----

* Change in the builder :class:`~benker.builders.cals.CalsBuilder`:
the possible values for row/cell *nature* is "header", "body" and "footer"
(instead of "head", "body", "foot").

* Fix in the class :class:`~benker.parsers.ooxml.OoxmlParser`: rows with missing cells are filled
with empty cells of the same nature as the row.

Other
-----

* Fix an issue with the AppVeyor build: upgrade setuptools version in ``appveyor.yml``,
change the Tox configuration: set ``py27,py34,py35: pip >= 9.0.3, < 19.2``.

* Change the project‘s slogan: “Easily convert your CALS, HTML, Formex 4, Office Open XML (docx)
tables from one format to another.”

* Change Tox configuration file to test the library with lxml v4.3 on Python 3.4
(support for Python 3.4 was removed in `lxml v4.4 <https://lxml.de/4.4/changes-4.4.0.html>`_).

* Change Tox configuration file to test the library on Python 3.8.

* Change the Travis CI configuration to build on Python 3.7 and 3.8-dev.

* Change in the documentation: fix a broken and redirected links in the documentation.

===================

Bug fix release

Fixed
-----

Fix `13 <https://github.com/laurent-laporte-pro/benker/issues/13>`_:
ooxml2formex4 conversion – Loss of image calls in table conversion.

* Modification of the OOXML parser to improve empty cells detection for Formex4 conversion (``<IE/>`` tags management).

* Modification of the Formex4 builder to better deal with empty cells (management of ``<IE/>`` tags).