Created attachment 175742 [details]
Images Describing the Issues
I would like to share two aspects that could be improved in help pages concerning the styling of headers.
1) Headers containing links should use colors corresponding to the current LO Component being displayed (see attached image, page 1).
Currently, headers with links get a blue color (if unvisited) or dark purple (if visited), regardless of the LO component being shown. This makes the help pages look messy.
Instead, we could have styles for headers with links that use colors that better match the color of headers that do not have links. Obviously this would have to be component-contextual.
2) Embedding headers into another file currently demotes the header level (see attached image, page 2). This is very useful in many cases, f.i. when we embed a <h1> entry into another help page and it is shown as a <h2> header.
However, there are some cases where the embedded header already is a <h2> in the original file and embedding it in another file causes it to be formatted as <h3> with reduced font size (the example in page 2 shows exactly that case).
There could be a style flag while embedding that indicates whether the headings should be demoted or not. Something like: <embed href="somefile.xhp" demote="false"/>
this report contains 2 very different/independent issues. Could you please split it?
The embed level issue must be addressed at the XLST level and will require a change in the DTD to include a new flag.