ASCIIDOCTOR 사용법

• 참고: How to Convert AsciiDoc to PDF with Asciidoctor asciidoctor 는 루비언어로 작성되어 있어, 실행하기 위해서는 루비가 설치되어 있어야 한다.

프로젝트 상태

Asciidoctor PDF는 현재 알파 상태이다.

1. ruby 설치

$ sudo apt-get install ruby

2. asciidoctor 설치

$ sudo gem install asciidoctor

3. coderay 설치

$ sudo gem install coderay pygments.rb

4. asciidoctor-pdf 설치

$ sudo gem install --pre asciidoctor-pdf

5. asciidoctor-pdf-cjk-kai_gen_gothic 설치

asciidoctor-pdf 만 이용해서 PDF를 만들면 한글이 제대로 출력되지 않는다. asciidoctor-pdf 에서 사용할 폰트 gem 을 추가로 설치해야 한다.

$ sudo gem install asciidoctor-pdf-cjk-kai_gen_gothic

6. asciidoctor-pdf-cjk-kai_gen_gothic 설치

$ sudo asciidoctor-pdf-cjk-kai_gen_gothic-install
[1/20] Downloading KaiGenGothicCN-Bold-Italic.ttf
[2/20] Downloading KaiGenGothicCN-Bold.ttf
[3/20] Downloading KaiGenGothicCN-Regular-Italic.ttf
[4/20] Downloading KaiGenGothicCN-Regular.ttf
[5/20] Downloading KaiGenGothicJP-Bold-Italic.ttf
[6/20] Downloading KaiGenGothicJP-Bold.ttf
[7/20] Downloading KaiGenGothicJP-Regular-Italic.ttf
[8/20] Downloading KaiGenGothicJP-Regular.ttf
[9/20] Downloading KaiGenGothicKR-Bold-Italic.ttf
[10/20] Downloading KaiGenGothicKR-Bold.ttf
[11/20] Downloading KaiGenGothicKR-Regular-Italic.ttf
[12/20] Downloading KaiGenGothicKR-Regular.ttf
[13/20] Downloading KaiGenGothicTW-Bold-Italic.ttf
[14/20] Downloading KaiGenGothicTW-Bold.ttf
[15/20] Downloading KaiGenGothicTW-Regular-Italic.ttf
[16/20] Downloading KaiGenGothicTW-Regular.ttf
[17/20] Downloading RobotoMono-Bold.ttf
[18/20] Downloading RobotoMono-BoldItalic.ttf
[19/20] Downloading RobotoMono-Italic.ttf
[20/20] Downloading RobotoMono-Regular.ttf

7. pdf 만들기

asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicKR example.adoc

참고

• How to Convert AsciiDoc to PDF with Asciidoctor
• Asciidoctor PDF: A native PDF converter for AsciiDoc