Biên Soạn bản Hướng Dẫn Sử Dụng -- Editing the Manual

You can modify the manual by editing local text files. These files are kept in sync with those online via a repository, based on this the server will update the online manual.

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.

Cập Nhật -- Update

Trước tiên, hãy đảm bảo rằng bản sao địa phương của bản Hướng Dẫn Sử Dụng của bạn được cập nhật với những thay đổi gần đây nhất từ kho lưu trữ trực tuyến bằng cách sử dụng:

svn update

Viết/Ghi -- Writing

Bây giờ bạn có thể chỉnh sửa các tập tin tài liệu, tức là các tập tin .rst bên trong thư mục``manual`` bằng cách sử dụng trình soạn thảo văn bản lựa chọn của bạn.

Hãy đọc bản Hướng Dẫn về Phong Cách Viết -- Writing Style Guide để biết được các quy ước và Hướng Dẫn về Kiểu Cách của Dấu Đánh -- Markup Style Guide để tìm hiểu cách viết bằng ngôn ngữ đánh dấu reStructuredText.

Chúc bạn viết vui vẻ!

Những Thay Đổi Lớn Hơn -- Bigger Changes

Nếu bạn định cho thêm hoặc trùng tu một phần nào đó của bản hướng dẫn, hãy nhớ kiểm tra cẩn thận rằng phần đó chưa được ai viết cả. Ở một số nơi, các tài liệu không được tổ chức nghiêm ngặt, đến nỗi các phần có thể bị trùng lặp, hoặc nằm ở một vị trí bất thường. Trong trường hợp bạn tìm thấy một phần trùng lặp hoặc nằm không đúng chỗ, xin hãy tạo một tác vụ -- create a task -- giải thích vấn đề và có thể cho kèm bản sửa đổi đã viết của mình vào đó nữa.

Trước khi bạn thực hiện bất kỳ sự chỉnh sửa phức tạp nào không đơn giản và khó lý giải (ví dụ: di chuyển các thư mục từ chỗ nọ sang chỗ kia), bạn nên xác minh các thay đổi của mình với một người bảo trì bản hướng dẫn sử dụng, xem xem sự đóng góp của bạn có đi đôi với đường lối của cộng đồng đối với bản hướng dẫn hay không đã. Điều này sẽ đảm bảo sự tận dụng tốt nhất thời gian và lòng tốt của bạn, vì nếu không, rất có thể vì những lý do nào đó, những thay đổi của bạn sẽ gây xung đột và bị từ chối, hoặc cần phải tốn thời gian để xem xét lại. Ví dụ, một người khác có thể đã làm việc trên phần mà bạn muốn thay đổi, hoặc phần này có thể đã được lên kế hoạch để xóa hoặc đi hoặc để cập nhật theo một kế hoạch đã được Blender đặt ra trước đây.

Liên lạc sớm và thường xuyên là chìa khóa để có một môi trường sản xuất hiệu quả, hòng tránh lãng phí nỗ lực của mọi người và để đạt được một bản hướng dẫn sử dụng Blender tốt hơn.

Yêu cầu Giúp Đỡ/Trả lời -- Getting Help/Answers

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 Trò chuyện Blender — Blender Chat.

Bản thân Blender cũng có một hệ thống các nhân viên chịu trách nhiệm về các mô-đun, gồm có các nhân viên phát triển phần mềm và các nghệ sĩ thành viên chịu trách nhiệm thiết kế và bảo trì các bộ phận của Blender mà họ được chỉ định. Xem trang Nhân viên chịu trách nhiệm về các mô-đun -- module owners page -- để biết thêm thông tin.

Duyệt Thảo -- Preview

Xin hãy biên tập và tác tạo bản hướng dẫn sử dụng để duyệt thảo các thay đổi của bạn theo sự hướng dẫn ở đây. Hãy nhớ rằng bạn cũng có thể biên tập duy một chương mà bạn vừa chỉnh sửa, để duyệt thảo nó một cách nhanh chóng. Mở các tập tin .html được tạo trong thư mục build/html dùng trình duyệt các trang mạng (webpage browser) của mình, hoặc làm tươi lại trang đang xem nếu bạn đã mở nó rồi.

Tải Các Thay Đổi Lên -- Upload

Khi bạn đã hài lòng với các thay đổi của mình, bạn có thể tải chúng lên, để chúng hiện hữu trong bản hướng dẫn trực tuyến. Đầu tiên, điều này được thực hiện bằng cách gửi các bản chỉ chứa các thay đổi để chắp vá vào bản hiện tại (patches), để một người nào đó có thể duyệt xét các thay đổi của bạn, và phản hồi ý kiến của họ đối với bạn. Sau đó, bạn có thể trực tiếp thực hiện các thay đổi của mình. Quá trình này sẽ được mô tả chi tiết trong phần tiếp theo.