Add-onsDITA Translation Package Builder

Syncro Soft
Version: 1.0.0
Oxygen Version: 22.0+
End User License Agreement

This add-on contributes contextual menu actions that help you build a translation package for DITA files that can be sent to translators. You can also extract the changed files back into your project once you receive the package back from the translators.

It contributes a sub-menu named "Translation Package Builder" in the DITA Maps Manager 's contextual menu. The actions present in this group are:

  1. Generate Milestone - this action is the first one to use. It will generate an unique hash for each documentation resource. This information will be used by the second action to detect which files have been modified. A milestone file should be generated the first time you install this plugin and, afterwards, after each package sent to translators.
  2. Create Modified Files Package - this action detects which files have been changed since the last generated milestone. These files are packed insdie a ZIP file that can be send to translators. After doing this you can also generate a new milestone so that the next package will contain just the new changes.

    This action also creates a report with the modified resources ( modified_resources_report.xhtml ). If your translation agency is DITA-aware you can opt to send him the entire DITA project together with this report.

  3. Apply Package - when the translated files arrive from the translator you should open the DITA map that corresponds to the received language (open dita-map-french.ditamap if the package contains the french translation). Invoking this action will extract the changed files inside map's directory.

Release Notes 1.0.13

  • Made add-on compatible with the new features added in Oxygen 23.

Release Notes 1.0.12

  • Fixed an issue when the package with the modifiled file was wrongly overriden.
  • Corrected the value of the date attribute from the milestone; when the milestone is overriden its value is updated #22
  • Fixed other small issues.

Release Notes 1.0.11

  • Tree and table views from Preview are now HiDPI aware.
  • Milestone generation has been corrected to scan and add all referred files, even if the root map is not in the top directory #9
  • Corrected a small issue regarding modified files package in which not all files were added to the archive.(side-effect of #9 )
  • Fiexd an internal issue where white spaces in file names or file location was generating incorrect results
  • Selection in Tree View from Preview dialog will now take into account the selection.

Release Notes 1.0.10

  • Override confirmation when generating the modified files package #5
  • Removed 'Experimental' tag.
  • Small UI changes.

Release Notes 1.0.9

  • XML files are scanned for changes #18
  • Small UI changes.

Release Notes 1.0.8

  • Milestones are now generated based on the DITA Map structure. The resources referred in the map will be scanned for changes. #8
  • References to missing resources will be reported in oXygen's Results Manager but the packaging process will continue. #14
  • In some cases the milestone report contained duplicate and invalid data, preventing the creation of the package. #15
  • The root map was not added in the milestone even if it was modified. #16
  • The generated XHTML report that contains the relative paths of the modified resources is now valid and the referred resources are sorted alphabetically. #17

For more details, see: https://github.com/oxygenxml/oxygen-dita-translation-package-builder