Стабильный тег плагина в файле readme

10

Если я помещаю новую версию (v0.2) моего плагина (v0.1) в репозиторий, что мне делать со стабильным тегом в файле readme? Измените это на v0.2?

Что должно прийти сюда? Пояснения пожалуйста :)

svn plugin-repository readme Ashfame
источник

Ответы:

10

Да. Тебе следует:

  • Изменить стабильный тег на 0,2
  • Зафиксировать (или скопировать / ветвить) новую версию в /tags/0.2
  • Не забудьте обновить версию до 0.2 в шапке плагина
Rarst
источник
Я думаю, что последний шаг рекомендуется обновить, trunk/readme.txtчтобы отразить новый стабильный тег. В противном случае вы можете получить возможное состояние гонки, когда серверы wp.org считают, что есть новый тег для объединения, но на самом деле он еще не существует, потому что вы еще этого не сделали svn cp.
Дугал Кэмпбелл
@ Дугал Кэмпбелл: Я думаю, что интервал обновления репозитория составляет 15 минут, поэтому порядок не особенно важен, и я не хотел, чтобы мой ответ приводил в исполнение какой-либо порядок ... Я отредактирую, чтобы перейти в неупорядоченный список.
Первое
Что случилось с заказом? Разве я не должен просто передать все в транк и затем скопировать в подкаталог в тегах?
Ashfame
@ Ashfame да, это будет работать. Я думаю, что Дугал хотел описать, это то, что он может дать сбой, если обновление хранилища произойдет после того, как вы измените ствол, но перед тем, как создать целевой тег. Лично я думаю, что это вряд ли.
Первое
@Rarst Даже если этот сбой произойдет, он все равно будет решен в следующем обновлении, верно?
Ashfame
3

Я бы порекомендовал этот порядок операций:

  1. Обновите .phpфайл вашего плагина в транке, чтобы отразить новую версию, и подтвердите
  2. svn cp trunk tags/0.2
  3. Изменить tags/0.2/readme.txtи trunk/readme.txtотразить новый стабильный тег
  4. svn commit -m "Tagging ver 0.2"
Дугал Кэмпбелл
источник
1

Stable tagУказывает на текущую версию в хранилище SVN , который вы хотите пользователям использовать / обновить. В большинстве случаев просто установите для него значение «trunk», как объясняется в этой статье в журнале Smashing Magazine « Как улучшить Readme.txt вашего плагина WordPress».

Стабильный тег . Стабильный тег сообщает WordPress, какая версия плагина должна появиться в каталоге. Это должно быть в числовом формате, с которым WordPress намного легче иметь дело. Стремитесь к числам как 1.5, 0.5 или любой другой версии, в которой вы находитесь. Если ваша стабильная версия находится в транке в Subversion, вы можете указать «транк», но это единственный раз, когда вы должны использовать слова вместо цифр.

Кроме того, из фактической документации WordPress ,

Каталог плагинов WordPress.org работает на основе информации, найденной в поле «Стабильный тег» в файле readme. Когда WordPress.org анализирует readme.txt, самое первое, что он делает, это просматривает readme.txt в каталоге / trunk, где он читает строку «Стабильный тег». Если стабильная метка отсутствует или установлена ​​в «trunk», то версия плагина в / trunk считается стабильной версией. Если для стабильного тега установлено что-либо еще, он пойдет и будет искать в / tags / ссылочную версию. Таким образом, стабильный тег «1.2.3» заставит его искать /tags/1.2.3/.

Если вы используете svn в качестве репозитория для разработки, то имеет смысл использовать фактический номер версии в теге Stable. например, 1.5.2, в то время как у вас есть v2.0.0 в репозитории, над которым вы сейчас работаете, но он все еще находится в стадии разработки.

Другая причина использовать номер версии

Если ваш плагин имеет переводы и использует переведенные строки с локализованными функциями , то вы можете рассмотреть возможность использования стабильной версии для тега, так как языковые файлы загружаются для этой версии. Поэтому, если вы обновите свой плагин и добавите много новых локализованных строк, то имеет смысл установить стабильный тег на предыдущую версию, чтобы дать переводчикам время для завершения перевода новой версии. Как только переводы будут готовы, вы можете переключить стабильный тег.

Aurovrata
источник