Technical documentation

Content of the docbook_to_hdoc folder

The zip file includes 4 folders :

  • XSL which contains the files that convert the DocBook source file :

    • DbToAnt generate an ant file that will copy all the external resources from the source to the destination hdoc folder, and then executes the DbToHdoc.xsl file.

    • DbToHd converts the DocBook source file to Hdoc.

  • Ant which contains an ant script and two folders :

    • The main ant file, when executed, first deletes the old generated files, then executes the DbToAnt xsl file to generate DbToHd.xsl, in order to execute it. The last thing is that it generates an hdoc zip file from the destination folder. It also execute Remy's converter in order to get an Opale file from the hdoc.

    • The lib folder contains the Saxon library, which is the XSL processor used by the ant script.

    • The rsc folder which contains "container.xml", which is copied to the output folder (it is needed by hdoc).

  • DocBook which contains a few example samples, and in which you have to put the docbook files that you want to convert.

  • hdoc_to_opale which is Remy's convert from hdoc to opale. For more detailed information, see his technical documentation.