일반적인 주의 사항

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

번역에 대한 안내

오리지널 영어판 문서의 입수
다음의 설명에 따라 cvsup으로 번역 문서를 끌어 옵니다.
1) 패키지에서 cvsup을 설치합니다.
2) 다음 내용을 가진 doc-supfile라는 화일을 만듭니다.
```
  *default host=cvsup.kr.FreeBSD.org
  *default base=/usr
  *default prefix=/usr
  *default release=cvs tag=.
  *default delete use-rel-suffix
  doc-all
```
핸드북 번역하시는 분들 보세요
현재 FreeBSD 핸드북은 기존 Linuxdoc에서 DocBook으로 형식이 변환되었습니다. 우리는 형식의 변화를 쫒기 보다는, 번역물의 완성에 주안점을 두고, 당분간은 기존 Linuxdoc 문서로 작업을 계속 합니다. 따라서, CVS 저장고에서 Linuxdoc 형식의 핸드북을 끌어오기 위해서는 다음과 같은 supfile을 사용해야 합니다. 다음 supfile은 /usr/doc/handbook/ 디렉토리에 핸드북 SGML을 끌어옵니다. (새로운 DocBook 형태의 문서들은 /usr/doc/en/ 에 위치합니다.)
```
  *default host=cvsup.kr.FreeBSD.org
  *default base=/usr
  *default prefix=/usr
  *default release=cvs tag=LINUXDOC_2_DOCBOOK_4
  *default delete use-rel-suffix
  doc-all
```
3) ``cvsup -g -L2 doc-supfile''명령을 주면 /usr/doc/밑에 SGML 소스를 끌어옵니다. 다른 디렉토리로 받고 싶다면 base와 prefix를 그에 맞게 수정하십시요.
좀더 자세한 사항은 handbook의 cvsup장의 "stay with current" 절을 참고하십시요.
번역하는 파일은:
반드시 SGML 문서 파일을 번역합니다. 필요한 도구의 설치 방법에 관해서는 여기를 보세요.
번역상의 주의
- 문체는 가능하면 '-니다'로 통일합니다.
- 모든 번역은 유닉스 텍스트 문서이어야 합니다. 도스용 텍스트 문서나 아래한글, 워드 등으로 번역하면 안됩니다. 번역에는 vi나 emacs등의 텍스트 에디터를 사용합시다. EUC-KR(KSC5601 완성형 코드)를 사용한다는 것도 잊지 마십시요. 사용자의 .emacs파일에 다음 줄을 넣고 emacs의 텍스트 모드(M-x text-mode)를 사용하면 기본적으로 word-wrap을 하도록 되어 있습니다. 이 모드를 가장 권장합니다.
```
(add-hook 'text-mode-hook 'turn-on-auto-fill)
```
- 문서 파일명은 그대로 바꾸지 않습니다.
- SGML의 태그(부등호 <> 로 둘러싸여 있는 부분) 안에 있는 부분 중에서 일반적으로 번역하지 않고 그대로 두는 것이 당연한 부분이 있습니다. 예로
```
<ref id="nutshell" name="FreeBSD in a nutshell">
```
  의 경우，id="nutshell"은 번역하지 않습니다.
- 번역의 관리는 기본적으로 CVS 의 revision 로 하고 있습니다. 예를 들면，파일의 주석 행에
```

```
  라는 것이 있는 경우, 1.7이라는 것이 이 파일의 revision입니다. 이 부분을 다음과 같이 고쳐씁니다.
```



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

작업 환경 구축 방법

필요한 도구는 FreeBSD의 포트/패키지에 포함되고 있기 때문에 간단하게 설치할 수 있습니다. 아래의 포트/패키지를 사용합니다. 전부 textproc 목록으로 분류되어 있습니다.

변환 도구

sgmlformat-1.4: /usr/local/bin/sgmlfmt 의 바이너리
jade-1.0.1: /usr/local/bin/sgmlnorm 등의 바이너리
sp-1.2.1: /usr/local/bin/sgmlnorm 등의 바이너리

SGML의 DTD(문서형 정의)

docbook-3.0: DocBook 의 DTD
html-4.0: HTML의 DTD
linuxdoc-1.0: Linuxdoc의 DTD

잘 모르겠습니다

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

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