Balise stable du plugin dans le fichier readme

Si je pousse une nouvelle version (v0.2) de mon plugin (v0.1) sur le repo, que dois-je faire avec la balise stable dans le fichier readme? Le changer en v0.2?

Qu'est-ce qui devrait venir ici? Précisions s'il vous plaît :)

svn plugin-repository readme Ashfame
la source

Réponses:

Oui. Tu dois:

Changer la balise stable à 0,2
Validez (ou copiez / branchez) une nouvelle version dans /tags/0.2
N'oubliez pas de mettre à jour la version à 0.2 dans l'en-tête du plugin

Rarst
la source

Je pense qu'il est recommandé que la dernière étape soit de mettre trunk/readme.txtà jour pour refléter la nouvelle balise stable. Sinon, vous pouvez obtenir une condition de concurrence possible où les serveurs wp.org pensent qu'il y a une nouvelle balise à regrouper, mais elle n'existe pas encore, car vous ne l'avez pas svn cpencore fait.

Dougal Campbell

@Dougal Campbell Je pense que l'intervalle de rafraîchissement du référentiel est de 15 minutes, donc l'ordre n'est pas particulièrement important et je ne voulais pas que ma réponse fasse appliquer un ordre ... Je modifierai pour passer à la liste non ordonnée.

Rarst

Qu'est-ce qui se passe avec la commande? Ne devrais-je pas tout simplement valider tout dans le tronc puis copier dans un sous-répertoire dans les balises?

Ashfame

@Ashfame oui, cela fonctionnera. Je pense que ce que Dougal voulait décrire, c'est que cela peut causer un problème si l'actualisation du référentiel se produit après avoir changé le tronc mais avant de créer la balise cible. Personnellement, je pense que c'est peu probable.

Rarst

@Rarst Même si ce problème se produit, il sera résolu dans le prochain rafraîchissement de toute façon, non?

Ashfame

Je recommanderais cet ordre d'opérations:

Mettez à jour le .phpfichier de votre plugin dans le tronc pour refléter la nouvelle version et validez
svn cp trunk tags/0.2
Modifier tags/0.2/readme.txtet trunk/readme.txtrefléter la nouvelle balise stable
svn commit -m "Tagging ver 0.2"

Dougal Campbell
la source

Le Stable tagindique la version actuelle du référentiel svn que vous souhaitez que les utilisateurs utilisent / mettent à jour. Dans la plupart des cas, définissez-le simplement sur `` tronc '', comme expliqué dans cet article sur Smashing Magazine, Comment améliorer le fichier Readme.txt de votre plugin WordPress

Étiquette stable . La balise stable indique à WordPress quelle version du plugin doit apparaître dans le répertoire. Cela devrait être au format numérique, ce qui est beaucoup plus facile à gérer pour WordPress. Visez des nombres comme 1,5, 0,5 ou quelle que soit la version dans laquelle vous vous trouvez. Si votre version stable se trouve dans le tronc de Subversion, vous pouvez alors spécifier «tronc», mais c'est la seule fois où vous devez utiliser des mots au lieu de chiffres.

De plus, à partir de la documentation réelle de WordPress ,

Le répertoire des plugins de WordPress.org fonctionne sur la base des informations trouvées dans le champ Stable Tag du fichier Lisezmoi. Lorsque WordPress.org analyse le fichier readme.txt, la toute première chose qu'il fait est de consulter le fichier readme.txt dans le répertoire / trunk, où il lit la ligne «Stable Tag». Si la balise stable est manquante ou définie sur «trunk», la version du plugin dans / trunk est considérée comme la version stable. Si la balise stable est définie sur autre chose, elle ira chercher dans / tags / la version référencée. Ainsi, une balise stable de «1.2.3» lui fera rechercher /tags/1.2.3/.

Si vous utilisez le svn comme référentiel de développement, il est logique d'utiliser un numéro de version réel dans la balise Stable. par exemple 1.5.2 alors que vous avez la v2.0.0 dans le référentiel sur lequel vous travaillez actuellement, mais il est toujours en cours de développement.

Autre raison d'utiliser un numéro de version

Si votre plugin a des traductions et utilise des chaînes traduites avec des fonctions localisées , vous pouvez envisager d'utiliser une version stable pour la balise, car les fichiers de langue sont chargés pour cette version. Donc, si vous mettez à jour votre plug-in et ajoutez de nombreuses nouvelles chaînes localisées, il est logique de définir votre balise stable sur la version précédente pour donner aux traducteurs le temps de terminer la traduction de la nouvelle version. Une fois les traductions prêtes, vous pouvez changer la balise stable.

Aurovrata
la source