aha(1)                             Ansi HTML Adapter                             aha(1)

NAME
        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 posi‐
              tion 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-decora‐
       tion: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 2017
       ziz@mailbox.org

SEE ALSO
       https://github.com/theZiz/aha

                                   February 21, 2017                             aha(1)