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

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

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:

make update

쓰기

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

Be sure to check the 서술 스타일(writing style) for conventions and 마크업 스타일(markup style) to learn how to write in the reStructuredText markup language.

이제 마음껏 쓰면 돼요!

크게 바꾸기

If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create an issue explaining the issue, and optionally include a revision (actual changes).

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

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.

Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module owners page for more information.

미리보기

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.

업로드

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