@author 류 광
@type article

!!!! Win32용 닥북 모음집 README

[닥북 한국|http://docbook.or.kr/]이 제공하는 Win32용 닥북 모음집 0.9.0 버전에 대한 정보입니다.

!! 설치, 설정

# dbkpack-0.9.0-alpha.zip 파일을 적절한 디렉터리에 풉니다. (추가적인 파일 설치 과정은 없기 때문에, 이 디렉터리 선택이 이후에도 계속 사용할 닥북 홈 디렉터리의 기준이 됩니다.)
#* 압축 파일에는 docbook이라는 하위 디렉터리가 있으므로 예를 들어 e:에 풀면 e:\docbook에 모든 디렉터리와 파일들이 들어갑니다. 이 e:\docbook을 이하 닥북 홈 디렉터리라고 부르겠습니다.
# 닥북 홈 디렉터리의 configure.bat을 실행합니다. 여기까지 하면 각종 디렉터리 관련 설정이 완료되며, 또한 닥북 홈 디렉터리에 dbkshell.bat이라는 파일이 생깁니다.

(((note Java 실행 환경 준비
PDF는 Apach FOP를 이용해서 생성하는데, FOP는 Java로 작성된 응용 프로그램입니다. 따라서 PDF를 생성하려면 Java 실행 환경이 준비되어 있어야 합니다. [http://www.java.com/ko/]를 참고하세요.

Java 실행 환경이 제대로 작동하는지는 아래의 "시험" 절에 나온 대로 test.pdf를 생성해보면 알 수 있습니다.
)))

!! 시험

dbkshell.bat를 실행하면 콘솔창이 뜨며, 초기 디렉터리는 닥북 홈 디렉터리입니다. 우선 테스트용 파일이 있는 test 디렉터리로 갑니다. 다음을 입력하세요:

{{{
>cd test
}}}
이제 test.xml이라는 닥북 문서를 HTML 형식으로 변환해 봅니다. 다음을 입력하세요:
{{{
>docbook2html test.xml
}}}
설치, 설정이 제대로 되었다고 할 때, index.html를 비롯한 여러 HTML 파일들이 생성되어야 합니다.(이 파일들은 이 README.html과 동일한 내용이나 각 섹션이 개별적인 파일로 생성된 결과입니다).

다음으로는 PDF 파일을 생성해 봅니다.
{{{
>docbook2pdf test.xml test.pdf
}}}
역시 README.html 파일과 동일한 내용을 담은 PDF 파일이 생성될 것입니다. 몇 가지 오류 메시지들이 나올 수 있지만 대부분 FOP의 한계 또는 FO-XSL의 한계 때문입니다. 만일 PDF 파일이 아예 생성되지 않거나 생성되었더라도 내용을 알아보지 못할 정도라면 설치, 설정에 문제가 있는 것입니다.

!! 사용
dbkshell.bat을 실행하면 콘솔창이 뜹니다. 이 콘솔창에는 닥북 관련 경로들이 설정되어 있으므로 어떤 디렉터리에서도 docbook2pdf, docbook2html, wget 같은 명령들을 수행할 수 있습니다.

docbook2html은 주어진 입력 XML 파일로부터 HTML 파일(들)을 생성합니다. 사용법은:
{{{
 >docbook2html 입력.xml
}}}
docbook2pdf는 주어진 입력 XML 파일로부터 PDF 파일을 생성합니다. 사용법은:
{{{
 >docbook2pdf 입력.xml 출력.pdf
}}}
이 두 가지가 가장 기본적인 명령들입니다. bin/ 디렉터리에는 그 외에도 여러 가지 프로그램, 명령들이 있으며, 또 XSL 스타일시트를 커스텀화해서 HTML이나 PDF 출력물의 모습을 조정할 수도 있습니다. 좀 더 자세한 또는 재미있는 활용 방법은 [http://docbook.or.kr/]에서 함께 찾아나갔으면 좋겠습니다.

!! 구성물 정보

! 스키마와 스타일시트

schemas/와 stylesheet/ 디렉터리에 들어 있습니다.
; docbook-xml 4.5 : http://www.docbook.org/xml/4.5/
; docbook-xsl 1.71.1 : http://docbook.sourceforge.net/projects/xsl/
; docbook-xsl-ko-0.2.zip(닥북 한글 스타일시트) : http://kldp.net/frs/?group_id=8

! 소프트웨어

fop를 제외한 나머지는 실행에 필요한 파일들만 bin/ 디렉터리에 들어 있습니다. fop는 software/ 디렉터리에 들어 있습니다.

; fop-0.92 SVN       : http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/ 
;:(2007-01-30에 전체 업데이트해서 빌드했습니다.)
; wget 1.10.2 : http://users.ugent.be/~bpuype/cgi-bin/fetch.pl?dl=wget/wget.exe
; iconv 1.9.2 : http://www.zlatkovic.com/pub/libxml/iconv-1.9.2.win32.zip
; libxml2 2.6.27 : http://www.zlatkovic.com/pub/libxml/libxml2-2.6.27.win32.zip
; libxslt 1.1.17 : http://www.zlatkovic.com/pub/libxml/libxslt-1.1.17.win32.zip
; xsldbg 3.1.7 : http://www.zlatkovic.com/pub/libxml/xsldbg-3.1.7.win32.zip
; zlib 1.2.3 : http://www.zlatkovic.com/pub/libxml/zlib-1.2.3.win32.zip

! 글꼴

fonts/ 디렉터리에 들어 있습니다.

; hline.ttf - 백묵글꼴: http://kldp.net/projects/baekmuk/
; Un*.ttf들 - 은글꼴: http://kldp.net/projects/unfonts/

! 루아

0.9.0부터는 루아 확장팩이 기본으로 포함됩니다. 루아 확장팩에 대한 자세한 사항은  README_LUA_PACK.html를 보세요.

!! 고맙습니다!

이 패키지는 [류광|http://kldp.net/users/gryu]이 만들었으며, 이번 릴리스의 핵심이라 할 수 있는 FOP 0.92에 관련된 설정은 [고동진|http://kldp.net/users/exsider/] 님의 [패치|http://docbook.or.kr/phpBB2/viewtopic.php?topic=444]에 기초한 것입니다.

이 패키지는 [닥북 한국|http://docbook.or.kr/]에서 만든 기존 패키지를 기초로 해서 만든 것입니다. 다음은 기존 패키지들에 도움을 주신 분들입니다.

* [yongjoo|http://kldp.net/users/yongjoo] : 초기 패키지들을 엮어주셨고, 이후 패키지들의 오류 수정과 개선에도 큰 기여를 하셨습니다.
* [sisyphos|http://kldp.net/users/sisyphos] : 패키지의 개선점을 꾸준히 지적해주시고 방향을 제시해 주셨습니다.
* [yarang|http://kldp.net/users/yarang] : 새로운 패키지의 초기 버전을 제작해 주셨습니다.
* [sizer|http://kldp.net/users/sizer] : PATH를 사용한 편리한 환경 설정법을 제시해 주셨습니다.
* [minskim|http://kldp.net/users/minskim] : 한글 스타일시트를 개발하고 전체 작업을 조율해 주셨습니다.
* [airdh|http://kldp.net/users/airdh] : 한글 스타일시트 개발에 참여해 주셨습니다.

이 밖에도 많은 분들이 기여해 주셨습니다. 이곳에 다 적지 못한점 죄송하게 생각합니다.
