Opened 5 years ago

Last modified 22 months ago

#16300 new Bug

Poor header formatting when using "make singlehtml" on docs/

Reported by: Cal Leeming Owned by: nobody
Component: Documentation Version: master
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

So, whilst trying to test a patch on docs (for the first time btw), I came up against a curious problem. When using make singlehtml, some of the formatting appears to go a little weird.

For example:
.. _transactions-and-raw-sql:

That should come up as a <h6>, but instead, it comes up as a <h3>, which means it loses the usual styling.

Is this a known problem/feature, or should I be avoiding singlehtml all together?

Cal

Change History (3)

comment:1 Changed 5 years ago by Aymeric Augustin

Component: UncategorizedDocumentation
Needs documentation: unset
Needs tests: unset
Patch needs improvement: unset
Triage Stage: UnreviewedAccepted
Type: UncategorizedBug

I confirm the problem.

I don't believe many people use singlehtml, as the resulting file takes more than 6Mb...

comment:2 Changed 2 years ago by Andrew McCarthy

I just built this again, and there are so many changes in the years since I can't see what section it refers to. In any case, there's nothing obviously wrong from a quick skim through. Can you confirm this is still broken?

comment:3 Changed 22 months ago by Tim Graham

Summary: Strange problem when using "make singlehtml" on docs/Poor header formatting when using "make singlehtml" on docs/
Version: 1.3master

I am not sure if the original problem still exists, but <h5> and <h6> appear to have no formatting so they don't look like headers which is an aesthetic issue.

Note: See TracTickets for help on using tickets.
Back to Top