Skip to main content

Creating a GitHub Pages site - GitHub Docs

Bạn có thể tạo trang GitHub Pages trong kho lưu trữ mới hoặc hiện có.

Ai có thể sử dụng tính năng này?​

GitHub Pages có sẵn trong các kho lưu trữ công cộng với GitHub Free và GitHub Free dành cho tổ chức, và trong các kho lưu trữ công cộng và riêng tư với GitHub Pro, GitHub Team, GitHub Enterprise Cloud và GitHub Enterprise Server. Để biết thêm thông tin, hãy xem " Kế hoạch của GitHub ".

GitHub Pages hiện sử dụng GitHub Actions để thực thi bản dựng Jekyll. Khi sử dụng nhánh làm nguồn bản dựng của bạn, GitHub Actions phải được bật trong kho lưu trữ của bạn nếu bạn muốn sử dụng quy trình làm việc Jekyll tích hợp. Ngoài ra, nếu GitHub Actions không khả dụng hoặc bị tắt, việc thêm tệp .nojekyllvào gốc nhánh nguồn của bạn sẽ bỏ qua quy trình dựng Jekyll và triển khai nội dung trực tiếp. Để biết thêm thông tin về cách bật GitHub Actions, hãy xem " Quản lý cài đặt GitHub Actions cho kho lưu trữ ".

Tạo kho lưu trữ cho trang web của bạn​

Bạn có thể tạo một kho lưu trữ hoặc chọn một kho lưu trữ hiện có cho trang web của mình.

Nếu bạn muốn tạo một trang GitHub Pages cho một kho lưu trữ mà không phải tất cả các tệp trong kho lưu trữ đều liên quan đến trang web, bạn sẽ có thể định cấu hình nguồn xuất bản cho trang web của mình. Ví dụ: bạn có thể có một nhánh và thư mục chuyên dụng để lưu trữ các tệp nguồn trang web của mình hoặc bạn có thể sử dụng quy trình làm việc GitHub Actions tùy chỉnh để xây dựng và triển khai các tệp nguồn trang web của mình.

Nếu tài khoản sở hữu kho lưu trữ sử dụng GitHub Free hoặc GitHub Free dành cho tổ chức, kho lưu trữ đó phải là công khai.

Nếu bạn muốn tạo một trang web trong kho lưu trữ hiện có, hãy chuyển đến phần " Tạo trang web của bạn ".

  1. Ở góc trên bên phải của bất kỳ trang nào, hãy chọn , sau đó nhấp vào Kho lưu trữ mới .

    Ảnh chụp màn hình menu thả xuống GitHub hiển thị các tùy chọn để tạo mục mới. Mục menu "Kho lưu trữ mới" được phác thảo bằng màu cam đậm.

  2. Sử dụng menu thả xuống Chủ sở hữu để chọn tài khoản bạn muốn sở hữu kho lưu trữ.

    Ảnh chụp màn hình menu chủ sở hữu cho kho lưu trữ GitHub mới. Menu hiển thị hai tùy chọn, octocat và github.

  3. Nhập tên cho kho lưu trữ của bạn và mô tả tùy chọn. Nếu bạn đang tạo trang web người dùng hoặc tổ chức, kho lưu trữ của bạn phải được đặt tên là <user>.github.iohoặc <organization>.github.io. Nếu tên người dùng hoặc tổ chức của bạn chứa chữ cái viết hoa, bạn phải viết thường các chữ cái. Để biết thêm thông tin, hãy xem " About GitHub Pages ."

    Ảnh chụp màn hình cài đặt GitHub Pages trong một kho lưu trữ. Trường tên kho lưu trữ chứa văn bản "octocat.github.io" và được viền màu cam đậm.

  4. Chọn khả năng hiển thị kho lưu trữ. Để biết thêm thông tin, hãy xem " Giới thiệu về kho lưu trữ ".

  5. Chọn Khởi tạo kho lưu trữ này bằng README .

  6. Nhấp vào Tạo kho lưu trữ .

Tạo trang web của bạn​

Trước khi bạn có thể tạo trang web của mình, bạn phải có một kho lưu trữ cho trang web của mình trên GitHub. Nếu bạn không tạo trang web của mình trong một kho lưu trữ hiện có, hãy xem " Tạo kho lưu trữ cho trang web của bạn ".

