Release Notes

Details about changes from release to release

The DITA for Publishers materials consists of the following major components. Each component has its own version number. The package of materials as a whole also has a version number, which is incremented for each release. For example, the vocabulary modules may be updated without the need to update any of the Toolkit plugins. In that case, the package and vocabulary version numbers are incremented but the Toolkit version numbers are not. All of the D4P Toolkit plugins report their individual version numbers when then run.

The components are:
  • The DITA for Publishers vocabulary modules, packaged as the Open Toolkit plugin org.dita4publishers.doctypes.
  • The Open Toolkit plugins for EPUB, Kindle, and HTML generation (the "HTML2" plugin).
  • The Word-to-DITA transformation framework and Toolkit plugin
  • The DITA-to-InDesign transformation framework and Toolkit plugin

The package also contains renditions of the DITA for Publishers User Guide.

The source materials for the DITA for Publishers project are available via anonymous git access (including Web-based git access) from github.com/dita4publishers/dita4publishers. Note that each of the individual plugins is managed as a separate git project within the dita4publishers GitHub organization and referenced as a git submodule from the main dita4publishers project.

If you clone the dita4publishers project you will need to run the git command git submodule init to initialize all the submodules and get the source for them. You will also find the bash script submoduleAll.sh, which will set up the D4P Open Toolkit submodules in any git repository you specify. For example, if you make your Open Toolkit directory into a git repository (Command git init in the DITA-OT directory) then you can run the command ./submoduleAll.sh {path to OT plugins directory} to get all the D4P plugins into your open toolkit. Just run the Toolkit's integrator.xml Ant script to integrate the D4P plugins and you should be ready to go. To update the plugins you can then use the command "git submodule foreach git pull" to get the latest versions of the plugins.