修補和交付

提交修補檔

在前幾次修改手冊時,你需要提交修補檔給管理員審查。這只是為了確保使用手冊的品質,以及避免你在熟悉這套系統之前,不小心破壞了一些重要內容。

為了提交修補檔,請遵循以下流程:

  1. 按照你的想法進行修改。

  2. 執行下列命令建立一個修補檔:

    svn diff > filename.diff
    

    這將建立一個文字檔,記錄你的工作檔對中央存放區內,文字內容的增加、刪除和修改。

    如果您有建立或刪除檔案,你需要在建立差異檔案前,先執行 svn add /path/to/file 或者 svn rm /path/to/file 。查看受影響的文件列表,執行 svn status

  3. 在這裡上傳差異檔案 。如果你還沒有帳號,可以 註冊一個.

  4. 提交差異檔案後,你將被要求 "建立一個新的修改" ,然後就可以增加關於更改的標題和描述。

  5. Please check if the Documentation project is assigned in the tag's field in order to notify the team of your patch. You can also contact the team over the mailing list or Blender Chat.

  6. 他們將審查你的修補檔,告訴你哪些地方還需要修改,或者直接接受並提交你的修補檔。

Note

如果你的修補檔,包括圖片的修改或增加,只需在建立修改時作為附件插入即可。

直截了當的修補檔很快就會被接受。一旦你適應了修改流程並且不再需要反饋之後,我們將去掉中間環節,賦予你直接編輯手冊的權限。

直接交付

交付會將修改直接提交到我們的中央存放區,而不是新建一個修補檔。

你現在只需執行:

svn commit -m "This is what I did"

如果你省略了 -m "message",你將被提示需在文字編輯器中輸入留言。

不要忘記在提交前執行 svn update

提交更改之前,會要求你輸入使用者名稱 (在 developer.blender.org) 和密碼。

你修訂的檔案被上傳到中央存放區,供其他人繼續參與和寫作。交付追蹤記錄在存放區的 Diffusion。很快你的修改就會呈現在線上手冊中了。