Dự án Hello World là một truyền thống lâu đời trong lập trình máy tính. Đây là một bài tập đơn giản giúp bạn bắt đầu khi học một cái gì đó mới. Hãy bắt đầu với GitHub!
Bạn có thể học cách:
- Tạo và sử dụng một kho lưu trữ (repository)
- Bắt đầu và quản lý một nhánh (branch) mới
- Thay đổi tệp và đẩy chúng vào GitHub như Cam kết (commit)
- Mở và hợp nhất một yêu cầu kéo (Pull request)
GitHub là gì?
GitHub là một nền tảng lưu trữ, kiểm soát và cộng tác các phiên bản của mã nguồn. Nó cho phép bạn và những người khác làm việc cùng nhau trên các dự án từ bất cứ đâu.
Hướng dẫn này dạy cho bạn các yếu tố cần thiết của GitHub như kho lưu trữ, phân nhánh, cam kết và kéo mã nguồn. Bạn có thể tạo kho lưu trữ Hello-World của riêng bạn và tìm hiểu quy trình làm việc yêu cầu kéo mã nguồn của GitHub, một cách phổ biến để tạo và xem lại mã nguồn.
Không cần viết mã
Để hoàn thành hướng dẫn này, bạn cần có tài khoản GitHub.com và truy cập Internet. Bạn không cần phải biết cách viết mã, sử dụng dòng lệnh hoặc cài đặt Git (phần mềm kiểm soát phiên bản GitHub được xây dựng).
Bước 1: Tạo kho lưu trữ
Một kho lưu trữ thường được sử dụng để tổ chức một dự án duy nhất. Các kho lưu trữ có thể chứa các thư mục và tệp, hình ảnh, video, bảng tính và bộ dữ liệu - bất cứ thứ gì mà dự án của bạn cần. Chúng tôi khuyên bạn nên bao gồm README hoặc tệp có thông tin về dự án của bạn. GitHub giúp bạn dễ dàng thêm một cái cùng lúc bạn tạo kho lưu trữ mới của mình. Nó cũng cung cấp các tùy chọn phổ biến khác như tệp giấy phép.
Kho lưu trữ "hello-world của bạn có thể là nơi bạn lưu trữ ý tưởng, tài nguyên hoặc thậm chí chia sẻ và thảo luận mọi thứ với người khác.
Tạo một kho lưu trữ mới
- Ở góc trên bên phải, bên cạnh hình đại diện hoặc nhận dạng của bạn, nhấp vào nút "+" và sau đó chọn Kho lưu trữ mới (New repository).
- Đặt tên cho kho lưu trữ của bạn "hello-world".
- Viết một mô tả ngắn.
- Chọn Khởi tạo kho lưu trữ này với README.
- Nhấp vào nút "Create Repository"
Bước 2: Tạo một nhánh
Phân nhánh là cách để làm việc trên các phiên bản khác nhau của một kho lưu trữ cùng một lúc.
Theo mặc định, kho lưu trữ của bạn có một nhánh có tên là "master" được coi là nhánh cuối cùng. Chúng tôi sử dụng các nhánh để thử nghiệm và thực hiện các chỉnh sửa trước khi cam kết chúng là "master".
Khi bạn tạo một nhánh ra khỏi nhánh chính, bạn sẽ tạo một bản sao hoặc ảnh chụp nhanh chính như tại thời điểm đó. Nếu ai đó đã thay đổi chi nhánh chính trong khi bạn đang làm việc trên chi nhánh của mình, bạn có thể cập nhật những cập nhật đó.
Sơ đồ này cho thấy:
- Nhánh chính (master branch)
- Một nhánh mới được gọi là tính năng (feature) (vì chúng tôi đang thực thi các tính năng trên nhánh này)
- Hành trình mà "tính năng" này thực hiện trước khi nó sáp nhập vào chính
Bạn đã bao giờ lưu các phiên bản khác nhau của một tập tin? Giống như:
- story.txt
- story-joe-edit.txt
- story-joe-edit-review.txt
Các nhánh hoàn thành các mục tiêu tương tự trong kho GitHub.
Tại GitHub, các nhà phát triển, nhà văn và nhà thiết kế của chúng tôi sử dụng các nhánh để giữ các sửa lỗi và tính năng hoạt động tách biệt với nhánh chính (sản xuất). Khi một sự thay đổi đã sẵn sàng, họ hợp nhất nhánh của họ thành chính.
Tạo một nhánh mới
- Chuyển đến kho lưu trữ "hello-world" của bạn.
- Nhấp vào thả xuống ở đầu danh sách tập tin có nhánh "master".
- Nhập tên nhánh "readme-edits" vào hộp văn bản chi nhánh mới.
- Chọn hộp Tạo nhánh (Create branch) màu xanh hoặc nhấn phím Enter.
Bây giờ bạn có hai nhánh "master" và "readme-edits". Chúng trông giống hệt nhau, nhưng không lâu đâu! Tiếp theo, chúng ta sẽ thêm các thay đổi của vào nhánh mới.
Bước 3: Thực hiện và cam kết
Bây giờ, bạn ở chế độ xem mã cho nhánh "readme-edits", đây là bản sao của nhánh "master". Hãy để một số chỉnh sửa.
Trên GitHub, các thay đổi đã lưu được gọi là các xác nhận (commit). Mỗi xác nhận có một thông điệp mô tả giải thích tại sao một thay đổi cụ thể được thực hiện. Thông điệp xác nhận để nắm bắt lịch sử thay đổi của bạn, để những người đóng góp khác có thể hiểu bạn đã làm gì và tại sao.
Thực hiện và Cam kết thay đổi
- Nhấp vào tệp README.md.
- Nhấn vào biểu tượng bút chì ở góc trên bên phải của chế độ xem tệp để chỉnh sửa.
- Trong trình chỉnh sửa, viết một chút về bản thân bạn.
- Viết một thông điệp cam kết mô tả những thay đổi của bạn.
- Nhấp vào nút Cam kết thay đổi (Commit changes).
Những thay đổi này sẽ được thực hiện chỉ với tệp README trên nhánh "readme-edits" của bạn, vì vậy bây giờ nhánh này chứa nội dung mà khác với nhánh chính (master).
Bước 4: Mở yêu cầu kéo (Pull Request)
Việc chỉnh sửa đã xong! Bây giờ bạn có các thay đổi trong một nhánh ngoài chính, bạn có thể mở một yêu cầu kéo.
Yêu cầu kéo là trái tim của sự hợp tác trên GitHub. Khi bạn mở một yêu cầu kéo, bạn sẽ đề xuất các thay đổi của mình và yêu cầu ai đó xem xét và lấy đóng góp của bạn và hợp nhất chúng vào chi nhánh của họ. Yêu cầu kéo hiển thị khác biệt hoặc khác biệt của nội dung từ cả hai nhánh. Các thay đổi, bổ sung và phép trừ được hiển thị bằng màu xanh lá cây và đỏ.
Ngay khi bạn thực hiện một cam kết, bạn có thể mở một yêu cầu kéo và bắt đầu một cuộc thảo luận, ngay cả trước khi mã được kết thúc.
Bằng cách sử dụng hệ thống GitHub @mention trong thông báo yêu cầu kéo của bạn, bạn có thể yêu cầu phản hồi từ những người hoặc nhóm cụ thể, cho dù họ có xuống sảnh hay cách 10 múi giờ hay không.
Bạn thậm chí có thể mở các yêu cầu kéo trong kho lưu trữ của riêng bạn và tự hợp nhất chúng. Đó là một cách tuyệt vời để tìm hiểu luồng GitHub trước khi thực hiện các dự án lớn hơn.
Mở Yêu cầu Kéo để thay đổi đối với README
- Nhấp vào tab Yêu cầu kéo, sau đó từ trang Yêu cầu kéo, nhấp vào nút Yêu cầu kéo mới (New pull request) màu xanh lục.
- Trong hộp So sánh ví dụ, chọn nhánh bạn đã thực hiện, đọc các chỉnh sửa, để so sánh với chính (bản gốc).
- Xem xét các thay đổi của bạn các khác biệt trên trang So sánh, đảm bảo rằng chúng là những gì bạn muốn gửi.
- Khi bạn hài lòng rằng đây là những thay đổi bạn muốn gửi, hãy nhấp vào nút Tạo yêu cầu kéo màu xanh lá cây lớn.
- Đưa ra yêu cầu kéo của bạn một tiêu đề và viết một mô tả ngắn gọn về những bạn thay đổi.
- Khi bạn thực hiện xong thông điệp của mình, hãy nhấp vào Tạo yêu cầu kéo (Create pull request)!
Mẹo: Bạn có thể sử dụng biểu tượng cảm xúc và kéo và thả hình ảnh và gifs vào nhận xét và Yêu cầu kéo.
Bước 5. Hợp nhất yêu cầu kéo của bạn
Trong bước cuối cùng này, đã đến lúc kết hợp các thay đổi của bạn lại với nhau - hợp nhất nhánh readme-edits của bạn vào nhánh chính.
- Nhấp vào nút yêu cầu kéo hợp nhất (Merge pull request) màu xanh lá cây để hợp nhất các thay đổi thành chính.
- Nhấp vào Xác nhận hợp nhất (Confirm merge).
- Chuyển lên trước và xóa nhánh, vì những thay đổi của nó đã được kết hợp, với nút Xóa nhánh (Delete branch) trong hộp màu tím.
Chúc mừng
Bằng cách hoàn thành hướng dẫn này, bạn đã học cách tạo một dự án và thực hiện một yêu cầu kéo trên GitHub!
Đây là những gì bạn đã hoàn thành trong hướng dẫn này:
- Tạo một kho lưu trữ nguồn mở
- Bắt đầu và quản lý một nhánh mới
- Đã thay đổi một tệp và cam kết những thay đổi đó với GitHub
- Đã mở và hợp nhất một Yêu cầu kéo
Hãy xem hồ sơ GitHub của bạn và bạn sẽ thấy các hình vuông đóng góp mới của bạn!
Để tìm hiểu thêm về sức mạnh của Yêu cầu kéo, chúng tôi khuyên bạn nên đọc Hướng dẫn về GitHub. Bạn cũng có thể truy cập GitHub Explore và tham gia vào một dự án nguồn mở.
Mẹo: Xem các Hướng dẫn khác trên Kênh YouTube và làm theo yêu cầu của chúng tôi để biết thêm về cách bắt đầu với GitHub.