= 문서 변환 도구 (Pandoc)
Heywon Choi <heywon.choi@bankwareglobal.com>

[abstract]
.문서개요
--
여기서는 {doctitle} 의 설치방법과 사용방법에 대하여 설명합니다.
--

== 설치
. Pandoc 공식 다운로드 페이지( https://pandoc.org/installing.html[Pandoc - Installing pandoc^])에서 사용하는 운영 체제(OS)에 맞는 설치 프로그램을 다운로드합니다.
. 다운로드한 설치 프로그램을 실행합니다.
. 설치 마법사의 지시를 따라 설치합니다.

=== 설치 확인
명령 프롬프트(Command Prompt), 터미널(Terminal), 또는 쉘(Shell)을 열고 변환하고자 하는 문서의 폴더로 이동하여 아래의 명령어를 입력합니다.
----
pandoc --version
----
입력 후, 설치된 Pandoc의 버전 정보가 나타난다면 Pandoc이 성공적으로 설치된 것입니다.

만약 "pandoc" 명령을 인식하지 못한다는 메시지가 나온다면, Pandoc이 제대로 설치되지 않았거나 시스템의 PATH 환경 변수에 Pandoc의 설치 경로가 추가되지 않았을 가능성이 있습니다. 이 경우, Pandoc을 다시 설치하거나 PATH 환경 변수를 확인하고 수정해야 할 수 있습니다.

== 문서 변환 방법
=== DocBook -> AsciiDoc
Pandoc을 사용하여 DocBook 문서를 AsciiDoc 형식으로 변환한다.

. DocBook을 중간 형식(HTML)으로 변환
+
----
pandoc -s -f docbook -t html ${input.xml} –o ${output.html}
----
* -s (또는 --standalone) : 완전한 문서를 생성하라는 지시입니다.
* -f docbook : 입력 파일 형식이 DocBook임을 지정합니다.
* -t html : 목표 파일 형식을 HTML로 지정합니다.
* ${input.xml} : 변환하고자하는 DocBook 파일명입니다.
* –o ${output.html} : 생성될 HTML 파일명을 지정합니다.

. 그 형식(HTML)을 AsciiDoc으로 변환
+
----
pandoc -s -f html -t asciidoc ${output.html} -o ${output.adoc}
----
* -s (또는 --standalone) : 완전한 문서를 생성하라는 지시입니다.
* -f html : 입력 파일 형식이 HTML임을 지정합니다.
* -t asciidoc : 목표 파일 형식을 AsciiDoc로 지정합니다.
* ${output.html} : 변환하고자하는 HTML 파일명입니다.
* –o ${output.adoc} : 생성될 AsciiDoc 파일명을 지정합니다.

=== Markdown -> AsciiDoc
Pandoc을 사용하여 Markdown 문서를 AsciiDoc 형식으로 변환한다.

----
pandoc -s -f markdown -t asciidoc ${input.md} -o ${output.adoc} 
----
* -s (또는 --standalone) : 완전한 문서를 생성하라는 지시입니다.
* -f markdown : 입력 파일 형식이 Markdown임을 지정합니다.
* -t asciidoc : 목표 파일 형식을 AsciiDoc으로 지정합니다.
* ${input.md} : 변환하고자 하는 Markdown 파일명입니다.
* -o ${output.adoc} : 생성될 AsciiDoc 파일명을 지정합니다.