· KLDP.org · KLDP.net · KLDP Wiki · KLDP BBS ·
Docbook Sgml/Doc Book_Install-KLDP

DocBook 설치 mini-HOWTO

DocBook 설치 mini-HOWTO

정하녕

          
        

이 문서에서는 DocBook DTD와 nwalsh stylesheet, jade를 Linux와 MS Windows(98, 2000)에 설치하는 방법에 대해 설명하고 있습니다. 이 문서의 내용들은 DocBook SGML v4.1을 기준으로 하고 있습니다. 차후에 XML에 대한 내용이 추가되면 좋겠지만 언제가 될 지는 알 수 없습니다. :)

고친 과정
고침 0.12001-09-26고친이 alita
첫 릴리즈

1. 머리글

이 문서에서는 DocBook을 사용하여 문서를 작성하고 html, rtf, dvi 등으로 변환하기 위해 필요한 기본적인 프로그램들과 파일들을 설치하는 방법에 대해 간략하게 소개하고 있습니다. 이 문서는 DocBook을 사용하는 방법에 대해서는 다루지 않습니다. 이에 관한 사항들은 이곳을 참고하시면 됩니다. 또한, DocBook에 대한 소개도 지면 관계상 생략합니다. 이 내용 역시 위의 링크를 참조하시면 됩니다. 그 외 설치를 하는 파일들에 대한 소개 혹은 관련 링크는 해당 내용에서 다룹니다.

참고: 문서 전체의 내용은 설치 순서를 따르며 각 순서마다 Linux의 경우와 MS Windows 계열[1]의 경우를 나눠서 설명합니다.[2]


1.1. 저작권 정보

이 문서는 GNU Free Documentation License 버전 1.1 혹은 자유 소프트웨어 재단에서 발 행한 이후 판의 규정에 따르며 저작권에 대한 본 사항이 명시되는 한 어떠한 정보 매체에 의한 본문의 전재나 발췌도 무상으로 허용합니다.


1.2. 책임의 한계

본 저자는 문서의 내용이 야기할 수 있는 어떠한 결과에 대해서도 책임을 지지 않습니다. 본 문서에서 내포하고 있는 정보들 및 예제들은 여러분이 알아서 활용하십시오. 비록 최선을 다했으나 이 문서는 틀린 점이나 오류가 있을 수도 있습니다. 만약 여러분이 틀린 점을 발견했다면 꼭 저에게 알려 주시기 바랍니다.


1.3. 피드백

이 문서에 대한 발전적인 제안이나 수정사항, 문제점 등에 대한 피드백은 언제든지 환영합니다. 로 메일을 보내 주십시오.


2. 필요한 프로그램들의 설치


2.1. DocBook DTD

DocBook DTD는 http://www.docbook.org/sgml/4.1/docbk41.zip에서 받을 수 있습니다. 실행파일이나 라이브러리가 아니기 때문에 Linux와 Windows 모두 같은 파일을 사용합니다. 이를 받은 후 임의의 디렉토리에 풉니다. 앞으로 이 디렉토리를 %DOCBK41%[3]으로 표기합니다.


2.2. ISO entity set

ISO entity set은 www.oasis-open.org/cover/ISOEnts.zip에서 받을 수 있습니다. 이를 %DOCBK41% 안에 풉니다. 그러면 ISOpub, ISOtech, ISOnum 같이 확장자 없이 이름이 ISO<entity>인 파일들이 풀립니다. %DOCBK41%docbook.cat을 보시면 마지막에 ISO entity sets 설정 부분이 있는데 이름이 iso-<entity>.gml 형식인 것을 알 수 있습니다. 따라서 이 docbook.cat을 고쳐서 ISO<entity> 형식으로 만들거나 ISO<entity> 형태인 파일들의 이름을 ISO-<entity>.gml 형태로 바꿔줍니다. 전자가 쉽겠죠? :)

참고: 여기에서 ISO entity set이 왜 필요한지를 설명합니다.[4]


2.3. Stylesheet

Stylesheet은 Normal Walsh의 Modular DocBook Stylesheet을 사용합니다. http://sourceforge.net/projects/docbook에서 직접 받을 수 있고 이 글을 쓰는 시점에서 최신 버전은 1.72입니다. 이 파일을 풀면 docbook이라는 디렉토리가 만들어지고 그 안에 파일들이 풀립니다. 이 docbook이라는 디렉토리는 %NWALSH%라 하겠습니다.


2.4. Jade

jade는 stylesheet을 이용하여 DocBook 문서를 html, rtf 등의 문서로 변환해 주는 대표적인 tool입니다. http://www.jclark.com/jade/#getting에 가시면 최신 버전을 받을 수 있습니다. 받은 파일을 적당한 디렉토리에 풉니다. 이 디렉토리는 %JADE%라 하겠습니다.


2.5. SGML_CATALOG_FILES

catalog file들의 위치를 지정해 주는 SGML_CATALOG_FILES라는 환경 변수를 설정해 줘야 합니다.


2.5.1. Linux

Bash 사용자

  bash$ export SGML_CATALOG_FILES=$DOCBK41\docbook.cat;$JADE\catalog
               

Tcsh 사용자

  tcsh$ setenv SGML_CATALOG_FILES $DOCBK41\docbook.cat;$JADE\catalog
               


2.5.2. Windows

command prompt 상에서

  C:\>set SGML_CATALOG_FILE=%DOCBK41%\docbook.cat;%JADE%\catalog
	  
하시거나 Windows 2000 계열은 내 컴퓨터->시스템 등록정보->고급->환경 번수->새로 만들기(N) 해서 추가해 주면 이후 실행되는 모든 프로그램들에 적용됩니다.


2.5.3.

이제, 다음과 같이 하면 됩니다. html로 변환할 때

  C:\>%JADE%\jade -t sgml -d %NWALSH%\html\docbook.dsl filename.sgml
	  
rtf로...
  C:\>%JADE%\jade -t rtf -d %NWALSH%\print\docbook.dsl filename.sgml
	  
tex로...
  C:\>%JADE%\jade -t tex -d %NWALSH%\print\docbook.dsl filename.sgml
	  


2.6. KLDP용 Stylesheet

kldp.dsl 다운 http://docs.kldp.org/Stuff/kldp.dsl을 받아서 아무 디렉토리에다 복사합니다. 이 디렉토리는 %KLDP%라 하겠습니다. kldp.dsl을 열어서

/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl
        
라고 되어 있는 줄을
  %NWALSH%/html/docbook.dsl
        
로,
  /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl
        
  %NWALSH%/print/docbook.dsl
        
로 바꿔줍니다.

이후 jade를 쓸 때는

  C:\>%JADE%\jade -t sgml -i html -d %KLDP%\kldp.dsl#html filename.sgml
  C:\>%JADE%\jade -t rtf -d %KLDP%\kldp.dsl#print filename.sgml
        
같이 써주면 됩니다.

주석

[1]

이하 Windows

[2]

실질적으로 두 OS간에 차이점이라곤 jade를 서로 다른걸 받아와야 한다는 것과 환경 변수를 나타내는 방법이 다르다는 것 밖에 없습니다.

[3]

Windows계열은 환경 변수를 %NAME%으로 표기하며 대소문자 구분이 없습니다. *inx에서는 물론 $NAME 형태이며 대소문자를 구분합니다.

[4]

번역본은 저자 동의를 얻어서 추가하겠습니다.


ID
Password
Join
He who has imagination without learning has wings but no feet.


sponsored by andamiro
sponsored by cdnetworks
sponsored by HP

Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2006-08-07 16:33:19
Processing time 0.0026 sec