Hands up. Guilty as charged. Sometimes I don’t write with you, the reader in mind. You see, I have a memory like a sieve, so this blog can also act as a storage space for the things I need to remember, but probably won’t. Such as the following instructions on how to install the DITA HTML5 plug-in. If you find this information useful, then all the better.

Here’s how I managed to install the DITA HTML5 plug-in (using oXygen XML editor 15.2):

  1. Check the version of DITA-OT that is supplied with oXygen. To do this, open the relnotes.html file that is in the DITA-OT directory (supplied as part of the oXygen application). You will find it at Program Files or Program Files(x86)/Oxygen XML Editor 15/frameworks/dita/DITA-OT.
    Location of relnotes in oXygen XML Editor 15

    Location of relnotes in oXygen XML Editor 15

     

    You need the DITA-OT version to be version 1.7. or later. If you need to upgrade to a newer version, see http://sourceforge.net/projects/dita-ot/files/.

  2. Download the DITA4Publishers plugin. You can get this from https://sourceforge.net/projects/dita4publishers/files/release-candidate/ . You need to download the dita4publishers-0.9.19_OT17RC10.zip file.
  3. Unzip dita4publishers-0.9.19_OT17RC10.zip. to a temporary local folder.
  4. Browse the contents of the unzipped dita4publishers file and locate the dita4publishers-toolkit-plugins-0.9.19_OT17RC10.zip file.
  5. Unzip the dita4publishers-toolkit-plugins-0.9.19_OT17RC10.zip file. It contains 36 folders and three files (license.txt, NOTICES.txt, toolkit-xslt-catalog.xml). You need the folders, but not the other three files.
  6. Copy all 36 folders into the plugins directory of the DITA-OT (C:\Program Files or Program Files(x86)\Oxygen XML Editor 15\frameworks\dita\DITA-OT\plugins).The DITA 4 Publishers project includes an HTML5 plugin, but it is out-of-date.
  7. Browse to the plugins folder and delete the net.sourceforge.dita4publishers.html5 folder.
  8. Get the latest HTML5 plug-in files.To do this, you can:
    1. Register with Github
    2. Clone the dita4publishers.html5 project
    3. Copy dita4publishers.html5 (from the location you specified for the clone) to Program Files or Program Files(x86)/Oxygen XML Editor 15/frameworks/dita/DITA-OT/plugins.

    or:

    1. Visit https://github.com/uo-hrsys/net.sourceforge.dita4publishers.html5 and select Download ZIP.
    2. Unzip the file.
    3. In the extracted files, locate the folder net.sourceforge.dita4publishers.html5-master.
    4. Copy the net.sourceforge.dita4publishers.html5-master folder.
    5. Paste the net.sourceforge.dita4publishers.html5-master folder to Program Files or Program Files(x86)/Oxygen XML Editor 15/frameworks/dita/DITA-OT/plugins.
  9. On your desktop, right-click on the oXygen XML Editor icon and choose to Run as Administrator. This is important as I ran into problems when I just launched oXygen from the Start tool. Even though my user account has administrator permissions, oXygen kept generating errors, prompting me to log on as an administrator-level user.
  10. Integrate the plugins so that the DITA-OT knows that they are available. To do this, just use the Run DITA-OT Integrator that is built-in to oXygen (select Run DITA-OT Integrator in the Transformation Scenarios dialogue box and then select the Run icon, which is the red triangle).

    Run DITA-OT

    Run DITA-OT

  11. Right-click on the DITA XHTML transformation and select Duplicate. The Edit DITA Scenario window is displayed.

    Edit DITA Scenario

    Edit DITA Scenario

  12. Enter a new name for the scenario, for example, DITAtoHTML5.
  13. Select the New button. The Add Parameter window is displayed.

    Add Parameter

    Add Parameter

  14. Set the Name to: transtype
  15. Set the Value to d4p-html5
  16. Select OK to close the Add Parameter window and then the Edit DITA Scenario window. You should see the new HTML5 transformation scenario under the Project branch. This is the transformation that you will use when you produce HTML5 output.
Share This