aha man page

aha ā€” Ansi HTML Adapter

Synopsis

aha [options] [-f file]

Description

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.

Options

--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.

Example

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...

Author

Copyleft Alexander Matthes aka Ziz 2018
ziz@mailbox.org

See Also

https://github.com/theZiz/aha

Info

October 26, 2018 Ansi HTML Adapter