Add-onsBatch Documents Converter

Syncro Soft
Version: 6.0.0
Oxygen Version: 26.0+
End User License Agreement

This add-on contributes actions in the Tools menu and contextual menu to enable batch conversion between various formats:

  • Word to XHTML/DITA/DocBook
  • HTML to XHTML/DITA/DocBook
  • Markdown to XHTML/DITA/DocBook
  • Excel to DITA
  • OpenAPI to DITA
  • Confluence to DITA
  • DocBook to DITA
  • XML to JSON/YAML
  • JSON to XML
  • YAML to JSON/XML
  • JSON to YAML
  • XSD to JSON Schema

For more details see https://www.oxygenxml.com/doc/ug-editor/topics/batch-converter-addon.html


What's new in version 6.0.0

  • You can now convert XSD to JSON Schema (version 2020-12).
  • Improvements were implemented related to lists with custom styles processing for Word to HTML/DITA conversions.
  • Updated the Apache POI library (used for conversions from Word and Excel) to version 5.2.5.

What's new in version 5.3.0

  • The Markdown to DITA conversion was updated to be compatible with all enhancements made in version 5.5.0 of the org.lwdita DITA OT plugin.
  • Increased the minimum required version of Oxygen to 26.0.

What's new in version 5.2.0

  • OpenAPI to DITA
    • Fixed an issue where the OpenAPI to DITA conversion failed when the document contained the "*/*" MIME type.
    • Fixed invalid IDs on topics resulting from OpenAPI tags that contained multiple words separated by spaces.
    • Fixed a case where the description from responses was lost during the conversion of OpenAPI v2.
  • Word to HTML/DITA
    • Added 'frame', 'rowsep', and 'colsep' attributes to tables from the resulting DITA documents.
    • Fixed a case where the resulting tables had duplicate IDs.
    • Added a default configuration for codeblocks in the Word Styles Mapping table.
    • Fixed a case where the custom styles based on a normal style that didn't have a Word style mapping were not properly reported as unknown.
  • Confluence to DITA
    • Fixed an XSLT error that occurred when converting Confluence documents with duplicate IDs.
    • Removed queries from image paths. This prevents publishing errors caused by the presence of a query component in the URI.
  • Others
    • Updated the JTidy library to version 1.0.4.
    • Increased the minimum required version of Oxygen to 25.1.
    • Removed the Jackson libraries because these are already available in Oxygen.

What's new in version 5.1.0

  • Added two new conversions: YAML to XML and XML to YAML.
  • Word to HTML/DITA
    • The processing of table captions was improved. The table is now obtained with a caption child in HTML or with a title in DITA.
    • The width of table columns is now preserved.
    • The processing of figure captions was improved. For XHTML, a <figure> element is obtained with a <figcaption> child element. For DITA, a <fig> element is obtained with a <title> child element.
    • The saving of images was improved and the name from the Word internal structure is preserved.
    • Fixed an issue where the content was incorrectly merged between two different unordered lists.
  • Others
    • Removed the SnakeYAML library because this is already available in Oxygen.
    • Increased the minimum required version of Oxygen to 23.1.
    • Removed some Flexmark Java Extension libraries that are not used when converting Markdown.

What's new in version 5.0.1

  • Fixed an issue with Word to HTML/DITA conversions where content was incorrectly merged between two different lists.

What's new in version 5.0.0

  • OpenAPI to DITA
    • You can now convert JSON or YAML files that use and conform to the OpenAPI specification (versions 2.0, 3.0, or 3.1) to DITA documents and there is a 'Create DITA maps from OpenAPI documents' option that can be selected to instruct the converter to split the documents into separate topics that are referenced in a DITA map.
  • Word to HTML/DITA
    • Improved the Word styles mapping configuration by inheriting the style configuration of the custom style from the base style.
    • SVG images embedded in Word documents are preserved as SVG.
    • IDs that result from image and table bookmarks are now handled better to find the correct location.
    • Improved the IDs generation on topics and sections by using the text from headings.
    • Improved the handling of tables by preserving header row information during the conversion.
    • Fixed a case where a list that contains content between list items was broken into multiple lists.
    • Fixed a case where multiple ordered lists were merged into one.
    • Fixed a case where the conversion failed when the document contains duplicate mappings between numberings and styles.
    • Fixed a case where WMF images were not handled by the converter.
    • Fixed a case where the DITA result contained an invalid MathML equation.
    • Fixed a case where the DITA result contained images wrapped in the 'b' element.
    • Fixed a case where the value edited in the Word Styles Mapping table from the preferences page was not saved.
    • Updated the Java-Mammoth library used for Word to HTML/DITA conversions to version 1.5.0.
  • HTML to DITA
    • Improved the conversion of object elements from HTML by adding a proper 'outputclass' attribute in the DITA result.
    • Added an option in the conversion dialog box that allows you to decide whether or not the 'div' elements will be ignored.
    • Fixed a case where 'id' and 'class' attributes were lost when breaking paragraphs by processing the 'br' elements.
  • Markdown to DITA
    • Added support for the Markdown abbreviations.
    • Improved the handling of the local references.
    • Improved the conversion to allow processing of headings specified as HTML in the Markdown documents.
    • Improved the handling of the HTML anchor elements in the Markdown documents.
  • Others
    • The formatting of 'pre' elements are prevented when converting HTML to XHTML.
    • Fixed the layout of the preferences page because it was not entirely visible on low resolution screens.

