diff --git a/ChangeLog b/ChangeLog index e7da604f1..e07184026 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,18 @@ +2014-11-29 Werner Lemberg + + [docmaker] Provide higher-level markup and simplify HTML. + + * src/tools/docmaker/tohtml.py: Instead of using extraneous `
' + elements, use CSS descendants (of class `section') to format the + data. + + Also remove reduntant

and
elements, replacing them with + proper CSS. + + Globally reduce page width to 75%. + + (block_header): Rename

class to `section'. + 2014-11-29 Werner Lemberg [docmaker] Add `top' links after blocks. diff --git a/src/tools/docmaker/tohtml.py b/src/tools/docmaker/tohtml.py index 74b8e0c7e..da9eb2cb5 100644 --- a/src/tools/docmaker/tohtml.py +++ b/src/tools/docmaker/tohtml.py @@ -41,28 +41,34 @@ html_header_2 = """\ body { font-family: Verdana, Geneva, Arial, Helvetica, serif; color: #000000; - background: #FFFFFF; } + background: #FFFFFF; + width: 87%; + margin: auto; } - div.code { width: 100%; - background-color: #D6E8FF; - margin: 0 0 0 -0.5em; - padding: 0.3ex 0 0.3ex 0.5em; } - div.indent1 { width: 87%; - margin: auto; } div.indent2 { width: 75%; margin: auto; } + div.section { width: 75%; + margin: auto; } + div.section hr { margin: 4ex 0 1ex 0; } + div.section h4 { background-color: #EEEEFF; + font-size: medium; + font-style: oblique; + font-weight: bold; + margin: 3ex 0 1.5ex 9%; + padding: 0.3ex 0 0.3ex 1%; } + div.section p { margin: 1.5ex 0 1.5ex 10%; } + div.section pre { margin: 3ex 0 3ex 9%; + background-color: #D6E8FF; + padding: 2ex 0 2ex 1%; } + div.section table.fields { width: 90%; + margin: 1.5ex 0 1.5ex 10%; } div.timestamp { text-align: center; - font-size: 69%; } + font-size: 69%; + margin: 1.5ex 0 1.5ex 0; } h1 { text-align: center; } - h3 { font-size: medium; } - h4 { background-color: #EEEEFF; - width: 100%; - font-size: medium; - font-style: oblique; - font-weight: bold; - margin: 0 0 0 -0.5em; - padding: 0.3ex 0 0.3ex 0.5em; } + h3 { font-size: medium; + margin: 4ex 0 1.5ex 0; } li { text-align: justify; } @@ -76,9 +82,6 @@ html_header_2 = """\ color: darkblue; } table.center { margin: auto; } - table.fields { border: 0; - border-spacing: 0; - width: 100%; } table.fields td.val { font-weight: bold; text-align: right; width: 30%; @@ -86,7 +89,7 @@ html_header_2 = """\ padding: 0 1em 0 0; } table.fields td.desc { vertical-align: baseline; padding: 0 0 0 1em; } - table.index { margin: auto; + table.index { margin: 6ex auto 6ex auto; border: 0; border-collapse: separate; border-spacing: 1em 0.3ex; } @@ -94,7 +97,8 @@ html_header_2 = """\ table.index td { padding: 0; } table.index-toc-link { width: 100%; border: 0; - border-spacing: 0; } + border-spacing: 0; + margin: 1ex 0 1ex 0; } table.index-toc-link td.left { padding: 0 0.5em 0 0.5em; font-size: 83%; text-align: left; } @@ -112,6 +116,7 @@ html_header_2 = """\ table.synopsis td { padding: 0; } td { padding: 0 0.5em 0 0.5em; } + td.desc p { margin: 1.5ex 0 1.5ex 0; } td.left { padding: 0 0.5em 0 0.5em; text-align: left; } @@ -130,8 +135,7 @@ html_header_3r = """ """ html_header_4 = """\ -">Index] -[Index][ - +">Index]\ +\ " print section_synopsis_footer print description_header @@ -607,9 +610,9 @@ class HtmlFormatter( Formatter ): # + " '" + block.source.filename + "'.\n" ) if header: - print header_location_header - print 'Defined in ' + header + '.' - print header_location_footer + print ( header_location_header + + 'Defined in ' + header + '.' + + header_location_footer ) print source_header for l in block.code: