원본 영어 사용설명서 수정하기

You can modify the manual by editing local text files. These files are kept in sync with those online via a repository, based on this the server will update the online manual.

The manual is written in the reStructuredText (RST) markup language and can be edited using a plain text editor. For a local preview, you convert (build) the manual source files from RST into HTML web pages.

업데이트

우선, 자기 컴퓨터 속 동기화 폴더의 내용물이 서버 저장소의 최신 파일들과 맞는지 확인해주세요. 이 명령어를 쓰면 돼요.

svn update

쓰기

이제 텍스트 편집기로 manual 폴더 안에 있는 .rst 파일들을 수정하면 돼요.

서술 스타일(writing style) 에서 서술 규칙을, 마크업 스타일(markup style) 에서 RST 마크업 언어(restructuredtext markup language)로 쓰는 방법을 배울 수 있어요.

이제 마음껏 쓰면 돼요!

크게 바꾸기

섹션을 추가하거나 갈아엎을 경우 중복되는 부분은 없는지 확인해 주세요. 사용설명서 일부에서는 문서가 뒤죽박죽이어서 섹션이 중복되거나 이상한 곳에 눌러앉아 있을 수도 있어요. 중복되거나 제자리에서 가출한 섹션을 발견했다면, 작업 만들기 에서 문제를 설명하고, 원한다면 개정 파일도 올려주세요.

간단하지도 않고 자의적인 수정(예를 들어 폴더를 이동하는 경우가 있겠죠)을 하기 전에는 사용설명서 관리자에게 왜 그렇게 하는지 설득을 해야 돼요. 그래야 기여자님의 시간도 절약되고 맥없이 수정사항을 거부당하는 일이 없을 테니까요. 예를 들어 다른 사람이 이미 그 섹션에서 막 수정을 하고 있거나, 섹션이 삭제 예정이거나 블렌더 변경사항에 따라 업데이트 될 예정이라면 이렇게 해야 충돌을 피할 수 있어요.

Communicating 에 필요할 때마다 연락해 주세요. 그래야 효율적이고, 서로의 노력이 안 버려지도록 확인하면서 이 사용설명서를 채울 수 있으니까요.

도움을 청하거나 질문하기

If you are in doubt about functionality that you wish to document, you should pose your questions to the Blender developers responsible for that area or ask at the unofficial user support channel in the #docs or #blender-coders channel in Blender Chat.

블렌더에는 여러 영역별로 디자인과 유지 보수를 담당하는 개발자나 멤버가 나누어져 있는 모듈 소유자 시스템이 있답니다. module owners page 에 더 자세한 내용이 있어요.

미리보기

내가 수정한 내용을 바로 확인하고 싶다면, 이 방법대로 사용설명서를 스스로 빌드(build)해 보세요. 빠르게 빌드하고 싶다면 내가 수정했던 섹션만 빌드할 수도 있답니다. 빌드하고 나면 build/html 폴더 속에 내가 빌드한 ``html``파일들이 들어 있을 텐데, 웹 브라우저로 보면 사용설명서에 반영될 내용이 그대로 보일 거예요.

업로드

다 했다 싶으면 업로드하면 돼요. 그러면 온라인 사용설명서에 반영이 될 거예요. 처음에는 다른 사람들이 검토하고 피드백을 줄 수 있도록 패치 형태로 올려야 하지만, 몇 번 하다 보면 직접 하도록 허용해줄 거예요. 이 과정은 다음 섹션에서 자세히 설명되어 있어요.