## Win32용 닥북 모음집 1.0 README

닥북 한국이 제공하는 Win32용 닥북 모음집 1.0.0(dbkpack-1.0.0)에 대한 정보입니다.

## 설치, 설정

1. 적절한 디렉터리에 압축을 풉니다. 압축 파일에는 docbook이라는 하위 디렉터리가 있으므로 예를 들어 e:에 풀면 e:\docbook에 모든 파일들이 들어갑니다. 이 e:\docbook을 이하 닥북 홈 디렉터리라고 부르겠습니다.

2. 닥북 홈 디렉터리의 configure.bat을 실행합니다. 여기까지 하면 각종 디렉터리 관련 설정이 완료되며, 또한 닥북 홈 디렉터리에 dbkshell.bat이라는 파일이 생깁니다.

| Java 실행 환경 준비
PDF는 Apach FOP를 이용해서 생성하는데, FOP는 Java로 작성된 응용 프로그램입니다. 따라서 PDF를 생성하려면 Java 실행 환경이 준비되어 있어야 합니다. http://www.java.com/ko/를 참고하세요. Java 실행 환경이 제대로 작동하는지는 아래의 "시험" 절에 나온 대로 README.PDF를 생성해보면 알 수 있습니다.

## 시험

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 파일이 아예 생성되지 않거나 생성되었더라도 내용을 알아보지 못할 정도라면 설치, 설정에 문제가 있는 것입니다.

## 사용

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.or.kr/에서 함께 찾아나갔으면 좋겠습니다.

## 구성물 정보

### 스키마와 스타일시트

schemas/와 stylesheet/ 디렉터리에 들어 있습니다.

docbook-xml 5.0

  http://www.docbook.org/xml/5.0/

docbook-xml 4.5

  http://www.docbook.org/xml/4.5/

docbook-xsl 1.73.2

  http://docbook.sourceforge.net/projects/xsl/

docbook-xsl-ko-0.2(닥북 한글 스타일시트)

  http://kldp.net/frs/?group_id=8 (이번 패키지에 새로 추가된 만들어진 스타일시트들도 있음)

### 소프트웨어

Java 프로그램들(fop, xalan 등)과 루아 스크립트들은 software/ 디렉터리에 들어 있고, 나머지는 bin/ 디렉터리에 실행 파일들만 들어 있습니다.

fop-0.94

  http://xmlgraphics.apache.org/fop/ (Xalan도 포함)

resolver.jar

  http://www.apache.org/dist/xml/commons/xml-commons-resolver-1.2.zip

saxon

  http://downloads.sourceforge.net/saxon/saxon6-5-5.zip

isogen_i18n

  http://www.innodata-isogen.com/knowledge_center/tools_downloads/isogen_i18n_20050826.zip

wget 1.10.2

  http://users.ugent.be/~bpuype/cgi-bin/fetch.pl?dl=wget/wget.exe

libxml2 2.6.30+

  http://www.zlatkovic.com/pub/libxml/libxml2-2.6.30+.win32.zip

libxslt 1.1.22

  http://www.zlatkovic.com/pub/libxml/libxslt-1.1.22.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

### 글꼴

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

battang.ttf, dotum.ttf, gulim.ttf, hline.ttf - 백묵글꼴

  http://kldp.net/projects/baekmuk/

UnTaza.ttf - 은글꼴

  http://kldp.net/projects/unfonts/

### 루아

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

## 고맙습니다!

이 패키지는 닥북 한국에서 만든 기존 패키지를 기초로 해서 류광이 만들었습니다. 다음은 이 패키지와 기존 패키지들에 도움을 주신 분들입니다.

- yongjoo : 초기 패키지들을 엮었고 이후 패키지들의 오류 수정과 개선에도 큰 기여를 하셨습니다.

- sisyphos : 패키지의 개선점을 꾸준히 지적해주시고 방향을 제시해 주셨습니다.

- yarang : 새로운 패키지의 초기 버전을 제작해 주셨습니다.

- sizer : PATH를 사용한 편리한 환경 설정법을 제시해 주셨습니다.

- minskim : 한글 스타일시트를 개발하고 전체 작업을 조율해 주셨습니다.

- airdh : 한글 스타일시트 개발에 참여해 주셨습니다.

- 고동진 :FOP 관련 설정을 도와주셨습니다.

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