asciidoc Tutorial

asciidoc설치 후 .adoc문서를 .pdf로 변환하는 성공경험을 목적으로 하는 tutorial

 

설치환경 : centOS-7.3-64

 

1. rvm설치

curl -sSL https://get.rvm.io | bash -s stable

(public key 관련 오류 발생 시 하단 '오류처리' 참고)

 

source /etc/profile.d/rvm.sh

 

rvm reload

 

 

rvm list known

 

 

 

2. ruby 설치

rvm install ruby-2.4

 

rvm use 2.4

 

which ruby

 

 

 

3. asciidoctor 설치

gem install asciidoctor

 

 

 

4. coderay 설치

gem install coderay pygments.rb

 

 

 

4. asciidoctor-pdf 설치

gem install --pre asciidoctor-pdf

 

gem install asciidoctor-pdf-cjk-kai_gen_gothic

 

asciidoctor-pdf-cjk-kai_gen_gothic-install

 

 

 

5. adoc문서 pdf변환

sample.adoc 파일을 생성 후 아무 내용이나 작성한다.

(asciidoc문법을 참고해서 만들어 보면 더 좋다.)

sample.doc

아래 명령어를 통해서 .adoc문서를 .pdf로 변환한다.

asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicKR sample.adoc
or
asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-theme=KaiGenGothicJP sample.adoc

sample.pdf

 

 

 

오류처리

rvm설치 중 아래와 같이 오류 발생 시 오류 내용대로 GPG v2 설치 후 public key를 패치해준다.

GPG2 설치

curl -sSL https://rvm.io/mpapis.asc | gpg2

curl -sSL https://rvm.io/pkuczynski.asc | gpg2

public key 패치

gpg2 --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

(public key 값은 변경되었을 수 있으니 오류내용에서 직접 복사하여 사용)

 

public key 패치 후 다시 rmv설치를 시도해보면 정상적으로 처리 된다.