#빠른 시작

Gukhanmun은 한자가 포함된 텍스트를 읽어, 한자를 그 한글 독음으로 바꾼 텍스트를 씁니다.

#파일 변환

파일 경로를 위치 인수로 넘깁니다:

gukhanmun input.txt

출력은 기본적으로 표준 출력으로 갑니다. 대신 파일로 쓰려면 -o를 사용합니다:

gukhanmun -o output.txt input.txt

파일을 제자리에서 바꾸려면, 입력과 출력에 같은 경로를 넘깁니다. Gukhanmun은 먼저 임시 파일에 쓴 뒤 원본을 원자적으로 치환하므로, 원본이 일부만 쓰인 상태로 남는 일이 결코 없습니다:

gukhanmun -o document.txt document.txt

#표준 입력에서 읽기

표준 입력에서 읽으려면 파일 인수를 생략합니다:

echo "漢字를 한글로" | gukhanmun
# → 한자를 한글로

#입력 형식 지정

Gukhanmun은 파일 확장자로부터 형식을 추론합니다:

감지된 형식은 -f로 덮어쓸 수 있습니다:

gukhanmun -f text/plain input.html      # 純粹 텍스트로 다룸
gukhanmun -f text/html  snippet.txt     # HTML로 다룸
gukhanmun -f text/markdown article.txt  # Markdown으로 다룸

Markdown 형식은 변종 파라미터도 받습니다:

gukhanmun -f "text/markdown; variant=GFM" post.md

#상세 로깅

표준 오류로 디버그 정보를 출력하려면 -v를 더합니다:

gukhanmun -v input.txt