FreeBSD 문서 프로젝트의 docbook DTD

FreeBSD 문서 프로젝트는 linuxdoc DTD의 형식에 약간의 FreeBSD 용의 변경을 가한 것이었으나, 약 2년 전에 새로이 docbook DTD로 전환하였습니다. docbook DTD는 산업 표준이며, 기술 문서에 특히 적합한 양식으로 FreeBSD 문서 프로젝트에서 채택하여 사용하고 있습니다.

FreeBSD 문서 프로젝트의 문서를 직접 빌드하고자 하는 분, FreeBSD의 문서 프로젝트 시스템에 대해 알고자 하는 분, docbook 문서 작성에 대한 내용을 알고 싶은 분은 다음 문서를 읽어야 합니다.

doc-kr 프로젝트 docbook 소스 트리

KFUG의 doc-kr 프로젝트는 궁극적으로 FreeBSD의 doc/ CVS 트리에 ko_KR.eucKR 인코딩을 추가하는 것입니다. 이를 위해 일단 KFUG CVS 트리를 사용하여 작업한 후, 최종적으로 FreeBSD CVS 트리에 올라가게 되면 그 이후의 번역 성과는 모두 직접 FreeBSD CVS 트리에 반영할 수 있게 됩니다. KFUG 내의 doc-kr 소스 트리는 다음과 같이 접근할 수 있습니다. 일단 CVS 시스템이 자신의 컴퓨터에 설치되어 있어야 합니다. FreeBSD의 경우 기본적으로 설치되어 있고, 다른 플랫폼의 경우도 CVS 홈페이지에서 구할 수 있습니다.

소스 구하기

  1. CVSROOT 환경변수를 다음과 같이 지정합니다.

    :pserver:anonymous@daemon.kr.freebsd.org:/kfug/cvs
    환경변수의 지정법은 OS나 사용하는 쉘에 따라 다릅니다.

  2. 환경변수를 지정하였으면 익명 사용자로 CVS 에 로그인해야 합니다. 쉘 프롬프트에서 cvs login 명령을 사용합니다. 
    % cvs login
(Logging in to anonymous@daemon.kr.freebsd.org)
CVS password:
    암호는 없으므로 그냥 엔터를 치세요.

  3. doc-kr 소스 트리를 체크아웃합니다. 
    % cvs co -PR doc
cvs server: Updating doc
U doc/Makefile
U doc/README
U doc/README.ko
cvs server: Updating doc/en_US.ISO_8859-1
...
cvs server: Updating doc/share/web2c
U doc/share/web2c/pdftex.def

단순히 살펴보거나 로그를 보고자 하는 목적이라면 KFUG CVSweb doc/를 보시면 됩니다.

문서 빌드하기

문서를 빌드하는 가장 쉬운 방법은 doc 디렉토리에 make all을 하는 것입니다. 
% cd doc
% make
미리 textproc/docproj 포트가 반드시 설치되어 있어야 합니다.

문서 설치하기

설치하려면 일단 설치할 곳을 정하고 make install 합니다. 설치 디렉토리는 DOCDIR 변수로 지정합니다. 
% make install DOCDIR=/tmp/doc
이 경우 /tmp/doc/ko_KR.eucKR 디렉토리가 생기고 그 안에 종류별 문서가 들어있게 됩니다. 핸드북의 경우 /tmp/doc/ko_KR.eucKR/books/handbook/index.html을 열어보면 됩니다.

번역하기

현재 핸드북의 경우 doc/ko_KR.eucKR/books/handbook/ 아래의 여러 *.sgml, *.ent 파일을 번역하면 됩니다. 번역에 대한 일반적인 주의사항은 번역 안내를 읽어보세요. 번역이 완료되면 ftp://ftp.kr.FreeBSD.org/pub/incoming 에 올려주시고 doc-kr 메일링 리스트로 보내주시면 됩니다.