Bắt đầu Docsy

Tìm hiểu cách bắt đầu với Docsy, bao gồm các tùy chọn có sẵn để cài đặt và sử dụng chủ đề Docsy.

Như bạn đã thấy trong phần giới thiệu của chúng tôi, Docsy là một chủ đề Hugo , có nghĩa là nếu bạn muốn sử dụng Docsy, bạn cần thiết lập nguồn trang web của mình để trình tạo trang tĩnh Hugo có thể tìm và sử dụng các tệp chủ đề Docsy khi xây dựng trang web của bạn . Cách đơn giản nhất để thực hiện việc này là sao chép và chỉnh sửa trang web mẫu của chúng tôi, mặc dù chúng tôi cũng cung cấp hướng dẫn cách thêm chủ đề Docsy theo cách thủ công vào các trang web mới hoặc hiện có.

Nếu muốn xây dựng và thử nghiệm trang web của mình cục bộ, bạn cũng cần có khả năng chạy Hugo, bằng cách cài đặt nó và bất kỳ phần phụ thuộc bắt buộc nào khác hoặc bằng cách sử dụng vùng chứa Docker được cung cấp của chúng tôi.

Trang này mô tả các tùy chọn cài đặt của Docsy và giúp bạn chọn hướng dẫn thiết lập phù hợp để bắt đầu.

Tùy chọn cài đặt

Hugo cung cấp nhiều tùy chọn để sử dụng chủ đề, tất cả đều được Docsy hỗ trợ.

• Thêm chủ đề làm Mô-đun Hugo : Mô-đun Hugo là cách đơn giản và mới nhất để sử dụng các chủ đề Hugo. Hugo sử dụng cơ chế mô-đun để lấy các tệp chủ đề từ kho lưu trữ Docsy chính ở bản sửa đổi bạn đã chọn và thật dễ dàng để cập nhật chủ đề trên trang web của bạn. Trang web mẫu của chúng tôi sử dụng Docsy làm Mô-đun Hugo.
• Thêm chủ đề dưới dạng mô-đun con Git : Việc thêm chủ đề dưới dạng mô-đun con Git cũng cho phép Hugo sử dụng các tệp chủ đề từ kho lưu trữ của riêng chúng, mặc dù việc duy trì phức tạp hơn so với cách tiếp cận mô-đun Hugo. Đây là phương pháp được sử dụng trong các phiên bản cũ hơn của trang web mẫu Docsy và vẫn được hỗ trợ.
• Sao chép các tệp chủ đề : Nếu bạn không muốn Hugo phải lấy các tệp chủ đề từ một kho lưu trữ bên ngoài (ví dụ: nếu bạn muốn tùy chỉnh và duy trì trực tiếp bản sao chủ đề của riêng mình hoặc lựa chọn triển khai của bạn yêu cầu bạn đưa vào một bản sao của chủ đề trong kho lưu trữ của bạn), bạn có thể sao chép các tệp trực tiếp vào nguồn trang web của mình.

Di chuyển và tương thích ngược

Nếu bạn hiện có một trang web sử dụng Docsy làm mô-đun con Git và bạn muốn cập nhật trang web đó để sử dụng Mô-đun Hugo, hãy làm theo hướng dẫn di chuyển của chúng tôi . Nếu bạn chưa sẵn sàng di chuyển, đừng lo lắng! Trang web của bạn sẽ tiếp tục hoạt động như bình thường.

Hướng dẫn thiết lập

Làm theo hướng dẫn thiết lập cho phương pháp bạn đã chọn. Nếu bạn mới sử dụng Docsy và không chắc chắn nên làm theo hướng dẫn nào thì chúng tôi khuyên bạn nên làm theo hướng dẫn Sử dụng Docsy làm Mô-đun Hugo như một tùy chọn đơn giản và dễ bảo trì.

Nhận xét

Trang này có hữu ích không?