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

KAATMAN Matthew matthew.kaatman at biomerieux.com
Tue Oct 23 13:07:35 CDT 2012


Thanks Eliot,

I've nuked my plugin and re-run the Integrator.

I've now tried to place my customization in the plugins/org.dita.pdf2/ directory.

I duplicated the DITA Map PDF scenario and pointed customization.dir at my new directory.

It's choking on layout-masters:
 [xslt] C:\PFW\Oxygen XML Editor 14.1\frameworks\dita\DITA-OT\plugins\org.dita.pdf2\MattTest\fo\xsl\layout-masters.xsl:42:124: Fatal Error! Variable layout-masters has not been declared

I remember seeing a note in the 1.6 release notes about layout-masters.xml being deprecated.

Unfortunately, I can't find any notes on what I should be doing to transition away from layout-masters.xml.

In my catalog.xml I have my link to my override disabled:
    <!--uri name="cfg:fo/layout-masters.xml" uri="fo/custom_layout-masters.xml"/-->

But I suppose my styles are depending on the old layout-masters that was in cfg.

I feel like I'm almost there if you guys have any further thoughts on how I can transition over.

Thanks!
Matt

-----Original Message-----
From: Eliot Kimber [mailto:ekimber at rsicms.com] 
Sent: Tuesday, October 23, 2012 12:50 PM
To: KAATMAN Matthew; Echlin, Robert; Oxygen XML Editor Support; Oxygen User
Subject: Re: [oXygen-user] Converting DITA-OT plugin from 1.5.4 to 1.6

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.ht
>> m
>> 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/


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.




More information about the oXygen-user mailing list