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

사용설명서 서버의 보관함과 동기화되도록 세팅된 기여자님 컴퓨터 폴더 속의 텍스트 파일을 수정해서 기여할 수 있어요. 이 서버를 기반으로 온라인 사용설명서가 업데이트 될 거예요.

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.

업데이트

Firstly, make sure that your local copy of the manual is up to date with the online repository using:

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 에 더 자세한 내용이 있어요.

미리보기

To view your changes, build the manual as instructed. Keep in mind that you can also build only the chapter you just edited to view it quickly. Open the generated .html files inside the build/html folder using your web browser, or refresh the page if you have it open already.

업로드

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