(được dịch từ bản tiếng Anh, liên kết vẫn ra trang tiếng Anh nhé!)
Đây là mẫu tối thiểu để tạo trang web Jekyll sử dụng theme Just the Docs. Bạn có thể dễ dàng thiết lập để trang web đã tạo được xuất bản trên GitHub Pages – tệp README giải thích cách thực hiện điều đó, cùng với các chi tiết khác.
Nếu Jekyll được cài đặt trên máy tính của bạn, bạn cũng có thể tạo và xem trước trang web đã tạo cục bộ. Điều này cho phép bạn kiểm tra các thay đổi trước khi thực hiện chúng và tránh phải chờ GitHub Pages.1 Ngoài ra, bạn sẽ có thể triển khai bản dựng cục bộ của mình sang một nền tảng khác với GitHub Pages.
Cụ thể hơn, trang web đã tạo:
- sử dụng cách tiếp cận dựa trên gem, tức là sử dụng
Gemfile
và tải gemjust-the-docs
- sử dụng workflow GitHub Pages / Actions để xây dựng và xuất bản trang web trên GitHub Pages
Ngoài ra, bạn có thể tự do tùy chỉnh các trang web mà bạn tạo bằng mẫu này theo cách bạn muốn. Bạn có thể dễ dàng thay đổi các phiên bản của just-the-docs
và Jekyll mà nó sử dụng, cũng như bổ sung thêm các plugin khác.
Xem tài liệu của chúng tôi để tìm hiểu thêm về cách sử dụng chủ đề này.
Để bắt đầu tạo một trang web, chỉ cần nhấp vào “use this template”!
Nếu bạn muốn duy trì tài liệu của mình trong thư mục docs
của repository dự án hiện có, hãy xem phần Lưu trữ tài liệu của bạn từ repository dự án hiện có trong tệp README của mẫu.