[Django] #16300: Strange problem when using "make singlehtml" on docs/

8 views
Skip to first unread message

Django

unread,
Jun 20, 2011, 8:17:12 AM6/20/11
to django-...@googlegroups.com
#16300: Strange problem when using "make singlehtml" on docs/
---------------------------+-------------------------------
Reporter: foxwhisper | Owner: nobody
Type: Uncategorized | Status: new
Milestone: | Component: Uncategorized
Version: 1.3 | Severity: Normal
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Easy pickings: 0
UI/UX: 0 |
---------------------------+-------------------------------
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

--
Ticket URL: <https://code.djangoproject.com/ticket/16300>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Jul 7, 2011, 3:46:43 AM7/7/11
to django-...@googlegroups.com
#16300: Strange problem when using "make singlehtml" on docs/
--------------------------------------+-------------------------------
Reporter: foxwhisper | Owner: nobody
Type: Bug | Status: new
Milestone: | Component: Documentation
Version: 1.3 | Severity: Normal
Resolution: | Keywords:
Triage Stage: Accepted | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
--------------------------------------+-------------------------------
Changes (by aaugustin):

* needs_better_patch: => 0
* component: Uncategorized => Documentation
* needs_tests: => 0
* needs_docs: => 0
* type: Uncategorized => Bug
* stage: Unreviewed => Accepted


Comment:

I confirm the problem.

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

--
Ticket URL: <https://code.djangoproject.com/ticket/16300#comment:1>

Django

unread,
Oct 13, 2014, 11:51:12 AM10/13/14
to django-...@googlegroups.com
#16300: Strange problem when using "make singlehtml" on docs/
-------------------------------+------------------------------------
Reporter: foxwhisper | Owner: nobody
Type: Bug | Status: new

Component: Documentation | Version: 1.3
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+------------------------------------

Comment (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?

--
Ticket URL: <https://code.djangoproject.com/ticket/16300#comment:2>

Django

unread,
Nov 28, 2014, 6:44:11 PM11/28/14
to django-...@googlegroups.com
#16300: Poor header formatting when using "make singlehtml" on docs/
-------------------------------+------------------------------------
Reporter: foxwhisper | Owner: nobody
Type: Bug | Status: new
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+------------------------------------
Changes (by timgraham):

* version: 1.3 => master


Comment:

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.

--
Ticket URL: <https://code.djangoproject.com/ticket/16300#comment:3>

Django

unread,
Jun 19, 2020, 4:22:50 PM6/19/20
to django-...@googlegroups.com
#16300: Poor header formatting when using "make singlehtml" on docs/
-------------------------------+---------------------------------------
Reporter: Cal Leeming | Owner: David Smith
Type: Bug | Status: assigned

Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+---------------------------------------
Changes (by David Smith):

* owner: nobody => David Smith
* status: new => assigned
* has_patch: 0 => 1


Comment:

[https://github.com/django/django/pull/13087 PR]

--
Ticket URL: <https://code.djangoproject.com/ticket/16300#comment:4>

Django

unread,
Jun 22, 2020, 3:05:32 PM6/22/20
to django-...@googlegroups.com
#16300: Poor header formatting when using "make singlehtml" on docs/
-------------------------------+---------------------------------------
Reporter: Cal Leeming | Owner: David Smith
Type: Bug | Status: closed
Component: Documentation | Version: master
Severity: Normal | Resolution: fixed

Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+---------------------------------------
Changes (by GitHub <noreply@…>):

* status: assigned => closed
* resolution: => fixed


Comment:

In [changeset:"be534348f55823093bf7a78bee78ee2d3bb18fdf" be534348]:
{{{
#!CommitTicketReference repository=""
revision="be534348f55823093bf7a78bee78ee2d3bb18fdf"
Fixed #16300 -- Improved singlehtml docs formatting with headers CSS.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/16300#comment:5>

Reply all
Reply to author
Forward
0 new messages