Gửi một yêu cầu kéo

Trang này nói về việc gửi một yêu cầu kéo chứa các tệp tài liệu Markdown tới tensorflow /hub.tensorflow.google.cn . GitHub Repo. Để biết thêm thông tin về cách ghi tệp Markdown ngay từ đầu, vui lòng xem hướng dẫn tài liệu viết .

Kiểm tra GitHub Actions

Repo tensorflow /hub.tensorflow.google.cn sử dụng Tác vụ GitHub để xác thực định dạng của tệp trong PR. Dòng công việc được sử dụng để xác thực các PR được định nghĩa trong .github / workflows / Contribue-validator.yml . Bạn có thể chạy tập lệnh trình xác thực trên chi nhánh của riêng mình bên ngoài quy trình làm việc, nhưng bạn sẽ cần đảm bảo rằng bạn đã cài đặt tất cả các gói phụ thuộc gói pip chính xác.

Những người đóng góp lần đầu tiên chỉ có thể chạy kiểm tra tự động với sự chấp thuận của người bảo trì kho lưu trữ, theo chính sách của GitHub . Các nhà xuất bản được khuyến khích gửi một PR nhỏ sửa lỗi chính tả, nếu không sẽ cải thiện tài liệu mô hình hoặc gửi một PR chỉ chứa trang nhà xuất bản của họ làm bài PR đầu tiên của họ để có thể chạy kiểm tra tự động đối với các bài PR tiếp theo.

Gửi bài PR

Các tệp Markdown hoàn chỉnh có thể được kéo vào nhánh chính của tensorflow /hub.tensorflow.google.cn bằng một trong các phương pháp sau.

Git CLI gửi

Giả sử đường dẫn tệp đánh dấu được xác định là nội dung assets/docs/publisher/model/1.md , bạn có thể làm theo các bước Git [Hub] tiêu chuẩn để tạo Yêu cầu kéo mới với tệp mới được thêm vào.

Điều này bắt đầu với việc phân nhánh kho lưu trữ TensorFlow Hub GitHub, sau đó tạo Yêu cầu kéo từ nhánh này vào nhánh chính của TensorFlow Hub.

Sau đây là các lệnh git CLI điển hình cần thiết để thêm tệp mới vào nhánh chính của kho lưu trữ được phân nhánh.

git clone https://github.com/[github_username]/hub.tensorflow.google.cn.git
cd hub.tensorflow.google.cn
mkdir -p assets/docs/publisher/model
cp my_markdown_file.md ./assets/docs/publisher/model/1.md
git add *
git commit -m "Added model file."
git push origin master

Gửi GUI GitHub

Một cách đơn giản hơn để gửi là thông qua giao diện người dùng đồ họa GitHub. GitHub cho phép tạo PR cho tệp mới hoặc chỉnh sửa tệp trực tiếp thông qua GUI.

  1. Trên trang TensorFlow Hub GitHub , nhấn nút Create new file .
  2. Đặt đúng đường dẫn tệp: assets/docs/publisher/model/1.md
  3. Sao chép-dán phần đánh dấu hiện có.
  4. Ở dưới cùng, hãy chọn "Tạo một nhánh mới cho cam kết này và bắt đầu một yêu cầu kéo".