How do I use GitHub Pages?

Xuất bản nội dung

GitHub là một cộng đồng rất quan trọng và hữu ích để tham gia, và Git/GitHub là một hệ thống kiểm soát phiên bản rất phổ biến — hầu hết các công ty công nghệ hiện nay sử dụng nó trong quy trình làm việc của họ. GitHub có một tính năng rất hữu ích gọi là GitHub Pages, cho phép bạn xuất bản code trang web trực tiếp lên Web.

Thiết lập GitHub cơ bản

1. Trước tiên, cài đặt Git trên máy của bạn. Đây là phần mềm hệ thống kiểm soát phiên bản nền tảng mà GitHub hoạt động dựa trên.
2. Tiếp theo, đăng ký tài khoản GitHub. Đơn giản và dễ dàng.
3. Sau khi đăng ký, hãy đăng nhập vào github.com bằng tên người dùng và mật khẩu của bạn.

Chuẩn bị code để tải lên

Bạn có thể lưu trữ bất kỳ code nào bạn thích trong kho lưu trữ GitHub, nhưng để sử dụng tính năng GitHub Pages đầy đủ, code của bạn nên được cấu trúc như một trang web điển hình, ví dụ: với điểm vào chính là tệp HTML được gọi là index.html.

Điều khác bạn cần làm trước khi tiếp tục là khởi tạo thư mục code của bạn như một kho lưu trữ Git. Để làm điều này:

1. Trỏ dòng lệnh đến thư mục test-site (hoặc bất cứ tên gì bạn đặt cho thư mục chứa trang web của mình). Để làm điều này, sử dụng lệnh cd (tức là "change directory" - thay đổi thư mục). Đây là những gì bạn sẽ gõ nếu bạn đã đặt trang web vào một thư mục tên test-site trên màn hình desktop của mình:

   bash

   cd Desktop/test-site
   

2. Khi dòng lệnh đang trỏ vào thư mục trang web của bạn, hãy gõ lệnh sau, lệnh này yêu cầu công cụ git chuyển thư mục thành kho lưu trữ git:

   bash

   git init
   

Một lưu ý về giao diện dòng lệnh

Cách tốt nhất để tải code của bạn lên GitHub là qua dòng lệnh — đây là cửa sổ nơi bạn gõ lệnh để làm những việc như tạo tệp và chạy chương trình, thay vì nhấp bên trong giao diện người dùng. Nó sẽ trông như thế này:

Mỗi hệ điều hành đều có công cụ dòng lệnh:

• Windows: Command Prompt có thể truy cập bằng cách nhấn phím Windows, gõ Command Prompt và chọn nó từ danh sách xuất hiện. Lưu ý rằng Windows có các quy ước lệnh riêng khác với Linux và macOS, vì vậy các lệnh bên dưới có thể khác trên máy của bạn.
• macOS: Terminal có thể tìm thấy trong Applications > Utilities.
• Linux: Thường bạn có thể mở terminal bằng Ctrl + Alt + T. Nếu điều đó không hoạt động, hãy tìm Terminal trong thanh ứng dụng hoặc menu.

Điều này có vẻ hơi đáng sợ lúc đầu, nhưng đừng lo — bạn sẽ sớm nắm được những điều cơ bản. Bạn yêu cầu máy tính làm gì đó trong terminal bằng cách gõ lệnh và nhấn Enter, như đã thấy ở trên.

Tạo kho lưu trữ cho code của bạn

1. Tiếp theo, bạn cần tạo một kho lưu trữ mới để đặt tệp vào. Nhấp vào Dấu cộng (+) ở góc trên bên phải của trang chủ GitHub, sau đó chọn New Repository.
2. Trên trang này, trong ô Repository name, nhập tên cho kho lưu trữ code của bạn, ví dụ my-repository.
3. Cũng điền vào phần mô tả để nói trang web của bạn sẽ chứa gì. Màn hình của bạn sẽ trông như thế này:
4. Nhấp Create repository; điều này sẽ đưa bạn đến trang sau:

Tải tệp của bạn lên GitHub

1. Trên trang hiện tại, bạn quan tâm đến phần …or push an existing repository from the command line. Bạn sẽ thấy hai dòng code được liệt kê trong phần này. Sao chép toàn bộ dòng đầu tiên, dán vào dòng lệnh và nhấn Enter. Lệnh sẽ trông giống như thế này:

   bash

   git remote add origin https://github.com/chrisdavidmills/my-repository.git
   

2. Tiếp theo, gõ hai lệnh sau, nhấn Enter sau mỗi lệnh. Chúng chuẩn bị code để tải lên GitHub và yêu cầu Git quản lý các tệp này.

   bash

   git add --all
   git commit -m 'adding my files to my repository'
   

3. Cuối cùng, đẩy code lên GitHub bằng cách đến trang web GitHub bạn đang mở và nhập vào terminal lệnh thứ hai trong hai lệnh chúng ta thấy trong phần …or push an existing repository from the command line:

   bash

   git push -u origin main
   

4. Bây giờ bạn cần bật GitHub pages cho kho lưu trữ của mình. Để làm điều này, từ trang chủ của kho lưu trữ chọn Settings, sau đó chọn Pages từ thanh bên trái. Bên dưới Source, chọn nhánh "main". Trang sẽ tải lại.

5. Đến phần GitHub Pages một lần nữa, và bạn sẽ thấy một dòng có dạng "Your site is ready to be published at https://xxxxxx."

6. Nếu bạn nhấp vào URL này, bạn sẽ đến phiên bản trực tiếp của ví dụ của mình, miễn là trang chủ có tên là index.html — nó sẽ đến điểm vào này theo mặc định. Nếu điểm vào của trang web của bạn có tên khác, ví dụ myPage.html, bạn cần đến https://xxxxxx/myPage.html.

Kiến thức GitHub thêm

Nếu bạn muốn thực hiện thêm thay đổi cho trang web kiểm thử và tải những thay đổi đó lên GitHub, bạn cần thực hiện thay đổi cho các tệp của mình như trước. Sau đó, bạn cần nhập các lệnh sau (nhấn Enter sau mỗi lệnh) để đẩy những thay đổi đó lên GitHub:

git add --all
git commit -m 'another commit'
git push

Bạn có thể thay another commit bằng một thông điệp phù hợp hơn mô tả thay đổi bạn vừa thực hiện.

Chúng ta mới chỉ đề cập sơ qua về Git. Để tìm hiểu thêm, hãy xem trang Git và GitHub của chúng tôi.