Tag stabile del plugin nel file Leggimi


10

Se sto inviando una nuova versione (v0.2) del mio plugin (v0.1) sul repository, cosa devo fare con il tag stable nel file readme? Cambiarlo in v0.2?

Cosa dovrebbe venire qui? Chiarimenti per favore :)

Risposte:


10

Sì. Devi:

  • Cambia tag stabile in 0.2
  • Salva (o copia / dirama) la nuova versione in /tags/0.2
  • Non dimenticare di aggiornare la versione a 0.2 nell'intestazione del plugin

Penso che sia consigliato che l' ultimo passaggio sia l'aggiornamento trunk/readme.txtper riflettere il nuovo tag stable. Altrimenti puoi ottenere una possibile condizione di competizione in cui i server wp.org pensano che ci sia un nuovo tag da raggruppare, ma in realtà non esiste ancora, perché non l'hai ancora fatto svn cp.
Dougal Campbell,

@Dougal Campbell Penso che l'intervallo di aggiornamento del repository sia di 15 minuti, quindi l'ordine non è particolarmente importante e non intendevo la mia risposta per far rispettare qualsiasi ordine ... Modificherò per passare all'elenco non ordinato.
Rarst

Che succede con l'ordine? Non dovrei semplicemente impegnare tutto su trunk e quindi copiarlo in una sottodirectory in Tag?
Ashfame,

@Ashfame sì, funzionerà. Penso che Dougal abbia voluto descrivere che potrebbe non funzionare correttamente se l'aggiornamento del repository si verifica dopo aver modificato il trunk ma prima di creare il tag target. Personalmente penso sia improbabile.
Rarst

@Rarst Anche se si verifica quel problema tecnico, verrà comunque risolto nel prossimo aggiornamento, giusto?
Ashfame,

3

Consiglierei questo ordine di operazioni:

  1. Aggiorna il .phpfile del tuo plugin nel trunk per riflettere la nuova versione e esegui il commit
  2. svn cp trunk tags/0.2
  3. Modifica tags/0.2/readme.txte trunk/readme.txtper riflettere il nuovo tag stabile
  4. svn commit -m "Tagging ver 0.2"

1

Il Stable tagindica la versione corrente nel repository svn cui si desidera agli utenti di utilizzare / aggiornamento. Nella maggior parte dei casi è sufficiente impostarlo su "trunk", come spiegato in questo articolo su Smashing Magazine, Come migliorare il file Leggimi.txt del plug-in WordPress

Etichetta stabile . Il tag stable indica a WordPress quale versione del plugin dovrebbe apparire nella directory. Questo dovrebbe essere in formato numerico, che è molto più facile da gestire per WordPress. Cerca numeri come 1.5, 0.5 o qualunque versione tu stia. Se la tua versione stabile è nel trunk in Subversion, puoi specificare "trunk", ma questa è l'unica volta in cui dovresti usare le parole invece dei numeri.

Inoltre, dall'attuale documentazione di WordPress ,

La directory dei plugin di WordPress.org funziona in base alle informazioni trovate nel campo Tag stabile nel file Leggimi. Quando WordPress.org analizza il file readme.txt, la prima cosa che fa è guardare il file readme.txt nella directory / trunk, dove legge la riga "Tag stabile". Se il tag stabile è mancante o è impostato su "trunk", la versione del plug-in in / trunk è considerata la versione stabile. Se il tag stabile è impostato su qualsiasi altra cosa, andrà a cercare in / tags / la versione referenziata. Quindi un tag stabile di "1.2.3" lo farà cercare /tags/1.2.3/.

Se si utilizza svn come repository di sviluppo, è logico utilizzare un numero di versione effettivo nel tag Stable. ad esempio 1.5.2 mentre hai la v2.0.0 nel repository su cui stai attualmente lavorando ma è ancora in fase di sviluppo.

Altro motivo per utilizzare un numero di versione

Se il tuo plugin ha traduzioni e utilizza stringhe tradotte con funzioni localizzate , potresti prendere in considerazione l'idea di utilizzare una versione stabile per il tag, poiché i file di lingua vengono caricati per quella versione. Pertanto, se aggiorni il plug-in e aggiungi molte nuove stringhe localizzate, ha senso impostare il tag stabile sulla versione precedente per dare tempo ai traduttori di completare la traduzione per la nuova versione. Una volta che le traduzioni sono pronte, puoi cambiare il tag stable.

Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.