Cảnh báo : Các trang GitHub Pages có sẵn công khai trên internet, ngay cả khi kho lưu trữ của trang web là riêng tư (nếu kế hoạch hoặc tổ chức của bạn cho phép). Nếu bạn có dữ liệu nhạy cảm trong kho lưu trữ của trang web, bạn có thể muốn xóa dữ liệu trước khi xuất bản. Để biết thêm thông tin, hãy xem " Giới thiệu về kho lưu trữ ".

  1. Trên GitHub, hãy điều hướng đến kho lưu trữ của trang web bạn.

  2. Quyết định nguồn xuất bản nào bạn muốn sử dụng. Để biết thêm thông tin, hãy xem " Cấu hình nguồn xuất bản cho trang GitHub Pages của bạn ".

  3. Tạo tệp nhập cho trang web của bạn. GitHub Pages sẽ tìm tệp index.html, index.md, hoặc README.mdlàm tệp nhập cho trang web của bạn.

    Nếu nguồn xuất bản của bạn là nhánh và thư mục, tệp mục nhập phải nằm ở cấp cao nhất của thư mục nguồn trên nhánh nguồn. Ví dụ, nếu nguồn xuất bản của bạn là thư /docsmục trên mainnhánh, tệp mục nhập của bạn phải nằm trong /docsthư mục trên nhánh có tên là main.

    Nếu nguồn xuất bản của bạn là quy trình làm việc GitHub Actions, hiện vật mà bạn triển khai phải bao gồm tệp mục nhập ở cấp cao nhất của hiện vật. Thay vì thêm tệp mục nhập vào kho lưu trữ của bạn, bạn có thể chọn để quy trình làm việc GitHub Actions tạo tệp mục nhập của bạn khi quy trình làm việc chạy.

  4. Cấu hình nguồn xuất bản của bạn. Để biết thêm thông tin, hãy xem " Cấu hình nguồn xuất bản cho trang GitHub Pages của bạn ".

  5. Dưới tên kho lưu trữ của bạn, hãy nhấp vào Cài đặt . Nếu bạn không thấy tab "Cài đặt", hãy chọn menu thả xuống, sau đó nhấp vào Cài đặt .

    Ảnh chụp màn hình tiêu đề kho lưu trữ hiển thị các tab. Tab "Cài đặt" được tô sáng bằng đường viền màu cam đậm.

  6. Trong phần "Mã và tự động hóa" của thanh bên, hãy nhấp vào Trang .

  7. Để xem trang web đã xuất bản của bạn, trong "Trang GitHub", hãy nhấp vào Truy cập trang web .

    Ảnh chụp màn hình tin nhắn xác nhận cho GitHub Pages liệt kê URL của trang web. Bên phải URL, một nút có nhãn "Truy cập trang web" được viền màu cam đậm.

    Lưu ý: Có thể mất tới 10 phút để các thay đổi trên trang web của bạn được công bố sau khi bạn đẩy các thay đổi lên GitHub. Nếu bạn không thấy các thay đổi trên trang GitHub Pages của mình được phản ánh trong trình duyệt sau một giờ, hãy xem " Giới thiệu về lỗi xây dựng Jekyll cho các trang GitHub Pages ".

  8. Trang GitHub Pages của bạn được xây dựng và triển khai bằng quy trình làm việc GitHub Actions. Để biết thêm thông tin, hãy xem " Xem lịch sử chạy quy trình làm việc ".

    Lưu ý: GitHub Actions miễn phí cho các kho lưu trữ công cộng. Phí sử dụng áp dụng cho các kho lưu trữ riêng tư và nội bộ vượt quá số phút miễn phí hàng tháng. Để biết thêm thông tin, hãy xem " Giới hạn sử dụng, thanh toán và quản trị ".

Ghi chú :

  • Nếu bạn đang xuất bản từ một nhánh và trang web của bạn chưa được xuất bản tự động, hãy đảm bảo rằng ai đó có quyền quản trị và địa chỉ email đã xác minh đã đẩy lên nguồn xuất bản.

  • Các cam kết được đẩy bởi quy trình làm việc GitHub Actions sử dụng GITHUB_TOKENkhông kích hoạt bản dựng GitHub Pages.

Các bước tiếp theo​

Bạn có thể thêm nhiều trang hơn vào trang web của mình bằng cách tạo thêm nhiều tệp mới. Mỗi tệp sẽ có sẵn trên trang web của bạn trong cùng cấu trúc thư mục với nguồn xuất bản của bạn. Ví dụ: nếu nguồn xuất bản cho trang web dự án của bạn là gh-pagesnhánh và bạn tạo một tệp mới có tên /about/contact-us.mdtrên gh-pagesnhánh, tệp sẽ có sẵn tại https://<user>.github.io/<repository>/about/contact-us.html.

Bạn cũng có thể thêm chủ đề để tùy chỉnh giao diện trang web của mình. Để biết thêm thông tin, hãy xem " Thêm chủ đề vào trang GitHub Pages của bạn bằng Jekyll ".

Để tùy chỉnh trang web của bạn nhiều hơn nữa, bạn có thể sử dụng Jekyll, một trình tạo trang web tĩnh có hỗ trợ tích hợp cho GitHub Pages. Để biết thêm thông tin, hãy xem " Giới thiệu về GitHub Pages và Jekyll ".

Đọc thêm​

5:11:26 AM