Asciidoc adoc 파일 pdf 변환시 한글 폰트 해결 팁 (잔머리)

Asciidoc을 이용해서 html pdf 내보내기 되고, 마크다운 같이 관리되고 다 좋은데 이것 참 pdf export 하면 기본적으로 한글이 네모난 칸으로 나오는 문제가 발생. 많은 해결했다는 곳들이 있지만, 나만의 팁을 공개. 최적은 아니어도 일단 됨

 

일단 한글 폰트 ttf 파일을 구해야 한다. 이건 어디서든 받을 수 있으니 일단 생략.

그리고는 다운도르 받은 폰트 파일을 아래 위치에 복사해 둔다.

 

나는 Ruby에서 \asciidoctor-pdf-1.5.4 가 설치되어 있으니 아래 위치인데 각자 설치한 위치에 비슷한 공간에 두면 된다.

asciidoctor-pdf 폰트 복사

여기에 폰트가 없으면 잘 안되서 그냥 여기에 뒀다. 다른 방법이 있으면 더 좋은데 이미 설치된 폰트파일에서 가져오는 것 처럼 말이다...무튼...

 

이젠 템플릿 혹은 테마 theme 파일을 좀 손봐주면 된다. 기본적으로 쓰이는 템플릿 파일의 위치는 아래와 같다.

asciidoctor-pdf theme 위치

default-theme.yml 파일을 열어서, 기본 폰트를 아까 복사한 폰트들로 바꿔 준다.

딱 맞지 않지만, 그냥 구색에 맞게 대충 해본다. 한글로 바뀌는게 목적이니깐~~~~

 

asciidoctor-pdf them 한글 폰트로 수정

진짜 다른건 건드리지 말고 ttf 파일 위치만 바꾼다. 

다른걸 손대기 시작하면 끝이 없다.

 

이제 convert 해보자.

명령어는 아래와 같다.

asciidoctor-pdf ./book.adoc -o ./publication/book.pdf

-o 옵션은 그냥 결과물을 여기로 보내달라는 것이니 해도 되고 안해도 되고

결과는 아래처럼 한글이 잘 나온다.

asciidoctor-pdf 한글 변환 완료

끝.

 

Asciidoc 사용법은 많은 링크들이 있으니 참고들 하시고, 일단 아래 링크도 들어가 보세요.

narusas.github.io/2018/03/21/Asciidoc-basic.html

Asciidoc 기본 사용법

Asciidoc 을 테스트 하게 된 동기 글, 소스코드처럼 문서 관리하기

www.whatap.io/ko/blog/34/

소스코드처럼 문서 관리하기 | 와탭 블로그

여기는 잘 되어 있네요. 문서들이 한글 영문 관계없이, yml 은 파일은 보이지 않아 어떻게 한 것인지는 모르고 ㅎㅎ

 

BJ.