Bản Liệt Kê Sửa Đổi và Chuyển Giao Sửa Đổi -- Patch & Commit¶
Đệ Trình các Sửa Đổi -- Submit Patches¶
Một vài lần đầu thực hiện các thay đổi trong sách hướng dẫn, bạn sẽ cần phải gửi chúng đến dưới dạng một bản liệt kê các sửa đổi để quản trị viên xét duyệt. Điều này chỉ là để nhằm đảm bảo rằng chúng tôi duy trì bản hướng dẫn sử dụng có chất lượng tốt, và rằng bạn sẽ không vô tình mà làm hỏng bất cứ một điều gì trọng yếu, trước khi bạn trở nên thành thục với hệ thống.
Để gửi bản liệt kê các sửa đổi, xin hãy làm theo quy trình sau đây:
Thực hiện bất kỳ thay đổi nào mà bạn mong muốn.
Tạo bản liệt kê sửa đổi bằng cách thi hành:
svn diff > filename.diff
Điều này tạo ra một tập tin văn bản đơn giản, cho thấy văn bản nào đã được thêm vào, xóa hoặc thay đổi giữa các tập tin đang làm việc của bạn và kho lưu trữ trung tâm.
Nếu bạn đã kiến tạo bản mới, hoặc đã xóa các tập tin đi, thì bạn sẽ cần phải thi hành 'svn add /path/to/file' hoặc 'svn rm /path/to/file' trước khi tạo bản liệt kê sự chênh lệch. Để xem danh sách các tập tin bị ảnh hưởng, hãy thi hành lệnh 'svn status'>.
Tải tập tin liệt kê sự chênh lệch lên đây -- Upload the diff file here. Nếu bạn chưa có tài khoản thì bạn có thể đăng ký lấy một cái -- register for one.
Sau khi gửi bản liệt kê sự chênh lệch, bạn sẽ được yêu cầu "Tạo một bản chỉnh sửa mới" trước khi bạn có thể thêm tiêu đề và miêu tả về các thay đổi của mình.
Vui lòng kiểm tra xem dự án Viết Tài Liệu được ấn định trong ô tags, để thông báo cho nhóm điều hành biết về sửa đổi của bạn. Bạn cũng có thể Liên Lạc -- contact với nhóm điều hành dùng danh sách gửi thư hoặc qua trò chuyện về blender trực tuyến -- blender-chat.
They will review your patch and let you know about any changes you could make. If there is no issue, your patch will be accepted and then committed by the team of your patch.
Ghi chú
Nếu bản sửa đổi của bạn bao gồm các thay đổi trong các hình ảnh hoặc có các hình ảnh bổ sung thì bạn chỉ cần đính kèm chúng khi bạn tạo phiên bản sửa đổi mới.
Các bản liệt kê sửa đổi đơn giản chắc chắn sẽ được chấp nhận rất nhanh. Một khi bạn đã thành thục với việc thực hiện các thay đổi và không cần sự hỗ trợ nữa, chúng tôi sẽ cắt bỏ người trung gian và cho phép bạn quyền truy cập trực tiếp để chỉnh sửa bản hướng dẫn sử dụng.
Trực Tiếp Chuyển Giao Sửa Đổi vào Kho Lưu Trữ -- Commit Directly¶
Once you are provided with the direct access to edit the manual, you can start committing directly instead of creating a patch file. Doing this will submit the change directly to our central repository.
Bạn chỉ cần thi hành:
svn commit -m "This is what I did"
Nếu bạn không đánh '-m "thông điệp"', thì bạn sẽ được nhắc nhở là bạn cần phải nhập thông điệp trong một trình soạn thảo văn bản riêng.
Đừng bao giờ quên thi hành lệnh cập nhật 'svn update' trước khi chuyển giao các sửa đổi vào kho dự trữ.
Sau đó, bạn sẽ phải điền tên người dùng của mình (từ developer.blender.org) và mật khẩu, trước khi thay đổi được chuyển giao vào kho để lưu lại.
Các tập tin đã sửa đổi của bạn sẽ được tải lên kho lưu trữ trung tâm để những người khác tiếp tục làm việc và cộng tác. Các chuyển giao về sửa đổi sẽ được lưu trữ và theo dõi trong kho Diffusion. Các thay đổi của bạn sẽ được đăng trong bản hướng dẫn sử dụng trực tuyến.