Opened 4 years ago

Last modified 4 months ago

#16300 new Bug

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

Reported by: foxwhisper 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 4 years ago by aaugustin

  • Component changed from Uncategorized to Documentation
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted
  • Type changed from Uncategorized to Bug

I confirm the problem.

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

comment:2 Changed 6 months ago by andrewmccarthy

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 4 months ago by timgraham

  • Summary changed from Strange problem when using "make singlehtml" on docs/ to Poor header formatting when using "make singlehtml" on docs/
  • Version changed from 1.3 to master

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