[oXygen-user] Maintaining slightly variant standard frameworks

Oxygen XML Editor Support support at oxygenxml.com
Tue Feb 19 06:30:58 CST 2013


Hi Eliot,

What exactly would the RSuite handlers do? Browse the CMS?
Would they be implemented in Java or JavaScript?

If you already have Java dialogs implemented to browse the CMS you could 
use the method:

> AuthorComponentFactory.addInputURLChooserCustomizer(InputURLChooserCustomizer)

to add a special "Browse CMS" action to every chooser from the applet 
component (Insert Conref, Insert Image, Insert Cross ref).
So the Java dialogs would still be implemented by us but they would have 
an extra action for browsing the CMS for a target URL using your Java 
implemented browse dialogs.

Another alternative would be for you to add your own actions for 
inserting cross refs, conrefs, image refs to the component's toolbar (as 
a developer you control the creation of the component's toolbar from the 
AuthorComponentSample sample Java class).
Your actions could perform the custom operations to find the target URL 
and if the operation is complex (Insert conref, Insert Cross Ref), in 
Oxygen 14.2 (and the corresponding Author Component Sample Project) we 
added to the ro.sync.ecss.dita.DITAAccess class API like:

> DITAAccess.insertContentReference(AuthorAccess authorAccess, URL initialReferenceURL, boolean displayReferenceUrl)

which would show our existing dialog for inserting conrefs 
pre-constructed to show all targets available in a certain URL which has 
already been chosen by the user at a previous stage.

Or another alternative:

The Java toolbar of the applet would have certain actions removed from 
it. But you would also have a Javascript toolbar in the HTML page (on 
top of the applet) which would call methods on the applet to access our 
API and perform changes to the document.

By the way, we created a special users list for SDK and API discussions:

http://www.oxygenxml.com/mailinglists.html#oxygen-sdk

Regards,
Radu

Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

On 2/18/2013 7:25 PM, Eliot Kimber wrote:
> I'm working on integrating the Oxygen applet with RSuite specifically for
> DITA use. Thus I want to use the out-of-the-box DITA framework but I need to
> modify it slightly to add RSuite-specific handlers for actions that select
> things (xrefs, conrefs, images, etc.)
>
> What is the best way to manage this sort of small change to an
> Oxygen-supplied framework so as to avoid maintaining (and keeping up to
> date) a fully copy of the framework?
>
> Thanks,
>
> E.
>


More information about the oXygen-user mailing list