Custom map icons for specialised DITA topics?

expatriate
Posts: 39

Custom map icons for specialised DITA topics?

Fri May 05, 2017 10:12 am

Hello
Is it somehow possible, using a customised icon, to indicate in the DITA Maps Manager view which topics which are of specialised types (i.e. other than task, reference or concept)?
This sounds like a big ask, but would be really useful.
Thanks
Pat
sorin_carbunaru
Site Admin
Posts: 111

Re: Custom map icons for specialised DITA topics?

Fri May 05, 2017 4:27 pm

Hello Pat,

There is something that could be done through our API, as we have a DITAMapNodeRendererCustomizer. Unfortunately we do not have an API yet that can change the icon based on the characteristics of the target topic of a topicref. But we do have a customizeComputedTopicrefTitle(...) method. With it, the implementer of the customizer can add a special character at the beginning of the title, to indicate it is a specialization. Would that be enough?

All the best wishes,
Sorin Carbunaru
oXygen XML
expatriate
Posts: 39

Re: Custom map icons for specialised DITA topics?

Fri May 05, 2017 8:13 pm

Thanks, Sorin, for the quick and encouraging response.

Yes, in principle this sounds perfect, especially as (if this is relevant) the titles of these topics will normally be not be rendered and would only be seen by the author. The oXygen API is an unvisited foreign country for me and I'm qualified only as a hacker, but I'll give it a try.

Best wishes
Pat
sorin_carbunaru
Site Admin
Posts: 111

Re: Custom map icons for specialised DITA topics?

Mon Oct 02, 2017 12:00 pm

Hello,

I wanted to let you know that oXygen 19.1 is now available. We added in the existing DITAMapNodeRendererCustomizer the possibility to customize the icons displayed in the DITA Maps Manager depending on the "class" attribute value of each referenced topic. The context parameter of DITAMapNodeRendererCustomizer#getRenderingInformation() can be cast to DITANodeRendererCustomizerContextImpl, and this type of context can give you the value of the "class" attribute. Based on this value a certain icon can be set in the new rendering information.

Best wishes,
Sorin Carbunaru
sorin_carbunaru
Site Admin
Posts: 111

Re: Custom map icons for specialised DITA topics?

Fri Oct 13, 2017 9:08 am

Hello there,

Just wanted to announce that we also have a sample plugin available on GitHub, that customizes the topic titles and the icons from the DITA Maps Manager. The plugin can be found at https://github.com/oxygenxml/wsaccess-j ... esAndIcons.

Best wishes,
Sorin Carbunaru

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

Who is online

Users browsing this forum: Google Feedfetcher and 1 guest