Sửa Đổi và Nhập Kho -- 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 (patches) để 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/chắp vá (patch) 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/filehoặcsvn rm /path/to/filetrước khi tạo bản liệt kê sự chênh lệch (diff). Để xem danh sách các tập tin bị ảnh hưởng, hãy thi hành lệnhsvn status.Tải tập tin liệt kê sự chênh lệch lên đây. Nếu bạn chưa có tài khoản thì bạn có thể đăng ký lấy một cái.
Sau khi gửi bản liệt kê sự chênh lệch, bạn sẽ bị yêu cầu "Tạo bản chỉnh sửa mới" (Create a new Revision) trước khi bạn có thể thêm tiêu đề và mô 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 (Documentation project) được ấn định trong ô tags (Dấu Hiệu), để 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ư (mailing list) hoặc qua Trò chuyện Blender — Blender Chat (trò chuyện về blender trực tuyến).
Họ sẽ xem xét bản liệt kê sửa đổi của bạn và báo cho bạn biết về bất kỳ thay đổi về những sửa đổi của bạn mà bạn có thể phải làm lại hoặc là chuyển giao những sửa đổi của bạn vào kho (commit) nếu được chấp nhận.
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 (revision).
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¶
Thay vì tạo tập tin liệt kê các sửa đổi, quá trình nhập kho sẽ trực tiếp đưa các thay đổi vào kho lưu trữ trung tâm của chúng tôi.
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 báo", thì bạn sẽ được nhắc nhở là bạn cần phải nhập thông báo 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ại developer.blender.org) và mật khẩu, trước khi thay đổi được chuyển giao để 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ẽ rất nhanh chóng được đăng trong bản hướng dẫn sử dụng trực tuyến.