What's new in version 4.0.0

  1. Added a Confluence to DITA conversion.
  2. Added a DocBook to DITA conversion.
  3. Improved the name of the extracted DITA topic files when converting to a DITA map with topics.
  4. Improved the title extraction of the DITA map when converting to a DITA map with topics.
  5. The 'alt' attributes from images are now handled properly when converting HTML to DITA.

What's new in version 3.2.1

  1. Critical/Security: The add-on no longer distributes Apache Log4j libraries to avoid the Log4Shell exploit. For more info see: CVE-2021-44228.
  2. Audio, video, picture, object, and iframe elements are handled when converting HTML to DITA.
  3. Fixed a case where the table of contents was not ignored when converting Word to DITA.

What's new in version 3.2.0

  1. Added a preferences page that contains:
    • An option for customizing the conversions from Word (Word to HTML/DITA/DocBook) by mapping Word styles to HTML elements.
    • Added an option for choosing the maximum heading level for creating nested topics or separate DITA topic files when converting Word/HTML to DITA.
  2. Warnings are now presented if unrecognized Word styles are found when converting Word documents.
  3. Improved the hierarchy level obtained in conversions from Word/HTML to DITA maps.
  4. All 'class' attributes are converted from the intermediary HTML into DITA 'outputclass' attributes when processing Word to DITA.
  5. Added an 'outputclass' attribute with an "endnote" value on the 'fn' DITA elements that resulted from Word endnotes.
  6. The file name is used as the title when the document doesn't contain headings in Word/HTML to DITA conversions.
  7. The table of contents is ignored when converting Word to HTML/DITA.
  8. Copied relative resources into the output folder in HTML to DITA conversions.
  9. Superscript and subscript are allowed when converting Markdown to DITA.
  10. Fixed some cases where internal references were not converted properly in Word to HTML/DITA conversions.
  11. Fixed a case where equations were not converted in Word to HTML/DITA conversions.
  12. Fixed an issue where a space between underline elements and other inline elements was ignored.
  13. Fixed an error in HTML to XHTML conversions when processing elements with whitespace content.

What's new in version 3.1.0

  1. Cross-references are now handled properly when converting Word to HTML/DITA.
  2. Index entries, footnotes and endnotes are now handled properly when converting Word to DITA.
  3. References to local HTML documents are now automatically updated when converting HTML to DITA.
  4. Fixed an issue with HTML to DITA/DocBook conversions where extra new lines were added when converting "pre" elements.
  5. Fixed an issue with Excel to DITA conversions that sometimes resulted in table elements with invalid IDs (#51).
  6. Fixed an issue with Word/HTML to DITA/DocBook conversions that caused spaces between inline elements to be removed.
  7. Updated the Java Mammoth library to version 1.4.2.
  8. Updated the jTidy library to version 1.0.2.

What's new in version 3.0.0

  1. Added two new conversions: YAML to JSON and JSON to YAML.
  2. Added import actions to the Append child, Insert Before, and Insert After sub-menus from the DITA Maps Manager's contextual menu. They convert documents and automatically insert them in the DITA map.
  3. Added the converter actions to the File->Import/Convert->Additional conversions sub-menu.
  4. Re-organized the converter actions for easier access.

What's new in version 2.1.0

  1. Added a new option for converting Markdown documents with multiple headings into DITA maps with referenced DITA topics (Markdown to DITA).
  2. Added a new option for creating DITA short description elements in the Markdown to DITA conversion.
  3. Improved the Markdown to DITA conversion to allow conversions of documents that start with a high heading level or increase the heading level with more than one unit.
  4. Added a new option for converting HTML documents with multiple headings into DITA maps with referenced DITA topics(HTML to DITA).
  5. Fixed various small bugs in the HTML to DITA and Word to DITA conversions.