Docbook Package

정보 [+]

[주의]

Windows용 닥북 패키지 최신 버전에 대한 내용은 DbkPackWin 에 있습니다. 이 페이지는 보존의 목적으로 일단 남겨둡니다. 이후에 DbkPackWin의 내용으로 대체하거나 또는 다른 방식으로 정리할 필요가 있습니다. --류광

DocBook XML 패키지

이 글은..

http://docbook.kldp.net에서 배포하는 DocBook XML 패키지에 관한 설명입니다.

소개합니다!

DocBook이란?

DocBook은 XML 규약을 따르는 문서 형식의 한가지입니다. DocBook에 관한 자세한 내용은 http://docbook.kldp.net 을 참고하세요.

DocBook XML 패키지란?

DocBook XML 패키지는 DocBook 문서를 HTML이나 PDF로 변환하기 위해 필요한 모든 구성요소들을 한덩이로 묶은 것입니다. DocBook 변환을 위해 필요한 귀찮은 설치 설정 작업을 최소화하는 것을 목표로 합니다. 현재는 MS-Windows 환경에서 사용하도록 되어 있습니다. 패키지는 http://kldp.net/projects/docbook 에서 다운로드 받을 수 있습니다.

설치 방법

자바 런타임 라이브러리의 설치

PDF 변환을 하려면 자바 런타임 라이브러리가 설치되어 있어야 합니다. 1.4버전은 에러를 일으킬 소지가 있으므로 1.31 버전을 설치하세요. http://java.sun.com에서 다운로드 할 수 있습니다.

압축 풀기와 환경 변수 설정

원하는 곳에 패키지의 압축을 풉니다. 이로부터 생성된 docbook 디렉토리의 위치가 환경변수 DOCBOOK_HOME에 잡혀 있어야 합니다.

win98 또는 winME의 경우

autoexec.bat에 다음을 추가하고 리부팅해야 합니다. (c:docbook 경로를 자신의 경우에 맞게 수정하세요)

  set PATH=%PATH%;c:docbook
  set DOCBOOK_HOME=c:docbook

win2000 또는 winXP의 경우

제어판의 시스템 -> 고급 -> 환경변수에서 PATH를 수정해 자신의 docbook 디렉토리 경로를 추가하고, DOCBOOK_HOME 환경변수를 추가해 docbook 디렉토리의 경로를 넣어주세요.

userconfig.xml 파일의 수정

docbook/fop/userconf/userconfig.xml 파일을 열어서 다음과 같은 부분에 자신의 docbook 디렉토리 경로를 넣어 주세요.(c:docbook 부분을 자신의 docbook 디렉토리 경로에 맞게 수정)

       <entry>
         <key>baseDir</key>
         <value>c:docbook</value>
       </entry>

       <entry>
         <key>fontBaseDir</key>
         <value>c:docbook</value>
       </entry>

사용 방법

커맨드 프롬프트를 열어서 변환하고자 하는 xml 파일이 있는 곳으로 이동합니다.

HTML 얻기

      > docbook2html example.xml

PDF 얻기

      > docbook2pdf example.xml example.pdf

참고

같이 포함된 xalan.bat, fop.bat, xsltproc.bat을 사용하면 docbook이 아닌 다른 xml 변환에도 편리합니다.

내용물에 대한 설명

각 디렉토리의 내용물은 각 사이트에서 배포되는 것 그대로를 손대지 않고 그대로 압축을 풀어 놓은 것입니다. 이곳에 특별히 손댄 내용을 적겠습니다.

DTD

docbook xml 4.1.2 버전과 4.2 버전이 들어 있습니다. 포함된 catalog.xml 파일은 xsltproc에서 읽어들이게 되는데, 각 docbook dtd를 인터넷에서 읽어오는 대신에 로컬에서 읽어 오도록 하기 위한 것입니다. catalog.dtd는 왜 있는 것인지 기억이 안납니다 -_-?

http://wiki.docbook.org/topic/DocBookAndXmlCatalogs

libxml

libxml 디렉에는 iconv, libxml, libxslt 가 있습니다. xsltproc.exe는 libxslt의 유틸 디렉에 있습니다. iconv와 libxml2 는 xsltproc가 요구하는 라이브러리입니다.

http://xmlsoft.org/catalog.html
iconv/libxml2/libxslt
1.8/2.5.6/1.0.29 : 기존 패키지 조합)
1.9.1(1.8)/2.6.0/1.0.33 : 테스트할 조합 1
1.9.1(1.8)/2.6.2/1.1.0 : 테스트할 조합 2 -- dyaus

xalan

resolver란 디렉이 있는데 이것은 xalan이 catalog.xml을 읽도록 하기 위한 것으로 역시 로컬에서 dtd를 읽도록 하기 위해 넣은 것입니다. ?CatalogManager.properties가 설정 파일입니다.

http://wwws.sun.com/software/xml/developers/resolver/article/

xsltproc이 있기 때문에, xalan은 따로 필요할 것 같지 않습니다. 필요한 경우에는 fop에 포함된 jar 파일들을 이용하면 될 것 같습니다. -- dyaus

fop

userconfig 디렉에 한글 설정이 들어가 있구요. jimi란 것은 무슨 이미지 처리 관련한 것인데 이게 없으면 fop가 에러를 냅니다. sun에서 배포하는 것인데 이것은 아마 임의로 배포해서는 안되는 것 같습니다 (-_-)

jai란 것은 왜 필요한지 기억이 안납니다만 역시 fop에 필요한 것입니다. 역시나 sun에서 받아왔고 임의로 배포해서는 안되는 것 같습니다만 임의로 배포해왔습니다.(-_-)

fop 0.20.5에는 jai & xalan이 포함되어 있고, jimi_xx.jar 는 빠져 있습니다. -- dyaus

stylesheet

오리지날 스타일시트 그냥 풀어놓고 한글 스타일시트 따로 모아놓은 것입니다.

패키지 : docbook xsl 1.60
가능한 버전 : docbook xsl 1.62
한글 스타일 시트 : cvs version

example

예전에 kldp의 docbook 템플릿의 xml 버전으로 약간 수정한 것입니다.

testdocs

기억이 안나는데 아마 docbook 개발 홈피에서 받아온 것 같습니다.

감사드립니다!

이 패키지는 DocBook 한국 개발자 그룹의 많은 분들과 게시판에서 의견을 주신 모든 분들의 도움으로 만들어졌습니다.

sisyphos: 패키지의 개선점을 꾸준히 지적해주시고 방향을 제시해 주셨습니다.
yarang: 새로운 패키지의 초기 버전을 제작해 주셨습니다.
sizer: PATH를 사용한 편리한 환경 설정법을 제시해 주셨습니다.
minskim: 한글 스타일시트를 개발하고 전체 작업을 조율해 주셨습니다.
airdh: 한글 스타일시트 개발에 참여해 주셨습니다.
gryu: DbWiki를 개발해주셨습니다. 이 글은 DbWiki를 사용해 작성되었습니다.
yongjoo: 패키지를 엮었습니다. 이 글을 작성하였습니다.

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

제일 위로

글쓴이	박 용주;yongjoo(at)kldp.org
고침	0.1 ;2003-09-18;yongjoo;글쓰기 시작