summaryrefslogtreecommitdiff
path: root/FAQ.txt
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2020-09-04 16:55:24 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2020-09-04 16:55:24 +0000
commitd5dbf3afcb6ea5c9eda49cedb4d97e6707ec68cb (patch)
tree664864711aaf599386c081c9ab8c1ba0e3aaf11a /FAQ.txt
parent3690326351f516e0fe50aad0c8a5f457c0e4c7fa (diff)
downloaddocutils-d5dbf3afcb6ea5c9eda49cedb4d97e6707ec68cb.tar.gz
Change the `initial_header_level`_ setting's default to "2"
Browsers use the `same style for <h1> and <h2> when it's nested in a section`. cf. https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8556 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'FAQ.txt')
-rw-r--r--FAQ.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/FAQ.txt b/FAQ.txt
index 88fc0da14..4bb4aad65 100644
--- a/FAQ.txt
+++ b/FAQ.txt
@@ -995,6 +995,11 @@ without H2).
(Thanks to Mark McEahern for the question and much of the answer.)
+.. note:: For the html5 writer, `initial_header_level`_ defaults to
+ ``2`` because this is what the `HTML5 standard`__ expects as
+ start value for headings nested in <section> elements.
+
+ __ https://www.w3.org/TR/html53/sections.html#headings-and-sections
How are lists formatted in HTML?
--------------------------------