17

Tôi đã sử dụng các trang GitHub để tạo một trang web đẹp cho dự án của tôi (this one). Bây giờ tôi muốn giữ tài liệu của dự án của tôi được cập nhật và có mọi thứ trong một tệp README.md duy nhất có lẽ không thể mở rộng được với nhiều tính năng mà chúng tôi đang thêm vào.Cách tạo trang web từ các trang GitHub wiki

Vì vậy, tôi nghĩ rằng nơi tốt nhất để giữ tài liệu là wiki GitHub, nhưng tôi muốn tích hợp wiki vào trang được tạo trang gh, giữ bố cục đẹp.

Làm cách nào để sử dụng GitHub wiki và tạo trang web HTML có bố cục tùy chỉnh?

Trả lời

6

Dưới đây là một URL ví dụ cho một wiki:

http://github.com/antirez/redis/wiki

Trên trang cùng bạn sẽ tìm thấy một liên kết bản sao:

git clone http://github.com/antirez/redis.wiki 

Sau đó chạy file Markdown qua Jekyll hoặc thậm chí tạo một kho lưu trữ mới cho trang chủ lưu trữ dựa trên Wiki.

+3

Có hướng dẫn nào đó về vấn đề này không? Làm thế nào để chạy một GitHub wiki thông qua Jekyll? – Richard

+1

Tài liệu xin vui lòng? – BrianTheLion

+0

Tôi đã sử dụng Jekyll và nó hoạt động rất tốt. Tôi đã phát triển giải pháp của riêng mình để cập nhật mọi thứ. Cảm ơn gợi ý. –

1

Bạn có thể bao gồm wiki của mình dưới dạng subtree.

BTW, GitHub Các trang hiện không còn cần chi nhánh gh-pages nữa. Tạo kho lưu trữ có tên your-user-name.github.io; nó sẽ tự động tạo ra một trang web. Xem GitHub Pages để biết thêm chi tiết.

+1

Có sự khác nhau giữa trang _user_ (sử dụng phương thức '* .github.io') và trang _project_ (sử dụng phương pháp' gh-pages'). – heltonbiker

Các vấn đề liên quan