aha man page

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.

Known Bugs

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

See Also



October 26, 2018 Ansi HTML Adapter