Thẻ ổn định của plugin trong tệp readme


10

Nếu tôi đang đẩy một phiên bản mới (v0.2) của plugin (v0.1) trên repo, tôi sẽ làm gì với thẻ ổn định trong tệp readme? Thay đổi nó thành v0.2?

Nên đến đây làm gì? Xin làm rõ :)

Câu trả lời:


10

Đúng. Bạn cần phải:

  • Thay đổi thẻ ổn định thành 0,2
  • Cam kết (hoặc sao chép / chi nhánh) phiên bản mới vào /tags/0.2
  • Đừng quên cập nhật phiên bản lên 0.2 trong tiêu đề của plugin

Tôi nghĩ rằng nên thực hiện bước cuối cùng là cập nhật trunk/readme.txtđể phản ánh thẻ ổn định mới. Mặt khác, bạn có thể có một điều kiện cuộc đua có thể xảy ra khi các máy chủ wp.org nghĩ rằng có một thẻ mới để đóng gói, nhưng nó chưa thực sự tồn tại, bởi vì bạn chưa thực hiện svn cpđược.
Dougal Campbell

@Dougal Campbell Tôi nghĩ rằng thời gian làm mới của kho lưu trữ là 15 phút nên thứ tự không đặc biệt quan trọng và tôi không có nghĩa là câu trả lời của tôi để thực thi bất kỳ đơn hàng nào ... Tôi sẽ chỉnh sửa để thay đổi thành danh sách không có thứ tự.
Rarst

Có chuyện gì với thứ tự? Tôi không nên cam kết mọi thứ vào thân cây và sau đó sao chép vào một thư mục con trong Thẻ?
Ashfame

@Ashfame vâng, điều đó sẽ làm việc. Tôi nghĩ những gì Dougal muốn mô tả là nó có thể trục trặc nếu việc làm mới kho lưu trữ xảy ra sau khi bạn thay đổi thân cây nhưng trước khi bạn tạo thẻ mục tiêu. Cá nhân tôi nghĩ rằng điều đó là không thể.
Rarst

@Rarst Ngay cả khi trục trặc đó xảy ra, nó sẽ được giải quyết trong lần làm mới tiếp theo, phải không?
Ashfame

3

Tôi muốn giới thiệu thứ tự hoạt động này:

  1. Cập nhật .phptệp của plugin trong thân cây để phản ánh phiên bản mới và cam kết
  2. svn cp trunk tags/0.2
  3. Chỉnh sửa tags/0.2/readme.txttrunk/readme.txtphản ánh thẻ ổn định mới
  4. svn commit -m "Tagging ver 0.2"

1

Chỉ Stable tagra phiên bản hiện tại trong kho svn mà bạn muốn người dùng sử dụng / cập nhật. Trong hầu hết các trường hợp, chỉ cần đặt nó thành 'thân cây', như được giải thích trong bài viết này trên Tạp chí Smashing, Cách cải thiện Readme.txt của Plugin WordPress của bạn

Thẻ ổn định . Thẻ ổn định cho WordPress biết phiên bản plugin nào sẽ xuất hiện trong thư mục. Điều này nên ở định dạng số, dễ dàng hơn nhiều để xử lý WordPress. Nhắm đến các số như 1,5, 0,5 hoặc bất kỳ phiên bản nào bạn đang ở. Nếu phiên bản ổn định của bạn nằm trong trung kế trong Subversion, thì bạn có thể chỉ định thân cây,, nhưng đó là lần duy nhất bạn nên sử dụng từ thay vì số.

Hơn nữa, từ tài liệu WordPress thực tế ,

Thư mục Plugin của WordPress.org hoạt động dựa trên thông tin tìm thấy trong trường Thẻ ổn định trong readme. Khi WordPress.org phân tích cú pháp readme.txt, điều đầu tiên cần làm là xem readme.txt trong thư mục / trunk, nơi nó đọc dòng Stable Tag Stable. Nếu Thẻ ổn định bị thiếu hoặc được đặt thành Trunk trunk, thì phiên bản của plugin trong / trunk được coi là phiên bản ổn định. Nếu Thẻ ổn định được đặt thành bất kỳ thứ gì khác, thì nó sẽ đi và tìm trong / tags / cho phiên bản được tham chiếu. Vì vậy, Thẻ ổn định của phiên bản 1.2.3. Sẽ làm cho nó tìm kiếm /tags/1.2.3/.

Nếu bạn sử dụng svn làm kho lưu trữ phát triển thì việc sử dụng số phiên bản thực tế trong thẻ Ổn định là điều hợp lý. ví dụ 1.5.2 trong khi bạn có v2.0.0 trong kho lưu trữ mà bạn hiện đang làm việc nhưng nó vẫn đang được phát triển.

Lý do khác để sử dụng số phiên bản

Nếu plugin của bạn có bản dịch và sử dụng các chuỗi dịch với các hàm được bản địa hóa , thì bạn có thể muốn xem xét sử dụng phiên bản ổn định cho thẻ, vì các tệp ngôn ngữ được tải cho phiên bản đó. Vì vậy, nếu bạn cập nhật plugin của mình và thêm nhiều chuỗi nội địa hóa mới, thì nên đặt thẻ ổn định của bạn thành phiên bản trước để dành thời gian cho người dịch hoàn thành bản dịch cho phiên bản mới. Khi các bản dịch đã sẵn sàng, bạn có thể chuyển đổi thẻ ổn định.

Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.