[홈으로] [게시판]

정보 [+]

Windows용 닥북 모음집 2.0

닥북 한국이 제공하는 Windows용 닥북 모음집 2.0(dbkpack-2.0)은 Windows에서 닥북 문서를 HTML, PDF 등 다른 여러 형식으로 변환하기 위한 여러 도구들과 스크립트들을 모은 환경입니다.

설치 및 설정

닥북 모음집 설치 프로그램을 닥북 한국 게시판에서 내려 받은 후,

  1. 설치 프로그램 압축 파일(dbkpack-2.0-installer-[버전].zip)을, 닥북 모음집을 설치할 디렉터리에 풀어 넣습니다. 그 디렉터리가 바로 닥북 모음집 홈 디렉터리가 됩니다(설치 도중 따로 디렉터리를 선택, 생성하는 것이 아닙니다). 따라서, 예를 들어 c:\docbook에 닥북 모음집을 설치하고 싶다면 c:\docbook을 먼저 만들고 그 곳에 압축 파일을 풀어야 합니다.
  1. install.bat을 실행하면 설치 프로그램이 뜹니다.
  1. [시작] 버튼을 클릭하면 설치와 설정이 진행됩니다.

성공을 알리는 메시지 상자가 떧다면 다음 단계로 넘어가서 시험해 보세요. 오류 메시지가 떴다면 설치 프로그램에 포함된 "설치.txt" 파일을 참고하세요.

시험

다음은 설치, 설정이 잘 되었는지를 확인할 수 있는 방법입니다. 이하, 이 모음집이 설치된 디렉터리(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 파일을 생성합니다.

좀 더 자세한 내용은 DocbooktoManual을 참고하세요.

bin/ 디렉터리에는 그 외에도 여러 가지 프로그램, 명령들이 있으며, 또 XSL 스타일시트를 커스텀화해서 HTML이나 PDF 출력물의 모습을 조정할 수도 있습니다. 좀 더 자세한 또는 재미있는 활용 방법은 http://docbook.kr/에서 함께 찾아나갔으면 좋겠습니다.

구성물 정보

닥북 모음집은 웹에서 직접 내려 받은 여러 구성요소들로 이루어집니다. 이 구성요소들의 종류와 버전은 유동적입니다. 닥북 모음집이 설치된 닥북 홈 디렉터리의 installer/files 디렉터리를 보면 내려 받은 여러 zip 파일들이 있으며, 각 zip 파일 안에 해당 구성요소의 저작권과 사용권을 확인하실 수 있습니다.

고맙습니다!

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

  • yongjoo : 초기 패키지들을 엮었고 이후 패키지들의 오류 수정과 개선에도 큰 기여를 하셨습니다.
  • sisyphos : 패키지의 개선점을 꾸준히 지적해주시고 방향을 제시해 주셨습니다.
  • yarang : 새로운 패키지의 초기 버전을 제작해 주셨습니다.
  • sizer : PATH를 사용한 편리한 환경 설정법을 제시해 주셨습니다.
  • minskim : 한글 스타일시트를 개발하고 전체 작업을 조율해 주셨습니다.
  • airdh : 한글 스타일시트 개발에 참여해 주셨습니다.
  • 고동진 : 한글 조사 자동 선택 패키지를 개발하셨으며 FOP 관련 설정을 도와주셨습니다.

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

제일 위로
최종 수정 일시: 02월 10일(2014년) 06:49 PM 편집 | 정보 | 차이 | 비슷한페이지 | DebugInfo
유용한 페이지들: 분류 분류 | 자유로운 연습장 SandBox | 무작위 페이지들 RandomPages | 인기있는 페이지들 MostPopular