닥북 한국이 제공하는 Windows용 닥북 모음집 2.0(dbkpack-2.0)은 Windows에서 닥북 문서를 HTML, PDF 등 다른 여러 형식으로 변환하기 위한 여러 도구들과 스크립트들을 모은 환경입니다.
이 문서를 보고 계시다면 이미 설치와 설정이 끝난 것입니다. 다음은 설치, 설정이 잘 되었는지를 확인할 수 있는 방법입니다. 이하, 이 모음집이 설치된 디렉터리(configure.bat, dbkshell.bat 등이 있는)를 닥북 홈 디렉터리라고 칭하겠습니다.
dbkshell.bat를 실행하면 콘솔창이 뜨며, 초기 디렉터리는 닥북 홈 디렉터리입니다. 시험을 위해 test 디렉터리로 갑니다.
> cd test
이제 HTML 파일들을 생성해 봅니다.
> docbookto html README.xml
설치, 설정이 제대로 되었다고 할 때, index.html를 비롯한 여러 HTML 파일들이 생성되어야 합니다.(이 파일들은 이 README.html과 동일한 내용이나 각 섹션이 개별적인 파일로 생성된 결과입니다).
다음으로는 PDF 파일을 생성해 봅니다.
> docbookto pdf README.xml
역시 이 README.html 파일과 동일한 내용을 담은 README.pdf 파일이 생성될 것입니다. 몇 가지 오류 메시지들이 나올 수 있지만 대부분 FOP의 한계 또는 FO-XSL의 한계 때문입니다.
만일 PDF 파일이 아예 생성되지 않거나 생성되었더라도 내용을 알아보지 못할 정도라면 설치, 설정에 문제가 있는 것입니다. 그런 경우 install.bat으로 설치를 다시 진행해 보시고, 어떻게 해도 문제가 해결되지 않는다면 닥북 한국 홈페이지의 게시판에 문의하세요.
dbkshell.bat을 실행하면 콘솔창이 뜹니다. 이 콘솔창에는 닥북 관련 경로들이 설정되어 있으므로 어떤 디렉터리에서도 docbookto, wget 같은 명령들을 수행할 수 있습니다.
dbkshell.bat을 실행하면 콘솔창이 뜹니다. 이 콘솔창에는 닥북 관련 경로들이 설정되어 있으므로 어떤 디렉터리에서도 docbookto, wget 같은 명령들을 수행할 수 있습니다.
docbookto 명령은 XML 파일을 다양한 형식으로 변환할 수 있는 범용 도구입니다. 기본적으로 다음 세 가지 방식으로 사용합니다.
> docbookto html 입력.xml
입력.xml에서 여러 개의 HTML 파일들(섹션별)을 생성합니다.
> docbookto onehtml 입력.xml 출력.html
입력.xml에서 하나의 HTML 파일을 생성합니다.
> docbookto pdf 입력.xml 출력.pdf
입력.xml 파일에서 PDF 파일을 생성합니다.
좀 더 자세한 내용은 docs/docbookto_command.html을 참고하세요.
bin/ 디렉터리에는 그 외에도 여러 가지 프로그램, 명령들이 있으며, 또 XSL 스타일시트를 커스텀화해서 HTML이나 PDF 출력물의 모습을 조정할 수도 있습니다. 좀 더 자세한 또는 재미있는 활용 방법은 http://docbook.kr/에서 함께 찾아나갔으면 좋겠습니다.
닥북 모음집은 웹에서 직접 내려 받은 여러 구성요소들로 이루어집니다. 이 구성요소들의 종류와 버전은 유동적입니다. 닥북 모음집이 설치된 닥북 홈 디렉터리의 installer/files 디렉터리를 보면 내려 받은 여러 zip 파일들이 있으며, 각 zip 파일 안에 해당 구성요소의 저작권과 사용권을 확인하실 수 있습니다.