編輯手冊

更新

首先,確認你手冊的本機副本和線上存放區一樣是最新的:

svn update

編寫

現在你可以選擇文字編輯器編輯文件檔案, 這些文件位於 manual 資料夾中的 .rst 檔案。

務必查看 Writing Style Guide 中的規定和 Markup Style Guide 學習如何使用 reStructuredText 標記語言寫作。

開始寫作吧!

較大的修改

如果你打算增加或大修某一節,一定要仔細檢查,確保現有手冊沒有這些內容。在某些地方,文件是如此雜亂無章,以至於一些章節內容重覆或者位於某個奇怪的位置。在你找到一個重覆或位置不當的章節後,請 新建一個任務 將問題解釋清楚,還可以附帶一個修正版本(實際修改)。

在你做了一些不那麽簡單明瞭的修改之前(如,移動文件夾),你需要與手冊維護人員確認你的貢獻與社群對手冊的設想是一致的。這能確保你的時間與善意得到最好的利用,否則的話,因為某些原因,你的修改可能會因造成衝突而被駁回或者經歷費時的審查。例如,另外一個人可能已經在負責你想要修改的章節,這一節可能已經計劃要刪除,或者根據Blender的變化而相應更新。

早一點與頻繁地 交流 ,是維持一個高產能環境的關鍵,這樣才不至於浪費別人的努力,並且完成一份更好的Blender手冊。

獲得幫助/答案

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.

預覽

想要查看你的修改,可以 參照說明 建立手冊。請記住,你也可以只建立你已經編輯好的章節來快速預覽。進入 build/html 資料夾,使用網頁瀏覽器開啟的 .html 文件,或如果你已經打開的話,可以直接刷新頁面。

上傳

如果你很滿意自己的修改,您可以將它們上傳,將其呈現於在線手冊中。首先,這是由提交修補版本,從而使他人可以審查你的修改,並給您反饋完成。之後,你可以直接提交更改。下一節會詳細介紹相關流程。