Return to style.css CVS log

Up to [cvsweb.bsd.lv] / mandoc

Use <em> for .Em and .Bf -emphasis.

The vast majority of .Em in real-world manuals is stress emphasis,
for which <em> is the correct markup.  Admittedly, there are some
instances of .Em usage for alternate quality, for which <i> would
be a better match.  Most of these are technical terms that neither
allow semantic markup nor are keywords - for the latter, .Sy would
be preferable.  A typical example is that the shell breaks input into
.Em words .
Alternate voice or mood, which would also require <i>, is almost
absent from manuals.
We cannot satisfy both stress emphasis and alternate quality, so
pick the one that fits more often and looks less wrong when off.

Patch from Guy Harris <guy at alum dot mit dot edu>.
ok joerg@ bentley@

/* $Id: style.css,v 1.26 2014/08/13 15:25:22 schwarze Exp $ */

/*
 * This is an example style-sheet provided for mandoc(1) and the -Thtml
 * or -Txhtml output mode.
 *
 * It mimics the appearance of the traditional cvsweb output.
 *
 * See mdoc(7) and man(7) for macro explanations.
 */

html		{ max-width: 880px; margin-left: 1em; }
body		{ font-size: smaller; font-family: Helvetica,Arial,sans-serif; }
h1		{ margin-bottom: 1ex; font-size: 110%; margin-left: -4ex; } /* Section header (Sh, SH). */
h2		{ margin-bottom: 1ex; font-size: 105%; margin-left: -2ex; } /* Sub-section header (Ss, SS). */
table		{ width: 100%; margin-top: 0ex; margin-bottom: 0ex; } /* All tables. */
td		{ vertical-align: top; } /* All table cells. */
p		{ } /* Paragraph: Pp, Lp. */
blockquote	{ margin-left: 5ex; margin-top: 0ex; margin-bottom: 0ex; } /* D1. */
div.section	{ margin-bottom: 2ex; margin-left: 5ex; } /* Sections (Sh, SH). */
div.subsection	{ } /* Sub-sections (Ss, SS). */
table.synopsis	{ } /* SYNOPSIS section table. */

/* Preamble structure. */

