Convert Editor 19's customized webhelp to 19.1

taruga
Posts: 1

Convert Editor 19's customized webhelp to 19.1

Thu Oct 05, 2017 6:17 am

Dear oXygen Support,

We have customized the webhelp(responsive) of oXygen Editor 19.0.
Implementing by changing the following extension points in DITA - OT's plugin com.oxygenxml.webhelp.

Code: Select all

Implementing in our plugin
<feature extension="com.oxygenxml.webhelp.xsl.createMainFiles" file="xsl/createMainFilesShell.xsl"/>
<feature extension="com.oxygenxml.webhelp.xsl.dita2webhelp" file="xsl/dita2webhelpShell.xsl"/>


However, the DITA - OT plugin of OXygen Editor 19.1 has a different plug - in configuration.

19.0 plugin
com.oxygenxml.webhelp

19.1 plugin
com.oxygenxml.webhelp.classic
com.oxygenxml.webhelp.common
com.oxygenxml.webhelp.responsive

How can I convert customized webhelp from 19.0 to 19.1?

Regards,
t.aruga
alin
Site Admin
Posts: 109

Re: Convert Editor 19's customized webhelp to 19.1

Thu Oct 05, 2017 1:57 pm

Hello,

In version 19.1 the WebHelp Plugin was split in two main plugins, one that covers the WebHelp Classic functionality and one that covers the Responsive functionality. Thus the available extension points were redesigned.
For the WebHelp Responsive plugin the following changes were performed:
  • The com.oxygenxml.webhelp.xsl.createMainFiles extension point was split in three extension points:
    • com.oxygenxml.webhelp.xsl.createMainPage - for the Main page (index.html)
    • com.oxygenxml.webhelp.xsl.createSearchPage - for the Search page
    • com.oxygenxml.webhelp.xsl.createIndexTermsPage - for the Index Terms page
  • The com.oxygenxml.webhelp.xsl.dita2webhelp and com.oxygenxml.webhelp.xsl.createTocXML extension points remained unchanged.
For more details about the available extension points in the WebHelp Responsive plugin please read this topic in our User Manual:
https://www.oxygenxml.com/doc/versions/ ... mport.html

It is possible that your customization might work by just remapping the old extension points to the new ones. For example, in your case:

Code: Select all

<feature extension="com.oxygenxml.webhelp.xsl.createMainPage" file="xsl/createMainFilesShell.xsl"/>
<feature extension="com.oxygenxml.webhelp.xsl.createSearchPage" file="xsl/createMainFilesShell.xsl"/>
<feature extension="com.oxygenxml.webhelp.xsl.createIndexTermsPage" file="xsl/createMainFilesShell.xsl"/>

<feature extension="com.oxygenxml.webhelp.xsl.dita2webhelp" file="xsl/dita2webhelpShell.xsl"/>


However, please note that the 19.0 XSL stylesheets were also redesigned and you should make sure that the templates that you have overridden still exist in the 19.1 version of the stylesheets.

You might also find useful the following WebHelp Responsive extension plugin: https://github.com/oxygenxml/com.oxygen ... tom.footer

Regards,
Alin
Alin Balasa
Software Developer
<oXygen/> XML Editor
http://www.oxygenxml.com

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 1 guest