Stabiles Tag des Plugins in der Readme-Datei


10

Was mache ich mit dem stabilen Tag in der Readme-Datei, wenn ich eine neue Version (v0.2) meines Plugins (v0.1) auf das Repo drücke? Auf v0.2 ändern?

Was soll hierher kommen? Klarstellungen bitte :)

Antworten:


10

Ja. Du musst:

  • Ändern Sie das stabile Tag auf 0,2
  • Festschreiben (oder Kopieren / Verzweigen) einer neuen Version an /tags/0.2
  • Vergessen Sie nicht, die Version im Header des Plugins auf 0.2 zu aktualisieren

Ich denke, es wird empfohlen, dass der letzte Schritt trunk/readme.txtdarin besteht, das neue stabile Tag zu aktualisieren . Andernfalls können Sie eine mögliche Race-Bedingung erhalten, bei der die wp.org-Server glauben, dass ein neues Tag gebündelt werden muss, das jedoch noch nicht vorhanden ist, da Sie dies noch nicht getan svn cphaben.
Dougal Campbell

@Dougal Campbell Ich denke, das Aktualisierungsintervall des Repositorys beträgt 15 Minuten, daher ist die Reihenfolge nicht besonders wichtig, und ich habe meine Antwort nicht zur Durchsetzung einer Bestellung gemeint ... Ich werde sie bearbeiten, um zur ungeordneten Liste zu wechseln.
Rarst

Was ist mit der Bestellung los? Sollte ich nicht einfach alles in den Trunk übertragen und dann in ein Unterverzeichnis in Tags kopieren?
Ashfame

@ Ashfame ja, das wird funktionieren. Ich denke, was Dougal beschreiben wollte, ist, dass es zu Störungen kommen kann, wenn die Repository-Aktualisierung erfolgt, nachdem Sie den Trunk geändert haben, aber bevor Sie ein Ziel-Tag erstellen. Persönlich halte ich das für unwahrscheinlich.
Rarst

@Rarst Auch wenn dieser Fehler auftritt, wird er bei der nächsten Aktualisierung trotzdem behoben, oder?
Ashfame

3

Ich würde diese Reihenfolge empfehlen:

  1. Aktualisieren Sie die .phpDatei Ihres Plugins im Trunk, um die neue Version wiederzugeben, und legen Sie fest
  2. svn cp trunk tags/0.2
  3. Bearbeiten tags/0.2/readme.txtund trunk/readme.txtum ein neues stabiles Tag wiederzugeben
  4. svn commit -m "Tagging ver 0.2"

1

Das Stable taggibt die aktuelle Version im SVN-Repository an, die Benutzer verwenden / aktualisieren sollen. In den meisten Fällen setzen Sie es einfach auf "trunk", wie in diesem Artikel im Smashing Magazine, So verbessern Sie die Readme.txt Ihres WordPress-Plugins, erläutert

Stabiler Tag . Das Stable-Tag teilt WordPress mit, welche Version des Plugins im Verzeichnis erscheinen soll. Dies sollte im numerischen Format erfolgen, was für WordPress viel einfacher zu handhaben ist. Streben Sie Zahlen wie 1,5, 0,5 oder eine andere Version an. Wenn sich Ihre stabile Version in Subversion im Trunk befindet, können Sie "Trunk" angeben. Dies ist jedoch das einzige Mal, dass Sie Wörter anstelle von Zahlen verwenden sollten.

Darüber hinaus aus der eigentlichen WordPress-Dokumentation ,

Das Plugin-Verzeichnis von WordPress.org basiert auf den Informationen im Feld Stable Tag in der Readme-Datei. Wenn WordPress.org die Datei readme.txt analysiert, wird als erstes die Datei readme.txt im Verzeichnis / trunk angezeigt, in der die Zeile "Stable Tag" gelesen wird. Wenn das stabile Tag fehlt oder auf "Trunk" gesetzt ist, wird die Version des Plugins in / trunk als stabile Version betrachtet. Wenn das stabile Tag auf etwas anderes gesetzt ist, sucht es in / tags / nach der referenzierten Version. Ein stabiles Tag von "1.2.3" lässt es also nach /tags/1.2.3/ suchen.

Wenn Sie den SVN als Entwicklungs-Repository verwenden, ist es sinnvoll, eine tatsächliche Versionsnummer im Stable-Tag zu verwenden. Zum Beispiel 1.5.2, während Sie v2.0.0 in dem Repository haben, an dem Sie gerade arbeiten, das sich jedoch noch in der Entwicklung befindet.

Anderer Grund, eine Versionsnummer zu verwenden

Wenn Ihr Plugin Übersetzungen enthält und übersetzte Zeichenfolgen mit lokalisierten Funktionen verwendet , sollten Sie eine stabile Version für das Tag verwenden, da Sprachdateien für diese Version geladen werden. Wenn Sie also Ihr Plugin aktualisieren und viele neue lokalisierte Zeichenfolgen hinzufügen, ist es sinnvoll, Ihr stabiles Tag auf die vorherige Version zu setzen, damit die Übersetzer Zeit haben, die Übersetzung für die neue Version abzuschließen. Sobald die Übersetzungen fertig sind, können Sie das stabile Tag wechseln.

Durch die Nutzung unserer Website bestätigen Sie, dass Sie unsere Cookie-Richtlinie und Datenschutzrichtlinie gelesen und verstanden haben.
Licensed under cc by-sa 3.0 with attribution required.