ansifilter

ANSI 코드 처리

ansifilter는 Bold, Underline, Italic, Blink과 같은 서식 코드 및 Black, Red, Green, Yellow, Blue, Magenta, Cyan, White과 같은 기본 색상 코드를 비롯해 xterm 256색 코드를 인식하고 처리합니다. Conceal/Reveal 및 Image positive/negative와 같은 특수 코드도 지원합니다.

다양한 출력 형식 지원

다음 형식으로 출력을 생성할 수 있습니다:

• -T, –text: 일반 텍스트 (기본값)
• -H, –html: HTML 형식
• -M, –pango: Pango 마크업
• -L, –latex: LaTeX 형식
• -P, –tex: 일반 TeX 형식
• -R, –rtf: RTF 형식
• -S, –svg: SVG 형식
• -B, –bbcode: BBCode 형식

파일 처리 옵션

-i, –input=: 입력 파일 지정
-o, –output=: 출력 파일 지정
-O, –outdir=: 출력 디렉터리 지정
-t, –tail: 파일 끝 이후 계속 읽기 (tail -f와 유사)
-f, –fragment: HTML 헤더 및 푸터 생략
-l, –line-numbers: 출력 파일에 줄 번호 출력
-w, –wrap=: 긴 줄을 지정된 길이로 줄바꿈
–no-trailing-nl: 줄바꿈 문자 없이 출력
–no-version-info: 버전 정보 주석 생략

ANSI 아트 처리

–art-cp437: Codepage 437 기반 ANSI 아트 처리 (HTML 및 RTF 출력)
–art-bin: BIN/XBIN ANSI 아트 처리 (HTML 출력, stdin 불가)
–art-tundra: Tundra ANSI 아트 처리 (HTML 출력, stdin 불가)
–art-width, –art-height: ANSI 아트 너비 및 높이 설정 (기본값: 80×150)
–art-width, –art-height, –map 옵션은 BIN/XBIN/TND 파일 처리 시 우선 적용됩니다.

SVG 출력 옵션

–width: 이미지 너비 설정
–height: 이미지 높이 설정 (단위 허용)

기타 유용한 옵션

-d, –doc-title: HTML/LaTeX/SVG 문서 제목 설정
-e, –encoding=: HTML/RTF 인코딩 설정 (입력 파일 인코딩과 일치해야 함)
-k, –ignore-clear(=0): ESC K 클리어 명령 무시 여부 설정
-m, –map=: 색상 매핑 파일 경로 지정
-r, –style-ref=: HTML/TeX/LaTeX/SVG 스타일시트 경로 설정
-s, –font-size=: HTML/RTF/SVG 글꼴 크기 설정
-F, –font=: HTML/RTF/SVG 글꼴 얼굴 설정
-p, –plain: ANSI 서식 정보 무시
–derived-styles: 동적 스타일시트 출력 (HTML/SVG)
-h, –help: 도움말 출력
-v, –version: 버전 및 라이선스 정보 출력

기본 사용법

ansifilter를 사용하는 기본 방법은 다음과 같습니다:

ANSI 코드가 포함된 입력 파일을 일반 텍스트로 변환:

ansifilter -i input.ansi -o output.txt

HTML 형식으로 변환:

ansifilter –html input.ansi -o output.html

여러 파일을 한 번에 처리:

ansifilter *.txt

실시간 로그 모니터링 (tail -f와 유사):

tail -f server.log | ansifilter

GUI 버전도 존재하며, 첫 번째 명령줄 인수를 입력 파일 이름으로 받아들입니다.

환경 변수

명령줄 버전은 다음 환경 변수를 인식합니다:

ANSIFILTER_OPTIONS: 명령줄 옵션을 포함할 수 있으나, 입력 파일 경로는 포함할 수 없습니다.

색상 매핑

기본 ANSI 색상 세트는 –map 옵션을 통해 색상 매핑 파일로 조정할 수 있습니다. 이 파일은 다음 형식으로 구성됩니다:

<0..15> = <HTML 색상 코드>

예시:

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

제한 사항·확인 사항

BIN, XBIN 및 TND 형식의 ANSI 아트 파일은 표준 입력(stdin)으로부터 읽을 수 없습니다. 이러한 형식은 –art-bin 또는 –art-tundra 옵션 사용 시 반드시 파일 경로를 지정해야 합니다.

XBIN 파일을 처리할 경우 –art-width, –art-height 및 –map 옵션이 재정의됩니다.

업데이트 정보

현재 버전은 2.20이며, 마지막 업데이트 날짜는 2017년 7월 25일입니다.