Etiqueta estable del complemento en el archivo Léame


10

Si estoy enviando una nueva versión (v0.2) de mi complemento (v0.1) en el repositorio, ¿qué hago con la etiqueta estable en el archivo Léame? ¿Cambiarlo a v0.2?

¿Qué debería venir aquí? Aclaraciones por favor :)

Respuestas:


10

Si. Necesitas:

  • Cambiar etiqueta estable a 0.2
  • Confirmar (o copiar / ramificar) una nueva versión en /tags/0.2
  • No olvide actualizar la versión a 0.2 en el encabezado del complemento

Creo que se recomienda que el último paso sea actualizar trunk/readme.txtpara reflejar la nueva etiqueta estable. De lo contrario, puede obtener una posible condición de carrera en la que los servidores de wp.org creen que hay una nueva etiqueta para agrupar, pero en realidad aún no existe, porque aún no lo ha hecho svn cp.
Dougal Campbell

@Dougal Campbell Creo que el intervalo de actualización del repositorio es de 15 minutos, por lo que el orden no es particularmente importante y no quise decir mi respuesta para hacer cumplir ningún orden ... Lo editaré para cambiar a una lista desordenada.
Rarst

¿Qué pasa con el pedido? ¿No debería simplemente confirmar todo en el tronco y luego copiarlo en un subdirectorio en Etiquetas?
Ashfame

@Ashfame sí, eso funcionará. Creo que lo que Dougal quería describir es que puede fallar si la actualización del repositorio ocurre después de cambiar el tronco pero antes de crear la etiqueta de destino. Personalmente creo que es poco probable.
Rarst

@Rarst Incluso si se produce esa falla, se resolverá en la próxima actualización de todos modos, ¿verdad?
Ashfame

3

Recomiendo este orden de operaciones:

  1. Actualice el .phparchivo de su complemento en el tronco para reflejar la nueva versión y confirme
  2. svn cp trunk tags/0.2
  3. Editar tags/0.2/readme.txty trunk/readme.txtreflejar una nueva etiqueta estable
  4. svn commit -m "Tagging ver 0.2"

1

El Stable tagindica la versión actual en el repositorio SVN que desea a los usuarios utilizar / actualización. En la mayoría de los casos, simplemente configúrelo como 'tronco', como se explica en este artículo en Smashing Magazine, Cómo mejorar el archivo Readme.txt de su complemento de WordPress

Etiqueta estable . La etiqueta estable le dice a WordPress qué versión del complemento debe aparecer en el directorio. Esto debería estar en formato numérico, que es mucho más fácil de manejar para WordPress. Apunte a números como 1.5, 0.5 o cualquier versión en la que se encuentre. Si su versión estable está en la troncal en Subversion, puede especificar "troncal", pero esa es la única vez que debe usar palabras en lugar de números.

Además, de la documentación real de WordPress ,

El Directorio de complementos de WordPress.org funciona según la información que se encuentra en el campo Etiqueta estable en el archivo Léame. Cuando WordPress.org analiza el archivo readme.txt, lo primero que hace es mirar el archivo readme.txt en el directorio / trunk, donde lee la línea "Etiqueta estable". Si falta la etiqueta estable, o se establece en "trunk", la versión del complemento en / trunk se considera la versión estable. Si la etiqueta estable está configurada para otra cosa, irá y buscará en / tags / la versión referenciada. Por lo tanto, una etiqueta estable de "1.2.3" hará que busque /tags/1.2.3/.

Si usa el svn como su repositorio de desarrollo, entonces tiene sentido usar un número de versión real en la etiqueta Estable. por ejemplo 1.5.2 mientras tiene v2.0.0 en el repositorio en el que está trabajando actualmente pero aún está en desarrollo.

Otra razón para usar un número de versión

Si su complemento tiene traducciones y hace uso de cadenas traducidas con funciones localizadas , puede considerar usar una versión estable para la etiqueta, ya que los archivos de idioma se cargan para esa versión. Entonces, si actualiza su complemento y agrega muchas cadenas nuevas localizadas, entonces tiene sentido establecer su etiqueta estable en la versión anterior para dar tiempo a los traductores para completar la traducción de la nueva versión. Una vez que las traducciones estén listas, puede cambiar la etiqueta estable.

Al usar nuestro sitio, usted reconoce que ha leído y comprende nuestra Política de Cookies y Política de Privacidad.
Licensed under cc by-sa 3.0 with attribution required.