Bug 145134 - Improve styling of headers in help pages
Summary: Improve styling of headers in help pages
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
(earliest affected) release
Hardware: All All
: medium normal
Assignee: Not Assigned
Depends on:
Blocks: New-Help
  Show dependency treegraph
Reported: 2021-10-14 15:12 UTC by Rafael Lima
Modified: 2021-12-10 14:05 UTC (History)
1 user (show)

See Also:
Crash report or crash signature:

Images Describing the Issues (121.39 KB, application/vnd.oasis.opendocument.graphics)
2021-10-14 15:12 UTC, Rafael Lima

Note You need to log in before you can comment on or make changes to this bug.
Description Rafael Lima 2021-10-14 15:12:46 UTC
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"/>
Comment 1 Olivier Hallot 2021-12-10 14:05:46 UTC
this report contains 2 very different/independent issues. Could you please split it?

The link colors issue can be addressed in the default.css and javascript files

The embed level issue must be addressed at the XLST level and will require a change in the DTD to include a new flag.