일반적인 주의 사항

번역된 문서는 ftp://ftp.kr.FreeBSD.org/pub/incoming에 올려주시고, 메일링 리스트(doc@kr.FreeBSD.org)에 그 사실을 알려 주셔야 합니다.

작업 환경 구축 방법

KFUG의 doc-kr 프로젝트는 궁극적으로 FreeBSD의 doc/ CVS 트리에 ko_KR.eucKR 인코딩을 추가하는 것입니다. 이를 위해 일단 KFUG CVS 트리를 사용하여 작업한 후, 최종적으로 FreeBSD CVS 트리에 올라가게 되면 그 이후의 번역 성과는 모두 직접 FreeBSD CVS 트리에 반영할 수 있게 됩니다.

FreeBSD CVS doc/

KFUG 내의 doc-kr 소스 트리는 다음과 같이 접근할 수 있습니다. 일단 CVS 시스템이 자신의 컴퓨터에 설치되어 있어야 합니다. FreeBSD의 경우 기본적으로 설치되어 있고, 다른 플랫폼의 경우도 CVS 홈페이지에서 구할 수 있습니다.

소스 구하기

CVSROOT 환경변수를 다음과 같이 지정합니다.
```
:pserver:anonymous@daemon.kr.freebsd.org:/kfug/cvs
```
환경변수의 지정법은 OS나 사용하는 쉘에 따라 다릅니다.
- setenv CVSROOT :pserver:anonymous@daemon.kr.freebsd.org:/kfug/cvs (csh, tcsh 계열)
- export CVSROOT=:pserver:anonymous@daemon.kr.freebsd.org:/kfug/cvs (sh, bash 계열)
- set CVSROOT=:pserver:anonymous@daemon.kr.freebsd.org:/kfug/cvs (DOS/윈도우)
환경변수를 지정하였으면 익명 사용자로 CVS 에 로그인해야 합니다. 쉘 프롬프트에서 cvs login 명령을 사용합니다. 현재는 익명 로그인으로 파일을 읽어낼 수 밖에 없지만 공헌을 많이 한 분의 경우 CVS 계정을 얻어 직접 번역하고 파일을 체크인할 수 있습니다.
```
% cvs login
(Logging in to anonymous@daemon.kr.freebsd.org)
CVS password:
```
암호는 없으므로 그냥 엔터를 치세요.

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/를 보시면 됩니다.

문서 빌드하기

미리 textproc/docproj 포트가 반드시 설치되어 있어야 합니다. docproj 포트는 포트를 이용해서 다음과 같이 설치할 수 있습니다.

# cd /usr/ports/textproc/docproj && make install clean JADETEX=YES

JADETEX=YES는 jadetex을 사용할 경우입니다. 포트 빌드 시간을 단축하고 HTML만을 원한다면 JADETEX=NO로 하는 편이 좋습니다. 둘 중 하나를 정해야만 포트가 빌드되는 점에 주의하세요.

문서를 빌드하는 가장 쉬운 방법은 doc 디렉토리에서 make all을 하는 것입니다.

% cd doc
% make

문서 설치하기

설치하려면 일단 설치할 곳을 정하고 make install 합니다. 설치 디렉토리는 DOCDIR 변수로 지정합니다.

% make install DOCDIR=/tmp/doc

이 경우 /tmp/doc/ko_KR.eucKR 디렉토리가 생기고 그 안에 종류별 문서가 들어있게 됩니다. 핸드북의 경우 /tmp/doc/ko_KR.eucKR/books/handbook/index.html을 좋아하는 웹 브라우저로 열어보면 됩니다.

번역에 대한 안내

번역하는 파일은 반드시 SGML 문서 파일(*.sgml)을 번역합니다.

번역상의 주의