table.foot	{ font-size: smaller; margin-top: 1em; border-top: 1px dotted #dddddd; } /* Document footer. */
td.foot-date	{ width: 50%; } /* Document footer: date. */
td.foot-os	{ width: 50%; text-align: right; } /* Document footer: OS/source. */
table.head	{ font-size: smaller; margin-bottom: 1em; border-bottom: 1px dotted #dddddd; } /* Document header. */
td.head-ltitle	{ width: 10%; } /* Document header: left-title. */
td.head-vol	{ width: 80%; text-align: center; } /* Document header: volume. */
td.head-rtitle	{ width: 10%; text-align: right; } /* Document header: right-title. */

/* General font modes. */

i		{ } /* Italic: BI, IB, I, (implicit). */
em		{ font-style: italic; font-weight: normal; } /* Emphasis: Em, Bl -emphasis. */
b		{ } /* Bold: SB, BI, IB, BR, RB, B, (implicit). */
.symb		{ font-style: normal; font-weight: bold; } /* Symbolic: Sy, Ms, Bf -symbolic. */
small		{ } /* Small: SB, SM. */
.lit		{ font-style: normal; font-weight: normal; font-family: monospace; } /* Literal: Dl, Li, Ql, Bf -literal, Bl -literal, Bl -unfilled. */

/* Block modes. */

.display	{ } /* Top of all Bd, D1, Dl. */
.list		{ } /* Top of all Bl. */

/* Context-specific modes. */

i.addr		{ font-weight: normal; } /* Address (Ad). */
i.arg		{ font-weight: normal; } /* Command argument (Ar). */
span.author	{ } /* Author name (An). */
b.cmd		{ font-style: normal; } /* Command (Cm). */ 
b.config	{ font-style: normal; } /* Config statement (Cd). */
span.define	{ } /* Defines (Dv). */
span.desc	{ } /* Nd.  After em-dash. */
b.diag		{ font-style: normal; } /* Diagnostic (Bl -diag). */
span.env	{ } /* Environment variables (Ev). */
span.errno	{ } /* Error string (Er). */
i.farg		{ font-weight: normal; } /* Function argument (Fa, Fn). */
i.file		{ font-weight: normal; } /* File (Pa). */
b.flag		{ font-style: normal; } /* Flag (Fl, Cm). */
b.fname		{ font-style: normal; } /* Function name (Fa, Fn, Rv). */
i.ftype		{ font-weight: normal; } /* Function types (Ft, Fn). */
b.includes	{ font-style: normal; } /* Header includes (In). */
span.lib	{ } /* Library (Lb). */
i.link-sec	{ font-weight: normal; } /* Section links (Sx). */
b.macro		{ font-style: normal; } /* Macro-ish thing (Fd). */
b.name		{ font-style: normal; } /* Name of utility (Nm). */
span.opt	{ } /* Options (Op, Oo/Oc). */
span.ref	{ } /* Citations (Rs). */
span.ref-auth	{ } /* Reference author (%A). */
i.ref-book	{ font-weight: normal; } /* Reference book (%B). */
span.ref-city	{ } /* Reference city (%C). */
span.ref-date	{ } /* Reference date (%D). */
i.ref-issue	{ font-weight: normal; } /* Reference issuer/publisher (%I). */
i.ref-jrnl	{ font-weight: normal; } /* Reference journal (%J). */
span.ref-num	{ } /* Reference number (%N). */
span.ref-opt	{ } /* Reference optionals (%O). */
span.ref-page	{ } /* Reference page (%P). */
span.ref-corp	{ } /* Reference corporate/foreign author (%Q). */
span.ref-rep	{ } /* Reference report (%R). */
span.ref-title	{ text-decoration: underline; } /* Reference title (%T). */
span.ref-vol	{ } /* Reference volume (%V). */
span.type	{ font-style: italic; font-weight: normal; } /* Variable types (Vt). */
span.unix	{ } /* Unices (Ux, Ox, Nx, Fx, Bx, Bsx, Dx). */
b.utility	{ font-style: normal; } /* Name of utility (Ex). */
b.var		{ font-style: normal; } /* Variables (Rv). */

a.link-ext	{ } /* Off-site link (Lk). */
a.link-includes	{ } /* Include-file link (In). */
a.link-mail	{ } /* Mailto links (Mt). */
a.link-man	{ } /* Manual links (Xr). */
a.link-ref	{ } /* Reference section links (%Q). */
a.link-sec	{ } /* Section links (Sx). */

/* Formatting for lists.  See mdoc(7). */

dl.list-diag	{ }
dt.list-diag	{ }
dd.list-diag	{ }

dl.list-hang	{ }
dt.list-hang	{ }
dd.list-hang	{ }

dl.list-inset	{ }
dt.list-inset	{ }
dd.list-inset	{ }

dl.list-ohang	{ }
dt.list-ohang	{ }
dd.list-ohang	{ margin-left: 0ex; }

dl.list-tag	{ }
dt.list-tag	{ }
dd.list-tag	{ }

table.list-col	{ }
tr.list-col	{ }
td.list-col	{ }

ul.list-bul	{ list-style-type: disc; padding-left: 1em; }
li.list-bul	{ }

ul.list-dash	{ list-style-type: none; padding-left: 0em; }
li.list-dash:before { content: "\2014  "; }

ul.list-hyph	{ list-style-type: none; padding-left: 0em; }
li.list-hyph:before { content: "\2013  "; }

ul.list-item	{ list-style-type: none; padding-left: 0em; }
li.list-item	{ }

ol.list-enum	{ padding-left: 2em; }
li.list-enum	{ }

/* Equation modes.  See eqn(7). */

span.eqn	{ }

/* Table modes.  See tbl(7). */

table.tbl	{ }