Stabilny tag wtyczki w pliku readme

10

Jeśli wypycham nową wersję (v0.2) mojej wtyczki (v0.1) na repozytorium, co mam zrobić ze stabilnym znacznikiem w pliku readme? Zmienić na v0.2?

Co powinno tu przyjechać? Proszę o wyjaśnienia :)

svn plugin-repository readme Popiół
źródło

Odpowiedzi:

10

Tak. Musisz:

  • Zmień stabilny tag na 0.2
  • Zatwierdź (lub skopiuj / oddział) nową wersję do /tags/0.2
  • Nie zapomnij zaktualizować wersji do 0.2 w nagłówku wtyczki
Rarst
źródło
Myślę, że zaleca się, aby ostatnim krokiem była aktualizacja, trunk/readme.txtaby odzwierciedlić nowy stabilny tag. W przeciwnym razie możesz uzyskać możliwy stan wyścigu, w którym serwery wp.org będą myśleć, że jest nowy tag do spakowania, ale tak naprawdę jeszcze nie istnieje, ponieważ jeszcze tego nie zrobiłeś svn cp.
Dougal Campbell
@Dougal Campbell Myślę, że interwał odświeżania repozytorium wynosi 15 minut, więc kolejność nie jest szczególnie ważna i nie miałem na myśli mojej odpowiedzi na wymuszenie jakiegokolwiek zamówienia ... Będę edytować, aby przejść do listy nieuporządkowanej.
Rarst 16.04.11
Co jest z zamówieniem? Czy nie powinienem po prostu zatwierdzić wszystkiego do trunkingu, a następnie skopiować do podkatalogu w tagach?
Ashfame,
@Ashfame tak, to zadziała. Myślę, że Dougal chciał opisać to, że może się zepsuć, jeśli odświeżenie repozytorium nastąpi po zmianie tułowia, ale przed utworzeniem znacznika docelowego. Osobiście uważam, że to mało prawdopodobne.
Rarst
@Rarst Nawet jeśli ten błąd wystąpi, zostanie rozwiązany przy następnym odświeżeniu, prawda?
Ashfame,
3

Poleciłbym następującą kolejność operacji:

  1. Zaktualizuj .phpplik wtyczki w bagażniku, aby odzwierciedlić nową wersję, i zatwierdź
  2. svn cp trunk tags/0.2
  3. Edytuj tags/0.2/readme.txti trunk/readme.txtodzwierciedl nowy stabilny tag
  4. svn commit -m "Tagging ver 0.2"
Dougal Campbell
źródło
1

Stable tagWskazuje aktualną wersję w repozytorium SVN, które użytkownicy mają zastosowania / aktualizacji. W większości przypadków po prostu ustaw na „bagażnik”, jak wyjaśniono w tym artykule na temat Smashing Magazine, Jak ulepszyć Readme.txt wtyczki WordPress

Stabilny tag . Znacznik stabilny informuje WordPress, która wersja wtyczki powinna pojawić się w katalogu. Powinien to być format liczbowy, z którym WordPress jest o wiele łatwiejszy. Celuj w liczby takie jak 1,5, 0,5 lub w dowolną wersję, w której jesteś. Jeśli twoja stabilna wersja znajduje się w linii głównej w Subversion, możesz określić „trunk”, ale to jedyny raz, kiedy powinieneś używać słów zamiast liczb.

Ponadto, od faktycznej dokumentacji WordPress ,

Katalog wtyczek WordPress.org działa w oparciu o informacje znalezione w polu Stable Tag w pliku readme. Kiedy WordPress.org analizuje plik readme.txt, pierwszą rzeczą, którą robi, jest spojrzenie na plik readme.txt w katalogu / trunk, gdzie odczytuje wiersz „Stable Tag”. Jeśli brakuje znacznika stabilnego lub jest on ustawiony na „trunk”, wówczas wersja wtyczki / trunk jest uważana za wersję stabilną. Jeśli Stable Tag jest ustawiony na cokolwiek innego, to przejdzie do / tags / w poszukiwaniu wersji, do której się odwołuje. Tak więc stabilny tag „1.2.3” sprawi, że będzie szukał /tags/1.2.3/.

Jeśli używasz svn jako repozytorium programistycznego, sensowne jest użycie rzeczywistego numeru wersji w znaczniku stabilnym. na przykład 1.5.2, gdy w repozytorium, nad którym aktualnie pracujesz, znajduje się wersja 2.0.0, ale wciąż jest w fazie rozwoju.

Inny powód, aby użyć numeru wersji

Jeśli Twoja wtyczka ma tłumaczenia i korzysta z przetłumaczonych ciągów ze zlokalizowanymi funkcjami , możesz rozważyć użycie stabilnej wersji znacznika, ponieważ pliki językowe są ładowane dla tej wersji. Jeśli więc zaktualizujesz wtyczkę i dodasz wiele nowych zlokalizowanych ciągów, warto ustawić stabilny tag na poprzednią wersję, aby dać tłumaczom czas na dokończenie tłumaczenia dla nowej wersji. Gdy tłumaczenia będą gotowe, możesz przełączyć stabilny tag.

Aurovrata
źródło