= Asciidoctor PDF 환경설정
Heywon Choi <heywon.choi@bankwareglobal.com>

[abstract]
.문서개요
--
이 문서는 Asciidoctor PDF를 이용하기 위해 필요한 환경 설정에 대해 설명합니다.
--

== 한글 설정
=== 글꼴 파일 준비
한글을 지원하는 글꼴 파일(.ttf)을 준비한다. 프로젝트 디렉토리 내에 fonts 디렉토리를 만들고 그 안에 저장한다.

* PDF 변환 명령 실행 시 폰트 디렉토리 지정
[source,console]
----
-a pdf-fontsdir="C:/Windows/Fonts;C:/path/of/project/fonts"
----

=== 테마 파일 작성
프로젝트 루트에 theme.yml 파일을 작성한다. 여기서 .ttf 파일명은 실제 사용하려는 글꼴 파일명으로 변경한다.

[CAUTION]
====
AsciiDoc 콘텐츠를 제대로 지원하려면 normal, italic, bold, bold_italic 네 가지 변형이 모두 필요하다. 변형 중 하나가 컬렉션에서 누락된 경우 그 자리에 일반/단일 변형을 재사용한다.

Asciidoctor PDF는 브라우저처럼 동적으로 글꼴을 기울임꼴로 표시할 수 없으므로 텍스트를 기울임꼴로 표시하려면 기울임꼴 스타일이 필요하다.
====

글꼴의 이름이 NanumGothic라고 가정해 보겠습니다. 다음과 같은 형식으로 파일 이름을 바꿉니다.
* nanumgothic-regular.ttf (originally NanumGothic.ttf)
* nanumgothic-light.ttf (originally NanumGothicLight.ttf)
* nanumgothic-bold.ttf (originally NanumGothicBold.ttf)
* nanumgothic-bold_extra.ttf (originally NanumGothicExtraBold.ttf)

[source,yaml]
----
extends: default-with-font-fallbacks
font:
  catalog:
    merge: true
    NanumGothic:
      normal: nanumgothic-regular.ttf
      italic: nanumgothic-light.ttf
      bold: nanumgothic-bold.ttf
      bold_italic: nanumgothic-bold_extra.ttf
    SegoeUISymbol: seguisym.ttf
  fallbacks:
  - SegoeUISymbol

base:
  font_family: NanumGothic
  font_size: 12
  font_color: #000000

code:
  font_family: NanumGothic
  font_size: 10
----

* PDF 변환 명령 실행 시 테마 파일 지정
[source,console]
----
--theme theme.yml
----

== PDF 파일 위치 지정
프로젝트 디렉토리 내에 pdf 디렉토리를 만들고 그 안에 저장한다.
----
📒 swlab-docs-제품명
  📄 theme.yml
  📁 fonts
  📁 modules
  📂 pdf
    📄 guide.pdf (생성될 파일)
----

[source,console]
----
-o C:/path/of/project/pdf/guide.pdf
----

