닥북 한국이 제공하는 Win32용 닥북 모음집(dbkpack-2005.07.win32.zip)에 대한 정보입니다.
적절한 디렉터리에 압축을 풉니다. 압축 파일에는 docbook이라는 하위 디렉터리가 있으므로 예를 들어 e:에 풀면 e:\docbook에 모든 파일들이 들어갑니다. 이 e:\docbook을 이하 닥북 홈 디렉터리라고 부르겠습니다.
닥북 홈 디렉터리의 configure.bat을 실행합니다. 여기까지 하면 각종 디렉터리 관련 설정이 완료되며, 또한 닥북 홈 디렉터리에 dbkshell.bat이라는 파일이 생깁니다.
PDF는 Apach FOP를 이용해서 생성하는데, FOP는 Java로 작성된 응용 프로그램입니다. 따라서 PDF를 생성하려면 Java 실행 환경이 준비되어 있어야 합니다. http://www.java.com/ko/를 참고하세요.
Java 실행 환경이 제대로 작동하는지는 아래의 "시험" 절에 나온 대로 README.PDF를 생성해보면 알 수 있습니다.
PDF 생성에서 PNG 형식의 그림 파일을 사용하려면 JAI를 설치해야 합니다. 이것은 SUN이 배포하는 비 오픈소스 제품이라서 닥북 한국 패키지에 포함시키지 않았습니다.
JAI 1.1.2.01 다운로드에서 JRE용(또는, JDK를 설치해 두었다면 JDK용) 설치 패키지를 다운받아서 설치하면 됩니다. 다른 설정은 필요가 없습니다. 설치되어 있는 JRE, JDK의 버전에 따라서는 다른 버전의 JAI가 필요할 수도 있습니다. Java Advanced Imaging Downloads를 참고하세요.
JAI가 제대로 설치, 작동하는지는 아래의 "시험" 절에 나온 대로 README.pdf를 생성해보면 알 수 있습니다. 지금 이 항목 같은 "note" 요소 왼쪽에 손가락 그림이 나타난다면 JAI가 제대로 작동하는 것입니다.
dbkshell.bat를 실행하면 콘솔창이 뜨며, 초기 디렉터리는 닥북 홈 디렉터리입니다. 거기서 다음을 입력해 보세요.
>docbook2html README.xml
설치, 설정이 제대로 되었다고 할 때, index.html를 비롯한 여러 HTML 파일들이 생성되어야 합니다.(이 파일들은 이 README.html과 동일한 내용이나 각 섹션이 개별적인 파일로 생성된 결과입니다).
다음으로는 PDF 파일을 생성해 봅니다.
>docbook2pdf README.xml README.pdf
역시 README.html 파일과 동일한 내용을 담은 PDF 파일이 생성될 것입니다. 몇 가지 오류 메시지들이 나올 수 있지만 대부분 FOP의 한계 또는 FO-XSL의 한계 때문입니다. 만일 PDF 파일이 아예 생성되지 않거나 생성되었더라도 내용을 알아보지 못할 정도라면 설치, 설정에 문제가 있는 것입니다.
dbkshell.bat을 실행하면 콘솔창이 뜹니다. 이 콘솔창에는 닥북 관련 경로들이 설정되어 있으므로 어떤 디렉터리에서도 docbook2pdf, docbook2htm, wget 같은 명령들을 수행할 수 있습니다.
docbook2html은 주어진 입력 XML 파일로부터 HTML 파일(들)을 생성합니다. 사용법은:
>docbook2html 입력.xml
docbook2pdf는 주어진 입력 XML 파일로부터 PDF 파일을 생성합니다. 사용법은:
>docbook2pdf 입력.xml 출력.pdf
이 두 가지가 가장 기본적인 명령들입니다. bin/ 디렉터리에는 그 외에도 여러 가지 프로그램, 명령들이 있으며, 또 XSL 스타일시트를 커스텀화해서 HTML이나 PDF 출력물의 모습을 조정할 수도 있습니다. 좀 더 자세한 또는 재미있는 활용 방법은 http://docbook.or.kr/에서 함께 찾아나갔으면 좋겠습니다.
dtd/와 stylesheet/ 디렉터리에 들어 있습니다.
fop를 제외한 나머지는 실행에 필요한 파일들만 bin/ 디렉터리에 들어 있습니다. fop는 software/ 디렉터리에 들어 있습니다.
font/ 디렉터리에 들어 있습니다.