[oXygen-user] Converting DITA-OT plugin from 1.5.4 to 1.6

Tue Oct 23 12:49:47 CDT 2012

For PDF, your customizations *may* be packaged as plugins or you can simply
put them in the plugins/ directory of the base PDF plugin.

For 1.6 the PDF plugin has been moved from the demo/ directory to the
plugins/ directory, so you need to adjust your customizations to reflect
that new location.

If your customizations are just customizations, then it should be simply a
matter of moving them to the corresponding place under
plugins/org.dita.pdf2.

If you created a Toolkit plugin with your customizations or created your own
transformation type that extends the base PDF2 transformation type, then
you'd need to update any references to the old demo directory.

Cheers,

E.

On 10/23/12 11:38 AM, "KAATMAN Matthew" <matthew.kaatman at biomerieux.com>
wrote:

> Hey Rob,
> 
> Thanks for the clarification. I'm still a bit confused though. I think it may
> be my terminology.
> 
> In Oxygen 13.x I had a 1.5.4 PDF customization I specified in the
> customization.dir parameter.
> 
> In Oxygen 14.1 they've switched to OT 1.6.1 which abandons the demo directory
> and I thought customizations were now called plugins.
> 
> Ultimately, I'm just trying to get my styles working for PDF in Oxygen 14.1/OT
> 1.6.1.
> 
> Am I following the right process?
> 
> Thanks for shedding light on this. I think I'm closer to understanding.
> 
> Matt
> 
> -----Original Message-----
> From: Echlin, Robert [mailto:Robert.Echlin at windriver.com]
> Sent: Tuesday, October 23, 2012 11:07 AM
> To: KAATMAN Matthew; Oxygen XML Editor Support; oxygen-user at oxygenxml.com
> Subject: RE: [oXygen-user] Converting DITA-OT plugin from 1.5.4 to 1.6
> 
> Hi Matthew,
> New transformation types are not visible in my version of oXygen, 13.2.
> 
> Radu is describing a case where your plugin modifies default processing.
> I have plugins that create new trans types with new functionality, but don't
> change the default transformations.
> I think that is what you are describing.
> 
> You need to create a new transform based on whatever transform is closest:
> probably XHTML or PDF, then add a new parameter in the new transformation. The
> new parameter is "transtype", the value is the name of your new transformation
> type.
> 
> Assuming you are modifying XHTML, you would do the following:
> - click on "DITA Map XHTML"
> - click on "Duplicate" button
> - The dialog for editing a transformation will appear
> - In the top of the dialog box, the "Name" field will say "DITA Map XHTML
> duplicate" - edit this name as you desire
> - The "parameters" tab will be open if you started with "XHTML", if you
> started with "PDF", click on "Parameters" tab
> - There is no "transtype" parameter - click "New"
> - Fill in the "Name" field with "transtype"
> - The value must be the name of your transtype as defined in your plugin
> - you can add a description if you like. I added " The transtype specifies
> what processinig is applied, at the highest level." (apparently I misspelled
> processing)
> - Hit OK. This exist the "Edit Parameter" dialog
> - Hit OK to exit the "Edit DITA Scenario" dialog
> - You are back to the "Configure Transformation Scenario" dialog. Click either
> "Save and Close" or "Transform Now". Any other action in this dialog will lose
> your edits and your new scenario.
> 
> Good luck!
> Rob
> --
> Rob Echlin, Documentation Systems Architect, Wind River
> 
> -----Original Message-----
> From: oxygen-user-bounces at oxygenxml.com
> [mailto:oxygen-user-bounces at oxygenxml.com] On Behalf Of KAATMAN Matthew
> Sent: Tuesday, October 23, 2012 11:28 AM
> To: Oxygen XML Editor Support; oxygen-user at oxygenxml.com
> Subject: Re: [oXygen-user] Converting DITA-OT plugin from 1.5.4 to 1.6
> 
> Thanks Radu,
> 
> I realized my error with the plugin directory shortly after posting.
> 
> I adjusted the paths and ran the default DITA OT integrator option.
> Afterwards, I should be able to select new scenario -> DITA-OT transformation
> And then I should see my new transformation type?
> 
> If I don't see it, how can I troubleshoot? Would the integrator report errors
> if there was some problem?
> 
> I do have full write permissions to the directory where I installed it.
> 
> Thanks!
> Matt
> 
> -----Original Message-----
> From: oxygen-user-bounces at oxygenxml.com
> [mailto:oxygen-user-bounces at oxygenxml.com] On Behalf Of Oxygen XML Editor
> Support
> Sent: Tuesday, October 23, 2012 3:27 AM
> To: oxygen-user at oxygenxml.com
> Subject: Re: [oXygen-user] Converting DITA-OT plugin from 1.5.4 to 1.6
> 
> Hi Matt,
> 
> Oxygen comes with a bundled DITA OT installation located in:
> 
>> OXYGEN_INSTALL_DIR\frameworks\dita\DITA-OT
> 
> There is indeed a plugins folder in Oxygen:
> 
>>  OXYGEN_INSTALL_DIR\plugins
> 
> but this folder is for Java-based plugins which provide additional
> functionality to an Oxygen installation using our Plugins SDK, so this is
> unrelated to the DITA OT transformations.
> 
> The DITA OT has also support for plugins, this folder is located in:
> 
>> OXYGEN_INSTALL_DIR\frameworks\dita\DITA-OT\plugins
> 
> So this is the place where you should copy your plugin folder.
> Then you should run the transformation scenario "Run DITA OT Integrator"
> directly without modifying it.
> The transformation scenario will call the DITA OT integrator which will look
> inside the "plugins" folder and modify stylesheets and build files from the
> DITA OT to connect the extensions from each found plugin.
> In order for this to work the folder where Oxygen is installed needs to have
> full read-write rights, not a problem in your case as you have not installed
> in the Windows Program Files folder.
> 
> Regards,
> Radu
> 
> Radu Coravu
> <oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
> http://www.oxygenxml.com
> 
> On 10/22/2012 7:11 PM, KAATMAN Matthew wrote:
>> Would anyone be willing to assist me in converting my plugin from
>> 1.5.4 to 1.6?
>> 
>> I followed the instructions here:
>> 
>> http://dita-ot.sourceforge.net/1.6.1/readme/dita2pdf-customization.htm
>> l
>> 
>>  From Oxygen, I duplicated the "Run DITA OT Integrator" scenario.
>> 
>> I changed the working directory and build file path to my new directory:
>> 
>> C:/PFW/Oxygen XML Editor 14.1/plugins/com.biomerieux.pdf_um/
>> 
>> I ran it:
>> 
>> Executing:
>> "c:\pfw\oxygen xml editor 14.1\jre/bin/java" "-Dhttp.proxySet=true"
>> "-Dhttp.proxyHost=10.16.0.59" "-Dhttp.proxyPort=8118" -Xmx256m
>> -classpath "C:\PFW\Oxygen XML Editor
>> 14.1/tools/ant/lib/ant-launcher.jar" "-Dant.home=C:\PFW\Oxygen XML
>> Editor 14.1/tools/ant" org.apache.tools.ant.launch.Launcher -f
>> "C:/PFW/Oxygen XML Editor
>> 14.1/plugins/com.biomerieux.pdf_um/integrator.xml" "-Dstrict=true"
>> 
>> Buildfile: C:\PFW\Oxygen XML Editor
>> 14.1\plugins\com.biomerieux.pdf_um\integrator.xml
>> 
>> BUILD SUCCESSFUL
>> Total time: 0 seconds
>> 
>> The process finished with exit code: 0
>> 
>> Then I'm a bit lost. I thought at that point I could click new under
>> the scenarios and I would see a transformation type that matched. Any
>> guidance on where I've gone wrong?
>> 
>> Thanks!
>> Matt
>> 
>> AVIS : Ce courrier et ses pieces jointes sont destines a leur seul
>> destinataire et peuvent contenir des informations confidentielles
>> appartenant a bioMerieux. Si vous n'etes pas destinataire, vous etes
>> informe que toute lecture, divulgation, ou reproduction de ce message
>> et des pieces jointes est strictement interdite. Si vous avez recu ce
>> message par erreur merci d'en prevenir l'expediteur et de le detruire,
>> ainsi que ses pieces jointes. NOTICE: This message and attachments are
>> intended only for the use of their addressee and may contain
>> confidential information belonging to bioMerieux. If you are not the
>> intended recipient, you are hereby notified that any reading,
>> dissemination, distribution, or copying of this message, or any
>> attachment, is strictly prohibited. If you have received this message
>> in error, please notify the original sender immediately and delete
>> this message, along with any attachments.
>> 
>> 
>> _______________________________________________
>> oXygen-user mailing list
>> oXygen-user at oxygenxml.com
>> http://www.oxygenxml.com/mailman/listinfo/oxygen-user
>> 
> _______________________________________________
> oXygen-user mailing list
> oXygen-user at oxygenxml.com
> http://www.oxygenxml.com/mailman/listinfo/oxygen-user
> 
> AVIS : Ce courrier et ses pieces jointes sont destines a leur seul
> destinataire et peuvent contenir des informations confidentielles appartenant
> a bioMerieux. Si vous n'etes pas destinataire, vous etes informe que toute
> lecture, divulgation, ou reproduction de ce message et des pieces jointes est
> strictement interdite. Si vous avez recu ce message par erreur merci d'en
> prevenir l'expediteur et de le detruire, ainsi que ses pieces jointes.
> NOTICE: This message and attachments are intended only for the use of their
> addressee and may contain confidential information belonging to bioMerieux. If
> you are not the intended recipient, you are hereby notified that any reading,
> dissemination, distribution, or copying of this message, or any attachment, is
> strictly prohibited. If you have received this message in error, please notify
> the original sender immediately and delete this message, along with any
> attachments.
> 
> 
> _______________________________________________
> oXygen-user mailing list
> oXygen-user at oxygenxml.com
> http://www.oxygenxml.com/mailman/listinfo/oxygen-user
> 
> AVIS : Ce courrier et ses pieces jointes sont destines a leur seul
> destinataire et peuvent contenir des informations confidentielles appartenant
> a bioMerieux. Si vous n'etes pas destinataire, vous etes informe que toute
> lecture, divulgation, ou reproduction de ce message et des pieces jointes est
> strictement interdite. Si vous avez recu ce message par erreur merci d'en
> prevenir l'expediteur et de le detruire, ainsi que ses pieces jointes.
> NOTICE: This message and attachments are intended only for the use of their
> addressee and may contain confidential information belonging to bioMerieux. If
> you are not the intended recipient, you are hereby notified that any reading,
> dissemination, distribution, or copying of this message, or any attachment, is
> strictly prohibited. If you have received this message in error, please notify
> the original sender immediately and delete this message, along with any
> attachments.
> 
> 
> _______________________________________________
> oXygen-user mailing list
> oXygen-user at oxygenxml.com
> http://www.oxygenxml.com/mailman/listinfo/oxygen-user

-- 
Eliot Kimber
Senior Solutions Architect, RSI Content Solutions
"Bringing Strategy, Content, and Technology Together"
Main: 512.554.9368
www.rsicms.com
www.rsuitecms.com
Book: DITA For Practitioners, from XML Press,
http://xmlpress.net/publications/dita/practitioners-1/