문체는 가능하면 '-니다'로 통일합니다.
모든 번역은 유닉스 텍스트 문서이어야 합니다. 도스용 텍스트 문서나 아래한글, 워드 등으로 번역하면 안됩니다. 번역에는 vi나 emacs등의 텍스트 에디터를 사용합시다. EUC-KR(KSC5601 완성형 코드)를 사용한다는 것도 잊지 마십시요. 사용자의 .emacs파일에 다음 줄을 넣고 emacs의 텍스트 모드(M-x text-mode)를 사용하면 기본적으로 word-wrap을 하도록 되어 있습니다. 이 모드를 가장 권장합니다.
```
(add-hook 'text-mode-hook 'turn-on-auto-fill)
```
문서 파일명은 그대로 바꾸지 않습니다.
SGML의 태그(부등호 <> 로 둘러싸여 있는 부분) 안에 있는 부분 중에서 일반적으로 번역하지 않고 그대로 두는 것이 당연한 부분이 있습니다. 예로
```
<sect1 id="nutshell">
```
의 경우，id="nutshell"은 번역하지 않습니다.
번역의 관리는 기본적으로 CVS 의 revision 로 하고 있습니다. 예를 들면，파일의 주석 행에
```

```
라는 것이 있는 경우, 1.35라는 것이 이 파일의 원래 버전입니다. 이제 이 부분을 다음과 같이 고쳐씁니다. $FreeBSD$ 태그 아래에 다음과 같은 줄을 붙여서 아래와 같이 만듭니다.
```

```
파일이 명시적으로 번역자를 표시하기 어려운 경우(.ent 파일이나 book.sgml등 원저자가 표시되지 않은 파일)에는 위 주석에
```
     Translated by: &a.kr.jhchoi;
```
를 추가해서 번역자를 표시합니다. 위 표시는 kauthors.ent 의 최신 버전에서에서 찾아볼 수 있는 것을 사용하세요. 자신에게 할당된 엔터티가 없다면 doc-kr 메일링 리스트 에 문의하시기 바랍니다.
참고로 로 둘러싸인 부분은 SGML의 주석입니다．
$Id$ 이외의 RCS ID 문자 열( $Date$ 등)은, 기본적으로는 그대로 사용해 주세요．
영어로 된 용어는 되도록이면 한글로 번역해 주시기 바랍니다. 이 경우에는 이것이 영어를 제시하지 않아도 알 수 있을 때에는 그냥 번역해 주시고(파일이나 사용자 등), 다시 설명이 필요한 경우에는, 단어가 처음 나올 때만 한번 괄호안에 써 주세요.
'if you.. then..'에서 되도록이면 '만약 여러분이...'와 같은 문장은 되도록이면 삼가해 주시기 바랍니다.
영문 수동태의 문장도 되도록이면 능동태로 바꾸어 쓰시기 바랍니다.
e.g. 는 '예를 들어' 내지 '예)'로, NOTE는 '*주의*'로 바꾸어 주시기 바랍니다.
대문자로 강조된 부분은 적당한 번역문 위치에서 *로 앞뒤를 표시해 주시기 바랍니다. 예) '*무엇을 하고 있는지* 알고 있는 경우에만 ... 해 주시기 바랍니다'
'나는'이라는 표현보다는 '저는'이라는 표현을, '당신은'보다는 '여러분은'을 써 주시고, 없어도 될 곳이라면 되도록이면 주어 표현을 없애 주시기 바랍니다.

잘 모르겠습니다

참여는 하고 싶으나 SGML도 생소하고, 작업환경도 구축하기가 힘드실 경우에는, 상황표에서 SGML 문서를 내려받아, 위의 ``번역상의 주의''를 참고하여 문서를 번역(Windows상의 에디터로 하셔도 좋습니다)하신후, 제출해 주세요. 제출된 문서는 프로젝트 메니저나 다른 임원진이 대신 손보아 드립니다.

창피해 하지 마십시요! 이는 프로젝트에 처음 참가하는 대부분의 사람들이 느끼는 공통사항이며, 활동중인 참여자들도 그러했습니다.