table of contents
other sections
aha(1) | Ansi HTML Adapter | aha(1) |
NAME¶
aha - Ansi HTML AdapterSYNOPSIS¶
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 2018ziz@mailbox.org
SEE ALSO¶
https://github.com/theZiz/ahaOctober 26, 2018 |