Page 1 of 1

Do not show shortdescriptions

Posted: Wed May 09, 2018 1:07 pm
by catherine
Hi, I don't want to show the short descriptions under a topic link.
Only display topic links. no short descriptions.
How to solve this?

Re: Do not show shortdescriptions

Posted: Wed May 09, 2018 5:09 pm
by Costin
Hi catherine,

What document type are you trying to publish to?
An easy way to hide the <shortdescription> elements in the output would be through CSS.
If you are publishing to WebHelp Responsive, you should create a custom .css file, containing the rules below:

Code: Select all

.wh_tile_shortdesc {
display:none;
}
.wh_tile {
min-height:10px;
}
Then you should edit the DITA Map WebHelp Responsive transformation scenario, go to the "Parameters" tab, set the "args.copycss" to "yes" and set the path to your custom CSS in the "args.css" parameter.

Using the custom .css file would hide the <shortdesc> element in the output and set a minimum height for its container element.

Regards,
Costin

Re: Do not show shortdescriptions

Posted: Fri May 11, 2018 4:10 am
by catherine
Hi, Costin
Thanks for your reply!
The output is webhelp.
I mean the short description under the child link.
If I show the short description under the child link, it will make the link not so "clean".
I just want to show the child link, no short description under the child link.

Re: Do not show shortdescriptions

Posted: Mon May 14, 2018 11:04 am
by Costin
Hi Catherine,

Just in order to clearlt understand what exactly you refer to, could you please provide a screenshot on our support email (support@oxygenxml.com) emphasizing the specific short description you need to remove from output?

Thank you!
Costin

Re: Do not show shortdescriptions

Posted: Wed May 23, 2018 4:21 am
by catherine
Hi, Costin
Thanks for your reply! :)
In our writing style, we need to write short description in each topic.
And I set to "webhelp.show.child.links" to "yes".

As a result, when I generate a webhelp output, I get child links, and also the short descriptions.

My question is, how to remove the short descriptions under the child links, and only show the child links.

Hope my problem is clear to you this time. :)

Re: Do not show shortdescriptions

Posted: Wed May 23, 2018 2:57 pm
by Costin
Hi Catherine,

I think it's clear now.

In a similar fashion, you could add a CSS rule for the specific selector matching the short descriptions in your childlinks.
I.e, to hide the short descriptions for the childlinks in your custom .css, you should use something like:

Code: Select all

.wh_child_links > nav li div {
display: none;
}
Whenever you need to customize your WebHelp output through CSS styling, you should consider this "How to" guide from our User-Guide.
It provides information on how you could find the selectors you need to apply CSS rules to, how to create and use a custom CSS containing your rules.

Regards,
Costin

Re: Do not show shortdescriptions

Posted: Fri Jun 08, 2018 2:05 pm
by catherine
Hi, Costin
Thanks for your reply!
I added the css code in my customized css file, but it did not work?
Have you tried that?

Let me explain my demand clearly. :)

I want to show childlinks, so I set the "webhelp.show.child.links" to "yes".
But I don't want to show the short descriptions (that are written in each topic) under the childlinks.

I find that if the childlinks are "related topic" links, the short descriptions would not be displayed.
But, if the childlinks are the "child-topic of the parent-topic " links, the short descriptions would be displayed.

Re: Do not show shortdescriptions

Posted: Mon Jun 11, 2018 10:19 am
by Costin
Hi Catherine,

Yes, I understood your use case and I also tested the CSS rule before.
However, it seems that, somehow, I tested this on a specific content from a file at my side, for which the rule worked, but I now tested this again against a general DITA Map that contains topics with short descriptions and I can confirm the rule I suggested does not work.
Sorry for the confusion.

We also investigated this further and found out that there is actually an issue, as the short descriptions are just plain text, not being wrapped in an XML element, so there is no selector we could use in a rule to hide them in the output.
That's why we already have an improvement request logged in our internal tracking system so our developers will try to find a possible solution, which would be implemented in a future version of oXygen. I also added your vote for it on the issue, so we will notify this thread when the improvement will get implemented.
Meanwhile, I'm afraid that currently there is no workaround I could provide you to hide the short descriptions.

Regards,
Costin

Re: Do not show shortdescriptions

Posted: Tue Jun 12, 2018 4:04 am
by catherine
Yes, As I checked the html source code, I got the same conclusion as yours.
Thanks, Costin!

Re: Do not show shortdescriptions

Posted: Thu Aug 29, 2019 12:09 pm
by aremaci
I would also like to add my vote to this issue.

Re: Do not show shortdescriptions

Posted: Thu Aug 29, 2019 2:47 pm
by Costin
aremaci wrote: Thu Aug 29, 2019 12:09 pm I would also like to add my vote to this issue.
Vote added.

Regards,
Costin

Re: Do not show shortdescriptions

Posted: Tue Jan 23, 2024 10:15 pm
by natemyersibm
Hello :) I am also curious about this issue. Any updates?

Re: Do not show shortdescriptions

Posted: Thu Jan 25, 2024 5:36 pm
by ionela
Hi,

I'm sorry, but in the current version of Oxygen XML WebHelp this issue is not implemented. I have added your vote and comments to it.

Regards,
Ionela