Etiqueta estável do plug-in no arquivo leia-me

Se estou enviando uma nova versão (v0.2) do meu plug-in (v0.1) no repositório, o que faço com a tag stable no arquivo leia-me? Altere para v0.2?

O que deveria vir aqui? Esclarecimentos, por favor :)

svn plugin-repository readme

— Ashfame
fonte

Respostas:

Sim. Você precisa:

Alterar tag estável para 0,2
Confirme (ou copie / ramifique) nova versão para /tags/0.2
Não se esqueça de atualizar a versão para 0.2 no cabeçalho do plugin

— Rarst
fonte

Eu acho que é recomendável que o último passo seja atualizar trunk/readme.txtpara refletir a nova tag estável. Caso contrário, você poderá obter uma possível condição de corrida em que os servidores wp.org acham que há uma nova tag a ser agrupada, mas ela ainda não existe, porque você ainda não fez isso svn cp.

— Dougal Campbell

@Dougal Campbell Acho que o intervalo de atualização do repositório é de 15 minutos, portanto, a ordem não é particularmente importante e eu não quis minha resposta para fazer cumprir nenhuma ordem ... Vou editar para mudar para uma lista não ordenada.

— Rarst

O que há com o pedido? Não devo apenas comprometer tudo no tronco e depois copiar para um subdiretório no Tags?

— Ashfame 16/04

@ Ashfame sim, isso vai funcionar. Acho que o que Dougal queria descrever é que ele pode apresentar falhas se a atualização do repositório ocorrer depois que você muda o tronco, mas antes de criar a marca de destino. Pessoalmente, acho isso improvável.

— Rarst

@Rarst Mesmo que essa falha ocorra, ela será resolvida na próxima atualização, certo?

— Ashfame

Eu recomendo esta ordem de operações:

Atualize o .phparquivo do seu plug-in no tronco para refletir a nova versão e confirme
svn cp trunk tags/0.2
Edite tags/0.2/readme.txte trunk/readme.txtpara refletir uma nova tag estável
svn commit -m "Tagging ver 0.2"

— Dougal Campbell
fonte

O Stable tagindica a versão atual no repositório svn que você deseja que os usuários usem / atualizem. Na maioria dos casos, simplesmente defina-o como 'trunk', conforme explicado neste artigo na Smashing Magazine, Como melhorar o Readme.txt do seu plug-in do WordPress

Etiqueta estável . A tag stable diz ao WordPress qual versão do plug-in deve aparecer no diretório Isso deve estar no formato numérico, o que é muito mais fácil para o WordPress lidar. Procure números como 1,5, 0,5 ou qualquer outra versão. Se sua versão estável está no tronco no Subversion, você pode especificar "tronco", mas essa é a única vez que você deve usar palavras em vez de números.

Além disso, a partir da documentação real do WordPress ,

O Diretório de plugins do WordPress.org funciona com base nas informações encontradas no campo Etiqueta estável no leia-me. Quando o WordPress.org analisa o readme.txt, a primeira coisa que faz é olhar para o readme.txt no diretório / trunk, onde ele lê a linha "Stable Tag". Se o Tag estável estiver ausente ou estiver definido como "trunk", a versão do plug-in em / trunk será considerada a versão estável. Se a etiqueta estável estiver definida para qualquer outra coisa, ela procurará em / tags / a versão referenciada. Portanto, um Tag estável de "1.2.3" fará com que procure /tags/1.2.3/.

Se você usar o svn como seu repositório de desenvolvimento, faz sentido usar um número de versão real na tag Stable. por exemplo 1.5.2 enquanto você possui a v2.0.0 no repositório no qual você está trabalhando atualmente, mas ainda está em desenvolvimento.

Outro motivo para usar um número de versão

Se o seu plug-in tiver traduções e fizer uso de strings traduzidas com funções localizadas , considere usar uma versão estável para a tag, pois os arquivos de idioma são carregados para essa versão. Portanto, se você atualizar seu plug-in e adicionar muitas novas strings localizadas, faz sentido definir sua tag stable para a versão anterior para dar tempo aos tradutores para concluir a tradução para a nova versão. Quando as traduções estiverem prontas, você poderá alternar a etiqueta stable.

— Aurovrata
fonte