Hướng dẫn python learning path github - lộ trình học python github

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Hãy xem hồ sơ GitHub của bạn và bạn sẽ thấy công việc của bạn được phản ánh trên biểu đồ đóng góp của bạn.

Để biết thêm thông tin về sức mạnh của các nhánh và yêu cầu kéo, hãy xem "Dòng chảy GitHub." Để biết thêm thông tin về việc bắt đầu với GitHub, hãy xem các hướng dẫn khác trong việc bắt đầu khởi động nhanh.

Giới thiệu

GitHub là một nền tảng lưu trữ mã để kiểm soát và hợp tác phiên bản. Nó cho phép bạn và những người khác làm việc cùng nhau trong 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 bạn như kho lưu trữ, chi nhánh, cam kết và yêu cầu kéo. Bạn sẽ tạo kho lưu trữ Hello World của riêng bạn và tìm hiểu quy trình công việc yêu cầu kéo của GitHub, một cách phổ biến để tạo và xem xét mã.
• Trong hướng dẫn khởi động nhanh này, bạn sẽ:
• Tạo và sử dụng kho lưu trữ
• Bắt đầu và quản lý một chi nhánh mới

Thực hiện các thay đổi đối với một tệp và đẩy chúng vào github dưới dạng cam kết

Tạo một 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ứ điều gì mà dự án của bạn cần. Thông thường, kho lưu trữ bao gồm một tệp readme, một tệp có thông tin về dự án của bạn. Các tệp readme được viết bằng ngôn ngữ đánh dấu văn bản đơn giản. Bạn có thể sử dụng bảng cheat này để bắt đầu với cú pháp Markdown. GitHub cho phép bạn thêm tệp readme cùng một lúc bạn tạo kho lưu trữ mới của mình. GitHub cũng cung cấp các tùy chọn phổ biến khác như tệp giấy phép, nhưng bạn không phải chọn bất kỳ tùy chọn nào bây giờ.

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 về mọi thứ với người khác.

1. Ở góc trên bên phải của bất kỳ trang nào, sử dụng menu thả xuống và chọn kho lưu trữ mới.New repository.

2. Trong hộp tên kho lưu trữ, nhập hello-world.Repository name box, enter hello-world.

3. Trong hộp mô tả, viết một mô tả ngắn.Description box, write a short description.

4. Chọn Thêm tệp README.Add a README file.

5. Chọn xem kho lưu trữ của bạn sẽ công khai hay riêng tư.Public or Private.

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

Tạo ra một chi nhánh

Phân nhánh cho phép bạn có các phiên bản khác nhau của 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 main được coi là nhánh dứt khoát. Bạn có thể tạo các nhánh bổ sung từ main trong kho của bạn. Bạn có thể sử dụng các chi nhánh để có các phiên bản khác nhau của một dự án cùng một lúc. Điều này rất hữu ích khi bạn muốn thêm các tính năng mới vào dự án mà không thay đổi nguồn mã chính. Công việc được thực hiện trên các nhánh khác nhau sẽ không hiển thị trên nhánh chính cho đến khi bạn hợp nhất nó, mà chúng tôi sẽ đề cập sau này trong hướng dẫn này. Bạn có thể 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 vào main.

Khi bạn tạo một nhánh ra khỏi nhánh main, bạn đang tạo một bản sao hoặc ảnh chụp nhanh của main như tại thời điểm đó. Nếu người khác thực hiện các thay đổi đối với chi nhánh main trong khi bạn đang làm việc trên chi nhánh của mình, bạn có thể thực hiện các bản cập nhật đó.

Sơ đồ này cho thấy:

• Chi nhánh main
• Một chi nhánh mới được gọi là feature
• Hành trình mà feature thực hiện trước khi nó được hợp nhất vào main

Bạn đã bao giờ lưu các phiên bản khác nhau của một tệp? Cái gì đó như:

• hello-world2
• hello-world3
• hello-world4

Các chi 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 chi nhánh để giữ cho các sửa lỗi và tính năng công việc tách biệt với chi nhánh main (sản xuất) của chúng tôi. Khi một sự thay đổi đã sẵn sàng, họ hợp nhất nhánh của họ thành main.

Tạo ra một nhánh

1. Nhấp vào tab Mã của kho lưu trữ hello-world của bạn.Code tab of your hello-world repository.
2. Nhấp vào việc thả xuống ở đầu danh sách tệp nói chính.main.
   
3. Nhập tên nhánh, hello-world8, vào hộp văn bản.
4. Nhấp vào Tạo nhánh: ReadMe-Edits từ chính.Create branch: readme-edits from main.

Bây giờ bạn có hai nhánh, main và hello-world8. Ngay bây giờ, họ trông giống hệt nhau. Tiếp theo, bạn sẽ thêm các thay đổi cho chi nhánh mới.

Thực hiện và cam kết thay đổi

Khi bạn tạo một nhánh mới ở bước trước, GitHub đã đưa bạn đến trang mã cho chi nhánh hello-world8 mới của bạn, đây là bản sao của main.

Bạn có thể thực hiện và lưu các thay đổi cho các tệp trong kho lưu trữ của bạn. Trên GitHub, các thay đổi đã lưu được gọi là cam kết. Mỗi cam kết có một thông điệp cam kết liên quan, đó là một mô tả giải thích lý do tại sao một thay đổi cụ thể được thực hiện. Cam kết tin nhắn nắm bắt lịch sử của những thay đổi của bạn để những người đóng góp khác có thể hiểu những gì bạn đã làm và tại sao.

1. Trong nhánh hello-world8 bạn đã tạo, nhấp vào tệp readme.md.

2. Bấm để chỉnh sửa tệp.

3. Trong biên tập viên, viết một chút về bản thân bạn. Hãy thử sử dụng các yếu tố đánh dấu khác nhau.

