닥북 한국이 제공하는 Win32용 닥북 모음집 1.0.0(dbkpack-1.0.0)에 대한 정보입니다.
적절한 디렉터리에 압축을 풉니다. 압축 파일에는 docbook이라는 하위 디렉터리가 있으므로 예를 들어 e:에 풀면 e:\docbook에 모든 파일들이 들어갑니다. 이 e:\docbook을 이하 닥북 홈 디렉터리라고 부르겠습니다.
닥북 홈 디렉터리의 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/ 디렉터리에 들어 있습니다.
http://kldp.net/frs/?group_id=8 (이번 패키지에 새로 추가된 만들어진 스타일시트들도 있음)
Java 프로그램들(fop, xalan 등)과 루아 스크립트들은 software/ 디렉터리에 들어 있고, 나머지는 bin/ 디렉터리에 실행 파일들만 들어 있습니다.
http://users.ugent.be/~bpuype/cgi-bin/fetch.pl?dl=wget/wget.exe
http://www.zlatkovic.com/pub/libxml/libxml2-2.6.30+.win32.zip
http://www.zlatkovic.com/pub/libxml/libxslt-1.1.22.win32.zip
font/ 디렉터리에 들어 있습니다.
0.9.0부터는 루아 확장팩이 기본으로 포함됩니다. 루아 확장팩에 대한 자세한 사항은 docs/README_LUA_PACK.html를 보세요.