question on docbook header formatting

[Jack]

On 2023.10.19 02:54, Yuri Chornoivan wrote:
> четвер, 19 жовтня 2023 р. 00:05:15 EEST Jack написано:
>> Running khelpcenter, looking at the TOC produced by meinproc5,  
>> within a chapter, if a sect1 has several sect2s within it, there is  
>> no extra space between the sect1 title and the first sect2 title,  
>> nor between the sequential sect2 titles.  There IS a space between  
>> the last sect2 and the following sect1.  However, there is no space  
>> between two sequential sect1 titles, if the first does not contain  
>> any sect2.  This looks odd to me, but I suppose it has been that way  
>> for a long time. Am I the only one who thinks this, and is there any  
>> reasonable way to change it?
> 
> This can be tweaked through kde-docs.css and kde-default.css  
> (common/en in kdoctools repo [1]).
> 
> Yes, I think the presentation can be better than now.
> 
> Best regards,
> Yuri
> 
> [1] https://invent.kde.org/frameworks/kdoctools
I've been playing with the css and have made some progress, but am not  
there yet.  I am no css expert, but the nested dl structure of the toc  
makes it difficult to select only those <dt> elements which contain a  
<span class="sect1"> but are NOT followed by a <dd> element (for lower  
level entries.  I seem to have a successful css which does this, but it  
requires using the :has() pseudo-selector.  I have gotten it to work in  
Firefox (by setting a config variable, since :has is not yet enabled in  
the released versions until 120.  However, it does NOT work at all in  
khelpcenter.  My guess is that it simply does not support the full  
suite of css constructs.  If this is true, and it does not support  
:has(), I'm not sure it is possible to do what I want, but I'm open to  
other suggestions.
> 
> > Simply adding space before any sect1 title would add
> > unwanted space between a chapter title and the first sect1 title,  
> so I
> > know it's not trivial to do.
Part of the issue is that margin-top and margin-bottom only apply to  
the <dt> element, and not directly to the <span class="sect1"> since  
that is inline, and inline elements do not get margins, only block  
elements.  Given those <span> tags apply to complete lines of the TOC,  
changing them to <div> might make things easier, but I don't know how  
buried in meinproc5 that is done.
> >
> > Any thoughts or suggestions?
> >
Jack