Page 1 of 1

Troubleshooting topics

Posted: Tue Jul 09, 2024 12:15 pm
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

Re: Troubleshooting topics

Posted: Wed Jul 10, 2024 10:49 am
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

Re: Troubleshooting topics

Posted: Thu Jul 11, 2024 10:15 am
by LASSE_MLE
Thank you Costin!