4. Trong hộp thay đổi cam kết, hãy viết một thông báo cam kết mô tả các thay đổi của bạn.Commit changes box, write a commit message that describes your changes.

5. Nhấp vào cam kết thay đổi.Commit changes.

Những thay đổi này sẽ chỉ được thực hiện cho tệp readme trên chi nhánh hello-world8 của bạn, vì vậy bây giờ nhánh này chứa nội dung khác với main.

Mở một yêu cầu kéo

Bây giờ bạn có những thay đổi trong một nhánh ngoài main, bạn có thể mở 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 đang đề 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ọ. Các yêu cầu kéo hiển thị sự khác biệt, hoặc sự khác biệt của nội dung từ cả hai nhánh. Các thay đổi, bổ sung và trừ được thể hiện trong các màu khác nhau.

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ã kết thúc.

Bằng cách sử dụng tính năng main7 của GitHub 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ọ xuống hội trường hoặc cách 10 múi giờ.

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 để học dòng github trước khi làm việc trên các dự án lớn hơn.

1. Nhấp vào tab Yêu cầu kéo của kho hello-world của bạn.Pull requests tab of your hello-world repository.

2. Nhấp vào Yêu cầu kéo mớiNew pull request

3. Trong hộp so sánh ví dụ, chọn nhánh bạn đã thực hiện, hello-world8, để so sánh với main (bản gốc).Example Comparisons box, select the branch you made, hello-world8, to compare with main (the original).

4. Nhìn qua những thay đổi của bạn trong các khác biệt trên trang so sánh, đảm bảo chúng là những gì bạn muốn gửi.

5. Nhấp vào Tạo yêu cầu kéo.Create pull request.

6. Đư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ề các thay đổi của bạn. Bạn có thể bao gồm biểu tượng cảm xúc và kéo và thả hình ảnh và GIF.

7. Tùy chọn, ở bên phải tiêu đề và mô tả của bạn, nhấp vào tiếp theo cho người đánh giá. Người được chuyển nhượng, nhãn, dự án hoặc cột mốc để thêm bất kỳ tùy chọn nào trong yêu cầu kéo của bạn. Bạn không cần thêm bất kỳ điều gì, nhưng các tùy chọn này cung cấp các cách khác nhau để hợp tác bằng cách sử dụng các yêu cầu kéo. Để biết thêm thông tin, xem "Giới thiệu về yêu cầu kéo."Reviewers. Assignees, Labels, Projects, or Milestone to add any of these options to your pull request. You do not need to add any yet, but these options offer different ways to collaborate using pull requests. For more information, see "About pull requests."

8. Nhấp vào Tạo yêu cầu kéo.Create pull request.

Đư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ề các thay đổi của bạn. Bạn có thể bao gồm biểu tượng cảm xúc và kéo và thả hình ảnh và GIF.

Tùy chọn, ở bên phải tiêu đề và mô tả của bạn, nhấp vào tiếp theo cho người đánh giá. Người được chuyển nhượng, nhãn, dự án hoặc cột mốc để thêm bất kỳ tùy chọn nào trong yêu cầu kéo của bạn. Bạn không cần thêm bất kỳ điều gì, nhưng các tùy chọn này cung cấp các cách khác nhau để hợp tác bằng cách sử dụng các yêu cầu kéo. Để biết thêm thông tin, xem "Giới thiệu về yêu cầu kéo."

Cộng tác viên của bạn bây giờ có thể xem xét các chỉnh sửa của bạn và đưa ra đề xuất.

Hợp nhất yêu cầu kéo của bạn

Trong bước cuối cùng này, bạn sẽ hợp nhất chi nhánh hello-world8 của mình vào nhánh main. Sau khi bạn hợp nhất yêu cầu kéo của mình, các thay đổi trên nhánh hello-world8 của bạn sẽ được kết hợp vào main.

1. Đôi khi, một yêu cầu kéo có thể giới thiệu các thay đổi đối với mã xung đột với mã hiện có trên main. Nếu có bất kỳ xung đột nào, GitHub sẽ cảnh báo bạn về mã mâu thuẫn và ngăn chặn sự hợp nhất cho đến khi các xung đột được giải quyết. Bạn có thể thực hiện một cam kết giải quyết các xung đột hoặc sử dụng nhận xét trong yêu cầu kéo để thảo luận về các cuộc xung đột với các thành viên trong nhóm của bạn.Merge pull request to merge the changes into main.
2. Trong cuộc đi bộ này, bạn không nên có bất kỳ xung đột nào, vì vậy bạn đã sẵn sàng hợp nhất chi nhánh của bạn vào nhánh chính.Confirm merge. You will receive a message that the request was successfully merged and the request was closed.
3. Nhấp vào Hợp nhất yêu cầu kéo để hợp nhất các thay đổi thành main.Delete branch. Now that your pull request is merged and your changes are on main, you can safely delete the hello-world8 branch. If you want to make more changes to your project, you can always create a new branch and repeat this process.

Nhấp vào xác nhận hợp nhất. Bạn sẽ nhận được một thông báo rằng yêu cầu đã được hợp nhất thành công và yêu cầu đã được đóng lại.

Nhấp vào Xóa chi nhánh. Bây giờ yêu cầu kéo của bạn đã được hợp nhất và các thay đổi của bạn là trên main, bạn có thể xóa chi nhánh hello-world8 một cách an toàn. Nếu bạn muốn thực hiện nhiều thay đổi hơn cho dự án của mình, bạn luôn có thể tạo một chi nhánh mới và lặp lại quy trình này.

Bước tiếp theo

• 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 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 chi nhánh mới

Đã thay đổi một tệp và cam kết những thay đổi đó thành github

Đã mở và hợp nhất một yêu cầu kéo