Một dự án nguồn mở lành mạnh cần một nơi để xuất bản mã của nó và công cụ quản lý dự án để các nhà phát triển khác có thể cộng tác với bạn. Điều này cho phép người dùng của bạn hiểu rõ hơn về mã của bạn, cập nhật những phát triển mới, báo cáo lỗi và đóng góp mã
Trang web phát triển này phải bao gồm chính lịch sử mã nguồn, trình theo dõi lỗi, hàng đợi gửi bản vá [còn gọi là “Yêu cầu kéo”] và có thể là tài liệu hướng đến nhà phát triển bổ sung
Có một số trang web lưu trữ dự án mã nguồn mở miễn phí [hay còn gọi là “lò rèn”]. Chúng bao gồm GitHub, SourceForge, Bitbucket và GitLab. GitHub hiện là tốt nhất. Sử dụng GitHub
Tạo Repo dự án trên GitHub
Để xuất bản dự án Python của bạn trên GitHub
- Tạo tài khoản GitHub nếu bạn chưa có
- Tạo một repo mới cho dự án của bạn
- Nhấp vào menu “+” bên cạnh hình đại diện của bạn ở phía trên bên phải của trang và chọn “Kho lưu trữ mới”
- Đặt tên cho nó theo dự án của bạn và cung cấp cho nó một mô tả thân thiện với SEO
- Nếu bạn không có repo dự án hiện có, hãy chọn cài đặt để thêm README,. gitignore và giấy phép. Sử dụng Python. tùy chọn gitignore
- Trên trang repo mới tạo, nhấp vào “Quản lý chủ đề” và thêm các thẻ “python” và “python3” và/hoặc “python2” nếu thích hợp
- Bao gồm một liên kết đến repo GitHub mới của bạn trong tệp README của dự án để những người vừa có bản phân phối dự án biết tìm nó ở đâu
Nếu đây là một repo hoàn toàn mới, hãy sao chép nó vào máy cục bộ của bạn và bắt đầu làm việc
$ git clone //github.com//
Hoặc, nếu bạn đã có repo Git của dự án, hãy thêm repo GitHub mới của bạn làm điều khiển từ xa
$ cd $ git remote add origin //github.com// $ git push --tags
Khi dự án của bạn phát triển
Để biết thêm thông tin về cách quản lý dự án phần mềm nguồn mở, hãy xem cuốn sách Sản xuất phần mềm nguồn mở
Bạn có thể sao chép một kho lưu trữ mà bạn muốn đóng góp trực tiếp từ PyCharm và tạo một dự án mới dựa trên đó
Từ menu chính, chọn Git. Bản sao . Nếu menu Git không khả dụng, hãy chọn VCS. Nhận từ Kiểm soát phiên bản .
Trong hộp thoại Nhận từ Kiểm soát phiên bản , hãy chọn GitHub on the left.
Đăng nhập vào GitHub bằng cách thực hiện một trong các thao tác sau
Nếu bạn có mã thông báo, hãy nhấp vào Sử dụng mã thông báo , sau đó dán mã thông báo vào Mã thông báo< . field, and click Log In.
Nếu không, hãy nhấp vào Đăng nhập qua GitHub .
Nhập thông tin đăng nhập GitHub của bạn vào cửa sổ trình duyệt mở ra. Nếu bạn đã bật xác thực hai yếu tố, bạn sẽ được yêu cầu nhập mã sẽ được gửi cho bạn qua SMS hoặc qua ứng dụng di động
Chọn một kho lưu trữ từ danh sách tất cả các dự án GitHub được liên kết với tài khoản của bạn và tổ chức mà tài khoản của bạn thuộc về
Trong trường Thư mục , hãy nhập đường dẫn đến thư mục nơi kho lưu trữ Git cục bộ của bạn sẽ được tạo.
Nhấp vào Sao chép .
Nếu bạn muốn tạo dự án dựa trên những nguồn này, hãy nhấp vào Có trong hộp thoại xác nhận. PyCharm sẽ tự động đặt ánh xạ gốc Git vào thư mục gốc của dự án.
Chia sẻ dự án trên GitHub
Bạn có thể thêm kho lưu trữ GitHub từ xa cho dự án mà bạn đang phát triển cục bộ để những người khác có thể xem hoặc đóng góp cho dự án đó
Mở dự án bạn muốn chia sẻ
Từ menu chính, chọn Git. GitHub. Chia sẻ Dự án trên GitHub .
Nếu bạn đã có trong PyCharm, kết nối sẽ được thiết lập bằng các thông tin đăng nhập này
Nếu bạn chưa đăng ký tài khoản của mình trong PyCharm, hộp thoại Đăng nhập vào GitHub sẽ mở ra. Chỉ định mã thông báo truy cập của bạn hoặc yêu cầu mã thông báo mới bằng thông tin đăng nhập và mật khẩu của bạn.
Khi kết nối với GitHub đã được thiết lập, hộp thoại Chia sẻ dự án trên GitHub sẽ mở ra. Chỉ định tên kho lưu trữ mới, tên của điều khiển từ xa và nhập mô tả về dự án của bạn.
Bạn có thể chọn tùy chọn Riêng tư nếu bạn không muốn cho phép người dùng GitHub khác truy cập công khai vào kho lưu trữ của mình.
Nhấp vào Chia sẻ để bắt đầu một kho lưu trữ mới và tải nguồn dự án lên đó.
Chuyển đến phiên bản GitHub của tệp
Bạn có thể chuyển từ PyCharm sang phiên bản GitHub của tệp. PyCharm phát hiện nhánh nào hiện đang hoạt động cũng như bản sửa đổi mới nhất của tệp và mở bản sao GitHub của tệp đã chọn trong cam kết tương ứng trong trình duyệt web của bạn
làm một điều trong số sau đây
Chọn Git. GitHub. Mở trên GitHub từ menu chính.
Chọn tệp trong trình chỉnh sửa hoặc trong chế độ xem Dự án và chọn Mở trong. GitHub từ menu ngữ cảnh.
Chọn tệp trong dạng xem Dự án, nhấn Ctrl+Shift+A, rồi nhập
Open on Github
Nếu bạn đã đăng nhập vào GitHub, phiên bản từ xa của tệp sẽ mở trong trình duyệt
Nếu không thì
Nhập thông tin đăng nhập GitHub của bạn vào cửa sổ trình duyệt mở ra. Nếu bạn đã bật xác thực hai yếu tố, bạn sẽ được yêu cầu nhập mã sẽ được gửi cho bạn qua SMS hoặc qua ứng dụng di động
Nếu bạn đang mở phiên bản tệp GitHub từ trình chỉnh sửa, tệp cũng sẽ tự động được cuộn đến dòng hiện tại
Nếu tệp trỏ đến nhiều điều khiển từ xa, bạn sẽ được nhắc chọn kho lưu trữ thích hợp