2 .\" # Copyright (c) 2015, Juniper Networks, Inc.
3 .\" # All rights reserved.
4 .\" # This SOFTWARE is licensed under the LICENSE provided in the
5 .\" # ../Copyright file. By downloading, installing, copying, or
6 .\" # using the SOFTWARE, you agree to be bound by the terms of that
8 .\" # Phil Shafer, July 2014
15 .Nd display libxo html output
22 .Op Ar command argument...
25 is a tool for preparing
27 HTML output for display in modern HTML web browsers.
29 can operate in two modes.
30 If command is provided
33 option or as argument(s) to the
35 command, that command is executed and the resulting output is processed.
36 If no command is given, the
37 standard input is used.
40 is typically used to wrap
42 output with sufficient HTML content to allow display in a web browser.
43 This includes parent HTML tags as well as
49 If the command is given directly on the command line,
51 will add the "--libxo=html" option needed to generate HTML output
58 The following options are available:
59 .Bl -tag -width indent
60 .It Ic -b Ar base | Ic --base Ar base
61 Supplies a source path for the CSS and Javascript files referenced in
64 .It Ic -c Ar command | Ic --command Ar command
65 Use the given command instead of one on the command line.
66 This command should be quoted if it consists of multiple tokens, and
67 should contain the "--libxo=html" option or equivalent, since the
68 command is used directly.
69 .It Ic -f Ar file | Ic --file Ar file
70 Output is saved to the given file, rather than to the standard output
75 The following command line will run "du --libxo=html ~/src" and save
76 the output to /tmp/src.html:
77 .Bd -literal -offset indent
78 xohtml du ~/src > /tmp/src.html
81 The following command line will run "du --libxo=html,warn ~/src" and save
82 the output to /tmp/src.html:
83 .Bd -literal -offset indent
84 du --libxo=html,warn ~/src | xohtml -f /tmp/src.html
87 The following command line will run "du --libxo=html,warn ~/src" and save
88 the output to /tmp/src.html:
89 .Bd -literal -offset indent
90 xohtml -c "du --libxo=html,warn ~/src" -f /tmp/src.html