Page 1 of 1

adding admonishments

Posted: Fri Mar 01, 2019 10:14 am
by sushmatechpub
Hello,

Is it possible to change/customize the in-built admonishments as per requirement? For example, we have Note, on same lines is it possible to include warnings, cautions, stop, radiation and so on with symbols representing them. This can help with hardware documentation. Let me know how this can be incorporated.


Thanks,
Sushma

Re: adding admonishments

Posted: Mon Mar 04, 2019 5:47 pm
by ionela
Hi,

Could you please provide us more details about the context of this problem? Is your source file DITA content? What kind of transformation do you run in oXygen XML?
In case you run DITA Map WebHelp Responsive transformation you might use CSS styling to customize the output:
https://www.oxygenxml.com/doc/versions/ ... h-css.html

Regards,
Ionela

Re: adding admonishments

Posted: Tue Mar 05, 2019 11:57 am
by sushmatechpub
Hello,


-->Is your source file DITA content? - Yes, it is Dita.
-->What kind of transformation do you run in oXygen XML? - PDF.

-->Here is an example of what we already have for "note" in Oxygen:
https://drive.google.com/open?id=1XZCDh ... evsmIX2T5y

-->And I would need similar admonishments for the images marked in the attachment:
https://drive.google.com/open?id=1V9NQR ... j9c3KK4T_v

Thanks,
Sushma

Re: adding admonishments

Posted: Wed Mar 06, 2019 1:53 pm
by ionela
Hi,

How the content shown in Author mode may by different than the way it is actually rendered in the output.
The Author mode renders the content of the XML documents visually, based on CSS stylesheets associated with the document. But, to generate the output oXygen XML uses the DITA-OT publishing engine.
Could you please specify transformation do you use in oXygen XML to obtain the PDF output: DITA Map PDF - based on XSL-FO or DITA Map PDF - based on HTML5 & CSS ?
If you use DITA Map PDF - based on HTML5 & CSS you can use the same approach specified in my previous post as this output can be customized using CSS.

Regards,
Ionela

Re: adding admonishments

Posted: Mon Mar 11, 2019 11:33 am
by sushmatechpub
Hello,

The transformation that I am using is DITA Map PDF - based on XSL-FO . Please guide on how to proceed.

Thanks,
Sushma

Re: adding admonishments

Posted: Thu Mar 14, 2019 5:55 pm
by Costin
Hi Sushma,

An idea would be to use a customization folder where you could add your own image resources that should be used to overwrite the default ones that come from the DITA OT.

For more details on how you should do this, please see the Customizing note Images in PDF section from the User-Guide.

Regards,
Costin

Re: adding admonishments

Posted: Sun Mar 17, 2019 2:49 pm
by sushmatechpub
Hi Costin,

Thanks a lot. Your solution worked and solved my problem :)
How do we edit the default labels? For example, Changing the default label "Note" to "Information".

Regards,
Sushma

Re: adding admonishments

Posted: Tue Mar 19, 2019 5:28 pm
by Costin
Hi,

I'm afraid there is no easy way to do that, other than creating your own DITA-OT extension plugin for such customization.
I found this page from DITA-OT that contains information on how you could do that through your own customization plugin.
Also, you can find instructions on how you could create, install and use DITA-OT plugins in this section from our User-Guide.

I hope this helps.

Regards,
Costin