text processing utilities

Ansifilter Dokumentation

Ansifilter Handbuch

ANSI-Codes sind Kommandos, die in der Textausgabe von Kommandozeilentools eingebettet sind um diese Ausgabe zu formatieren. Die Codes werden von Terminal-Emulatoren wie xterm oder Putty ausgewertet.

Ein Beispiel der farbigen colordiff-Ausgabe:

ANSI sample

Ansifilter wertet geläufige ANSI-Codes aus, um diese zu entfernen oder in ein anderes Textformat zu konvertieren (HTML, TeX, LaTeX, RTF, Pango oder BBCode).
ANSI-Art Dateien (basierend auf Codepage 437 und ANSI.SYS-Sequenzen oder BIN/XBIN-Dateien) werden mit der --art-cp437 bzw. der --art-bin Option korrekt eingelesen.

Ansifilter GUI

Das Programm gibt es auch als Kommandozeilenversion:

ansifilter ansifile.txt ergibt:

Several ANSI codes:
Bold
Underline
Black
Red
Green
Red Background
Green Background
Image inverted and back

ansifilter --html ansifile.txt ergibt:

Several ANSI codes:
Bold
Underline
Black
Red
Green
Red Background
Green Background
Image inverted and back

Funktionen

Dies sind die Optionen der Kommandozeilenversion:

File handling:
  -i, --input=<file>     Name of input file
  -o, --output=<file>    Name of output file
  -O, --outdir<dir>      Name of output directory
  -t, --tail             Continue reading after end-of-file (like tail -f)

Output text formats:
  -T, --text (default)   Output text
  -H, --html             Output HTML
  -M, --pango            Output Pango Markup
  -L, --latex            Output LaTeX
  -P, --tex              Output Plain TeX
  -R, --rtf              Output RTF
  -B, --bbcode           Output BBCode

Formatted text options:
  -a, --anchors          Add HTML line anchors (assumes -l)
  -d, --doc-title        Set HTML/LaTeX document title
  -e, --encoding         Set HTML encoding (must match input file encoding)
  -f, --fragment         Omit HTML header and footer
  -F, --font=<font>      Set HTML/RTF font face
  -l, --line-numbers     Print line numbers in output file
  -m, --map=<path>       Read color mapping file (see README)
  -r, --style-ref=<rf>   Set HTML/TeX/LaTeX stylesheet path
  -s, --font-size=<fs>   Set HTML/RTF font size
  -p, --plain            Ignore ANSI formatting information
  -w, --wrap<len>        Wrap long lines
      --wrap-no-numbers  Omit line numbers of wrapped lines (assumes -l)
          
ANSI art options:
      --art-cp437        Parse codepage 437 ANSI art (HTML, RTF output only)
      --art-bin          Parse BIN/XBIN ANSI art (HTML, RTF output only)
      --art-width        Set ANSI art width (default 80)
      --art-height       Set ANSI art height (default 150)

Other options:
  -h, --help             Print help
  -v, --version          Print version and license info

Examples:

ansifilter -i text_with_ansi.txt -o text_without_ansi.txt
ansifilter *.txt
tail -f server.log | ansifilter

Der GUI kann als erster Parameter die Eingabedatei übergeben werden.
Ansifilter kann unter Windows tail -f nachbilden.

Unterstützte ANSI-Sequenzen

Formatierung:
Bold, Underline, Italic, Blink

Farben:
Black, Red, Green, Yellow, Blue, Magenta, Cyan, White, xterm 256 color codes

Andere:
Conceal/Reveal, Image positive/negative

Farbzuordnung

Die 16 Standardfarben können mit einer Color-Map Konfiguration neu definiert werden (--map option).
Dabei wird folgende Zuordnung verwendet:

Normal: Black (0), Red (1), Green (2), Yellow (3), Blue (4), Magenta (5), 
        Cyan (6), Gray (7)
Bright: DarkGray (8), Red (9), Green (10), Yellow (11), Blue (12), Magenta (13),
        Cyan (14), White (15)

Dateiformat: <0..15> = <HTML color code>

Beispiel:

1= #0000aa
2= #00aa00
3= #00aaaa
4= #aa0000
5= #aa00aa
6= #aa5500
7= #aaaaaa
8= #555555
9= #5555ff
10= #55ff55
11= #55ffff
12= #ff5555
13= #ff55ff
14= #ffff55
15= #ffffff
Tupel7