Troubleshooting topics

Post here questions and problems related to editing and publishing DITA content.
LASSE_MLE
Posts: 38
Joined: Mon Dec 05, 2022 3:24 pm

Troubleshooting topics

Post by LASSE_MLE »

Hello everybody,
I'm wondering since a few months what is the real status of the troubelshooting topics...
It looks like an official DITA topic but it seems it is treated a bit differently than the others. For example, in your documentation when you have created this topic:
https://www.oxygenxml.com/doc/versions/ ... ement.html
Did you use the troubleshooting topic? Or a basic concept or topic ?
All these interogations because whatever the output is (WebHelp or PDF in my case), these troubleshoot topics are not as readable as the others. I've joined to this ticket, screenshots of what I get.
In our documentation, troubleshooting have most of the times, several causes and each cause may have several remedies. And with this configuration, the output is fully linear and not really fun to read.
Do you have advices? May I split all my troubleshooting to always have a 1 problem > 1 cause > 1 remedy ?
Is is possible to customize the output of the troubleshooting topics? Creating indentation for example to isolate causes and remedies.
Thank you in advance for your advices!
BR
Mathieu
00.png
You do not have the required permissions to view the files attached to this post.
Costin
Posts: 846
Joined: Mon Dec 05, 2011 6:04 pm

Re: Troubleshooting topics

Post by Costin »

Hi Mathieu,

The topic we used (the one you refer to) is indeed a troubleshooting topic.
You could customize the way the troubleshooting topic is rendered in the output through a CSS customization of your own.
More information on how to match the elements you wish to customize in the output through CSS and how to use the CSS in the transformation scenario is available in this section from the Oxygen User-Guide.

Regards,
Costin
Costin Sandoi
oXygen XML Editor and Author Support
LASSE_MLE
Posts: 38
Joined: Mon Dec 05, 2022 3:24 pm

Re: Troubleshooting topics

Post by LASSE_MLE »

Thank you Costin!
Post Reply