Biên tập wiki

Quản trị viên biên tập wiki qua trình duyệt. Trên production, bạn cần quyền ghi vào repo GitHub của wiki. Mở Quản trị để chỉnh nội dung và bản dịch.

Chọn ngôn ngữ

• Docs · Tiếng Việt, Docs · Français và các mục tương tự chứa cây tài liệu của từng ngôn ngữ.
• Giữ cùng đường dẫn, ví dụ guides/configuration, để bộ chọn ngôn ngữ mở đúng trang tương ứng.
• Trong Bài viết và Danh mục plugin, dùng chức năng ngôn ngữ của editor để dịch cạnh bản English. Giữ nguyên slug.
• Trong Cấu hình website, chọn ngôn ngữ tương ứng để sửa trang chủ, menu và liên kết nhanh. Tên website, Discord và GitHub là cấu hình dùng chung.

Viết và đăng

1. Chọn mục và ngôn ngữ cần sửa.
2. Điền tiêu đề, mô tả và nội dung Markdown; dùng thư viện media để thêm ảnh.
3. Đặt thứ tự sidebar cho trang tài liệu.
4. Bật Bản nháp khi nội dung chưa sẵn sàng.
5. Kiểm tra bản dịch rồi tắt Bản nháp và đăng.

Trang chưa có bản dịch sẽ hiển thị nội dung English cùng thông báo. Bản dịch đang ở trạng thái nháp không được công bố; bài đã có bản English vẫn có thể hiển thị bản đó.

Thao tác đăng ghi thay đổi vào GitHub. Website hiện deploy thủ công bằng Wrangler; người quản lý cần build và deploy nội dung mới để thay đổi xuất hiện. Muốn tự cập nhật cần cấu hình workflow riêng. Xem trước trong editor chỉ phản ánh nội dung, không phải toàn bộ bố cục website.

Chạy local

Chạy npm run dev và npm run cms trong hai terminal. Mở http://localhost:4321/admin/. Editor local ghi file vào repo, không tự commit hoặc push.

Ẩn khỏi sidebar không làm trang riêng tư. Dùng Bản nháp để loại nội dung khỏi bản build công khai và tìm kiếm.