Rebuilding the DITA-OT documentation

When you add or remove plug-ins, you can rebuild the documentation to update the information on the extension points, messages, and parameters that are available in your environment.

DITA-OT ships with a Gradle build script that enables you to rebuild the toolkit documentation. The build script reads the toolkit’s plug-in configuration and automatically regenerates topics and properties file templates based on the extension points, messages, and parameters provided by the installed plug-ins.

Attention: If you have installed new plug-ins, you may need to add the corresponding generated topics to the DITA maps to include the new information in the output.

  1. Change to the docsrc/ subdirectory of the DITA-OT installation.

  2. Run one of the following commands.

    • On Linux and macOS:

      ./gradlew *target*
      
    • On Windows:

      gradlew.bat *target*
      

    The target parameter is optional and specifies a transformation type. It takes the following values:

    • html
    • htmlhelp
    • pdf If you do not specify a target, HTML5 and PDF output is generated.