Installing Plugins - Specifically Qwdita

[steveinfrance]

Hi there,

I found what promises to be a great plugin (https://github.com/smarvin/qwdita), which would act as a syntax highlighter for code in the webhelp and pdf outputs.

I'm having no success in installing it. I think it may be that ant is not happy when run outside of oXygen.

Here are the instructions:

Code: Select all

To build the demo, run the following from the qwcode.highlight plugin directory (after it's installed). It's assumed here that your dita-ot environment is set up properly.



ant buildDemo



The files in qwcode.highlight/demo/dita will be transformed to qwcode.highlight/demo/xhtml. The source code in the demo comes from the xslthl svn repository.

Would anyone have any pointers or suggestions that would accomplish the same thing?

Thanks in advance,
Steve

[Radu]

Hi Steve,

I am not familiar with the plugin and what it should be doing, it does not have very much documentation. Also I do not know with which DITA OT version it is compatible.

First of all you need full write access to the DITA OT directory.

The plugin folders which should be copied to the DITA-OT/plugins directory should be:
qwcode.ancestors
qwcode.highlight
qwcode.highlight-js
qwcode.highlight-pdf

Then you need to run the DITA OT Integrator after copying the plugins to the DITA OT plugins folder:

http://www.oxygenxml.com/doc/ug-oxygen/ ... lugin.html

From what I've tested the plugins seem to be installed for the XHTML publishing (but I am not sure if they properly work, I do not know in what context the syntax highlight should be added). For the PDF publishing the plugin is not installed in the DITA OT 1.6 I tested with.
I suspect that the cause for this is that in recent versions of the DITA OT, the PDF plugin resources were moved from the DITA-OT/demo folder to the DITA-OT/plugins/org.dita.pdf2 folder.

Oxygen 14.1 and 14.2 comes with DITA OT 1.6.2 bundled.
It does not matter if ANT works or not from the console, you can invoke ANT directly from Oxygen as it is bundled as a tool in Oxygen.

So maybe you could ask the developer of the plugins more details about the supported DITA OT versions.

Regards,
Radu