[BACK]Return to mandoc.1 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.264 and 1.265

version 1.264, 2023/04/28 18:55:09 version 1.265, 2023/10/18 14:34:29
Line 345  conforms to HTML5 using optional self-closing tags.
Line 345  conforms to HTML5 using optional self-closing tags.
 Equations rendered from  Equations rendered from
 .Xr eqn 7  .Xr eqn 7
 blocks use MathML.  blocks use MathML.
 .Pp  
 The file  
 .Pa /usr/share/misc/mandoc.css  
 documents style-sheet classes available for customising output.  
 If a style-sheet is not specified with  
 .Fl O Cm style ,  
 .Fl T Cm html  
 defaults to simple output (via an embedded style-sheet)  
 readable in any graphical or text-based web  
 browser.  
 .Pp  
 Non-ASCII characters are rendered  Non-ASCII characters are rendered
 as hexadecimal Unicode character references.  as hexadecimal Unicode character references.
 .Pp  .Pp
Line 406  otherwise, the second format is used.
Line 395  otherwise, the second format is used.
 .It Cm style Ns = Ns Ar style.css  .It Cm style Ns = Ns Ar style.css
 The file  The file
 .Ar style.css  .Ar style.css
 is used for an external style-sheet.  is used as an external stylesheet.
 This must be a valid absolute or  This must be a valid absolute or
 relative URI.  relative URI.
   .Pp
   Using the file
   .Pa mandoc.css
   that is distributed with
   .Nm
   is recommended.
   It provides an appearance similar to terminal output with some additional
   features specific to
   .Nm
   HTML output, in particular making anchor locations that support
   deep linking stand out visually by putting a dotted line under them,
   providing tooltips showing the semantic function of elements (macro
   names), providing some simple aspects of responsive web design, and
   providing simple support for users who prefer a dark color scheme.
   .Pp
   Using a custom CSS file is possible, but writing it requires
   proficiency in all of the languages HTML 5, CSS 4, and
   .Xr mdoc 7
   and familiarity with the
   .Nm Ns -specific
   classes used in
   .Pa mandoc.css .
   Besides, while the file
   .Pa mandoc.css
   is always adapted to the HTML output generated by the
   .Nm
   version it is distributed with, maintaining a custom CSS file usually
   requires adaptations each time
   .Nm
   is upgraded to a new version.
   .Pp
   If a stylesheet is not specified with
   .Fl O Cm style ,
   .Fl T Cm html
   embeds a minimal stylesheet into the HTML output, mostly to select
   adequate font-style and font-weight attributes for various macros.
   The result is readable in any graphical or text-based web browser,
   but does not aim for looking similar to terminal output.
   Instead, formatting is mostly left to browser defaults
   and to user settings in the browser configuration.
 .It Cm tag Ns Op = Ns Ar term  .It Cm tag Ns Op = Ns Ar term
 Same syntax and semantics as for  Same syntax and semantics as for
 .Sx ASCII Output .  .Sx ASCII Output .
Line 738  To page manuals to the terminal:
Line 767  To page manuals to the terminal:
 .Pp  .Pp
 To produce HTML manuals with  To produce HTML manuals with
 .Pa /usr/share/misc/mandoc.css  .Pa /usr/share/misc/mandoc.css
 as the style-sheet:  as the stylesheet:
 .Pp  .Pp
 .Dl $ mandoc \-T html -O style=/usr/share/misc/mandoc.css mdoc.7 > mdoc.7.html  .Dl $ mandoc \-T html -O style=/usr/share/misc/mandoc.css mdoc.7 > mdoc.7.html
 .Pp  .Pp
Legend:
Removed from v.1.264  
changed lines
  Added in v.1.265
CVSweb