Scroll to navigation

aha(1) Ansi HTML Adapter aha(1)


aha - Ansi HTML Adapter


aha [options] [-f file]


aha takes SGR-colored Input and prints W3C conform HTML-Code.
aha reads the Input from a file or stdin and writes HTML-Code to stdout.


--help , -h , -?
A help like this
--black , -b
Black Background and white "standard color"
--pink , -p
Pink Background
--stylesheet , -s
Use a stylesheet instead of inline styles
--iso X , -i X
Uses ISO 8859-X instead of utf-8. X must be 1..16
--title X , -t X
Gives the html output the title "X" instead of stdin or the filename
--line-fix , -l
Uses a fix for inputs using control sequences to change the cursor position like htop. It's a hot fix, it may not work with any program like htop. (See EXAMPLE)
--word-wrap , -w
Wrap long lines in the html file. This works with CSS3 supporting browsers as well as many older ones.
--no-header , -n
Don't include header into generated HTML, useful for inclusion in full HTML files.


aha --help | aha --black --title "the awesome aha help"> aha-help.htm
Creates an HTML file with the help of aha with black background
colordiff oldfile.c newfile.c | aha > colordiff.htm
Creates an HTML file with a colorful diff-output of two files "oldfile.c" and "newfile.c" with white background
ls --color=always | aha --pink > ls.htm
Creates an HTML file with a colorful ls-output with pink background.
echo q | htop | aha --black --line-fix > htop.htm
Creates an HTML file with the output of htop. You have to use --line-fix due the other new-line-commands htop uses.
MAN_KEEP_FORMATTING=1 COLUMNS=80 man aha | ul | aha > man-aha.htm
Creates an HTML file with the man page of aha. Man uses nroff's bold and underline, which ul converts to SGR.


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


Copyleft Alexander Matthes aka Ziz 2018

October 26, 2018