Tag plugin yang stabil di file readme

10

Jika saya mendorong versi baru (v0.2) dari plugin saya (v0.1) pada repo, apa yang saya lakukan dengan tag stabil pada file readme? Ubah ke v0.2?

Apa yang harus datang ke sini? Mohon klarifikasi :)

Asfame
sumber

Jawaban:

10

Iya. Kamu butuh:

  • Ubah tag stabil menjadi 0,2
  • Komit (atau salin / cabang) versi baru ke /tags/0.2
  • Jangan lupa untuk memperbarui versi ke 0,2 di header plugin
Jarang
sumber
Saya pikir itu disarankan bahwa langkah terakhir adalah memperbarui trunk/readme.txtuntuk mencerminkan tag stabil baru. Kalau tidak, Anda bisa mendapatkan kemungkinan kondisi balapan di mana server wp.org berpikir ada tag baru untuk dibundel, tetapi belum benar-benar ada, karena Anda belum melakukannya svn cp.
Dougal Campbell
@Dougal Campbell Saya pikir interval penyegaran repositori adalah 15 menit sehingga pesanan tidak terlalu penting dan saya tidak bermaksud jawaban saya untuk menegakkan pesanan ... Saya akan mengedit untuk mengubah ke daftar unordered.
Paling lambat
Ada apa dengan pesanannya? Tidakkah saya harus mengkomit semuanya untuk trunk dan kemudian menyalinnya ke sub-direktori di Tag?
Ashfame
@Ashfame ya, itu akan berhasil. Saya pikir apa yang ingin dijelaskan oleh Dougal adalah hal itu bisa salah jika refresh repositori terjadi setelah Anda mengubah trunk tetapi sebelum Anda membuat tag target. Secara pribadi saya pikir itu tidak mungkin.
Paling lambat
@ Pertama Bahkan jika kesalahan itu terjadi, toh itu akan diselesaikan dalam penyegaran berikutnya, kan?
Ashfame
3

Saya akan merekomendasikan urutan operasi ini:

  1. Perbarui .phpfile plugin Anda di bagasi untuk mencerminkan versi baru, dan komit
  2. svn cp trunk tags/0.2
  3. Edit tags/0.2/readme.txtdan trunk/readme.txtuntuk mencerminkan tag stabil baru
  4. svn commit -m "Tagging ver 0.2"
Dougal Campbell
sumber
1

Yang Stable tagmenunjukkan versi saat ini di repositori svn yang Anda ingin pengguna gunakan / perbarui. Dalam kebanyakan kasus cukup mengaturnya ke 'trunk', seperti yang dijelaskan dalam artikel ini di Smashing Magazine, Cara Meningkatkan Readme.txt Plugin WordPress Anda

Tag yang stabil . Tag stabil memberi tahu WordPress versi plugin mana yang akan muncul di direktori. Ini harus dalam format numerik, yang jauh lebih mudah untuk dihadapi oleh WordPress. Targetkan angka seperti 1,5, 0,5 atau versi apa pun yang Anda pakai. Jika versi stabil Anda berada di trunk di Subversion, maka Anda dapat menentukan "trunk," tetapi itu adalah satu-satunya waktu Anda harus menggunakan kata-kata dan bukan angka.

Selanjutnya, dari dokumentasi WordPress yang sebenarnya ,

Direktori Plugin WordPress.org bekerja berdasarkan informasi yang ditemukan di bidang Stable Tag di readme. Ketika WordPress.org mem-parsing readme.txt, hal pertama yang dilakukan adalah melihat readme.txt di direktori / trunk, di mana ia membaca baris "Stable Tag". Jika Tag Stable tidak ada, atau disetel ke "trunk", maka versi plugin di / trunk dianggap sebagai versi stabil. Jika Tag Stabil diatur ke hal lain, maka Tag itu akan masuk dan mencari di / tag / untuk versi yang direferensikan. Jadi Tag Stable "1.2.3" akan membuatnya mencari / tag/1.2.3/.

Jika Anda menggunakan svn sebagai repositori pengembangan Anda, maka masuk akal untuk menggunakan nomor versi aktual di tag Stable. misalnya 1.5.2 saat Anda memiliki v2.0.0 di repositori tempat Anda sedang bekerja tetapi masih dalam pengembangan.

Alasan lain untuk menggunakan nomor versi

Jika plugin Anda memiliki terjemahan dan memanfaatkan string yang diterjemahkan dengan fungsi yang dilokalkan , maka Anda mungkin ingin mempertimbangkan untuk menggunakan versi stabil untuk tag, karena file bahasa dimuat untuk versi itu. Jadi, jika Anda memperbarui plugin dan menambahkan banyak string baru yang dilokalkan, maka masuk akal untuk menetapkan tag stabil Anda ke versi sebelumnya untuk memberi waktu bagi penerjemah untuk menyelesaikan terjemahan untuk versi baru. Setelah terjemahan siap, Anda dapat mengganti tag stabil.

Aurovrata
sumber