aha(1) - f32

1aha(1)                         Ansi HTML Adapter                        aha(1)
2
3
4

NAME

6        aha - Ansi HTML Adapter
7
8

SYNOPSIS

10       aha [options] [-f file]
11
12

DESCRIPTION

14       aha takes SGR-colored Input and prints W3C conform HTML-Code.
15       aha  reads  the Input from a file or stdin and writes HTML-Code to std‐
16       out.
17

OPTIONS

19       --help , -h , -?
20              A help like this
21
22       --black , -b
23              Black Background and white "standard color"
24
25       --pink , -p
26              Pink Background
27
28       --stylesheet , -s
29              Use a stylesheet instead of inline styles
30
31       --iso X , -i X
32              Uses ISO 8859-X instead of utf-8. X must be 1..16
33
34       --title X , -t X
35              Gives the html output the title "X"  instead  of  stdin  or  the
36              filename
37
38       --line-fix , -l
39              Uses a fix for inputs using control sequences to change the cur‐
40              sor position like htop. It's a hot fix, it may not work with any
41              program like htop. (See EXAMPLE)
42
43       --word-wrap , -w
44              Wrap  long lines in the html file. This works with CSS3 support‐
45              ing browsers as well as many older ones.
46
47       --no-header , -n
48              Don't include header into generated HTML, useful  for  inclusion
49              in full HTML files.
50
51

EXAMPLE

53       aha --help | aha --black --title "the awesome aha help"> aha-help.htm
54              Creates an HTML file with the help of aha with black background
55
56       colordiff oldfile.c newfile.c | aha > colordiff.htm
57              Creates  an  HTML  file with a colorful diff-output of two files
58              "oldfile.c" and "newfile.c" with white background
59
60       ls --color=always | aha --pink > ls.htm
61              Creates an HTML file with a colorful ls-output with  pink  back‐
62              ground.
63
64       echo q | htop | aha --black --line-fix > htop.htm
65              Creates  an  HTML  file with the output of htop. You have to use
66              --line-fix due the other new-line-commands htop uses.
67
68       MAN_KEEP_FORMATTING=1 COLUMNS=80 man aha | ul | aha > man-aha.htm
69              Creates an HTML file with the man page of aha. Man uses  nroff's
70              bold and underline, which ul converts to SGR.
71
72

KNOWN BUGS

74       This is not really a bug, but neither <blink> nor the css setting text-
75       decoration:blink work on modern browsers, so if one wants to see blink‐
76       ing  text one has to use --stylesheet and to redefine .blink to make it
77       visible. But maybe we should just accept the death of blinking text...
78
79

AUTHOR

81       Copyleft Alexander Matthes aka Ziz 2018
82       ziz@mailbox.org
83
84