summaryrefslogtreecommitdiffstats
path: root/mandoc.css
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2017-01-25 02:14:43 +0000
committerIngo Schwarze <schwarze@openbsd.org>2017-01-25 02:14:43 +0000
commit75f0aa87c57b152c84c7f856cb1ab705769c6478 (patch)
treebdc6aeee5b3f0315cb57f4964f4d43ac809aafb9 /mandoc.css
parent2678c5ab0377c06b6806c2fafd2df37e3c7d23c7 (diff)
downloadmandoc-75f0aa87c57b152c84c7f856cb1ab705769c6478.tar.gz
Improve HTML formatting of .Bl -tag.
In particular, when using the style sheet, put the body on the same line as the head for short heads, or on the next line for long heads, in a way that preserves both correct indentation and correct vertical spacing with and without -compact, and with one or more heads per body (hi, Zaphod) - eight use cases so far - and with and without -tag, and with and without -offset, 32 use cases grand total. Using many ideas from zhuk@, from <David dot Dahlberg at fkie dot fraunhofer dot de>, and from Benny Lofgren <bl dash lists at lofgren dot biz>, and a few of my own. This is an excellent demonstration that CSS is an extremely hostile language, much more trapful and much harder to use than, say, C. When matthew@ reported this in July 2014 (!), it was already a known issue, and i no longer remember for how long. My first serious attempt at fixing it (in November 2015) failed miserably. I'd love to see simplifications of both the generated HTML code and of the style sheet, but without breaking any of the 32 use cases, please.
Diffstat (limited to 'mandoc.css')
-rw-r--r--mandoc.css15
1 files changed, 12 insertions, 3 deletions
diff --git a/mandoc.css b/mandoc.css
index 582ac39a..3f0b03b5 100644
--- a/mandoc.css
+++ b/mandoc.css
@@ -91,9 +91,18 @@ dd.It-inset { }
dl.Bl-ohang { }
dt.It-ohang { }
dd.It-ohang { margin-left: 0ex; }
-dl.Bl-tag { }
-dt.It-tag { }
-dd.It-tag { }
+dl.Bl-tag { margin-left: 8ex; }
+dt.It-tag { float: left;
+ clear: both;
+ margin-top: 0ex;
+ margin-left: -8ex;
+ padding-right: 2ex;
+ vertical-align: top; }
+dd.It-tag { width: 100%;
+ margin-top: 0ex;
+ margin-left: 0ex;
+ vertical-align: top;
+ overflow: auto; }
table.Bl-column { }
tr.It-column { }