DisponibilizarNovoRelease

Disponibilizar um novo release do abnTeX2

Compilação

Para criar um novo release do abnTeX2, siga os passos:

1. Atualize o arquivo doc/latex/abntex2/README
2. Digite em um terminal Linux ou Mac OS X: ./build.sh RELEASE
3. Verifique na pasta target se todos os arquivos foram gerados corretamente; * São gerados 4 arquivos compactados:
   • abntex2-doc-RELEASE.zip: arquivos de documentação (código-fonte e PDF compilados);
   • abntex2-modelos-RELEASE.zip: arquivos de exemplos (código-fonte e PDF compilados);
   • abntex2.tds-RELEASE.zip: estrutura TDS de diretórios usado nas distribuições LaTeX TeXLive e MiKTeX. Este arquivo que deve ser usado para instalação manual.
   • abntex2.tds-RELEASE.tar.gz: estrutura TDS de diretórios usado nas distribuições pelos empacotadores Linux.
   • abntex2.zip: arquivo a ser enviado ao CTAN. Contém o arquivo abntex2.tds-RELEASE.zip, documentos, exemplos e README na estrutura descrita pelo CTAN na página Upload e em Guide­lines for up­load­ing TDS-Pack­aged ma­te­ri­als to CTAN. * Os quatro primeiros arquivos gerados serão automaticamente instalados no GoogleCode pelo passo seguinte, o último deve ser manualmente enviado ao CTAN, conforme passos descritos na seção Comunicados e outras tarefas manuais. * Observe, especialmente, se todos os arquivos PDF de modelos e de exemplos foram gerados e que estão com a informação de versão e de data nas capas;

Tag e Deploy no Bintray

1. Para efetivar a criação do release, novamente em um terminal, digite:./build.sh RELEASE USUARIO SENHA * Sendo que:

   • RELEASE: o nome do release, por exemplo: 1.6 (não coloque o "v" antes do número);
   • USUARIO e SENHA: o seu e-mail sem o @domain.com e API KEY do Bintray;

2. Crie um tag no Git com o comando git tag (muito importante) * use o padrão: YYYY-MM-DD vVERSAO release to CTAN, por exemplo: 2015-04-26-v1.9.4-ctan

3. Pronto! Isso gerará novamente os pacotes e criará automaticamente todos os downloads no Bintray.

Comunicados e outras tarefas manuais

Uma vez gerado o release, realize as seguintes tarefas manuais:

1. Atualize a página de ReleaseNotes com as notas de lançamento da versão * Use as informações do arquivo README * A página da Wiki deve estar em português, e o README em inglês. Por isso, é necessário traduzir;
2. Atualize a wiki de Downloads com as versões publicadas no Bintray;
3. Faça upload da nova versão no CTAN * Use o arquivo target/abntex2.zip * Na página do CTAN, informe:
   • Name of your contribution: ab­nTeX2
   • Summary description: Type­set tech­ni­cal and sci­en­tific Brazil­ian doc­u­ments based on ABNT rules
   • Suggested CTAN directory: /macros/la­tex/con­trib/ab­n­tex2
   • Changes: o mesmo conteúdo do README
   • Administrative notes: use quando for necessário incluir algum novo modelo na página do abnTeX2 no CTAN * Se precisar alterar alguma informação no CTAN, entre em contato com:
   • CTAN DANTE: e-mail principal
   • Robin Fairbairns: coordenador
   • Rainer Schöpf: coordenador
   • Gerd Neugebauer: chefe do portal CTAN * A atualização do CTAN é usada pelo abnTeX2 no MiKTeX, e pode demorar algumas semanas; * Envie por e-mail a página de resposta de sucesso da submissão do pacote do CTAN ao grupo de desenvolvedores
4. Atualize a informação de versão no InfoBox da Wikipedia 1. Faça login na Wikipedia; 1. Clique em Editar; 1. Fala as alterações e clique em Grava página;
5. Envie um e-mail ao grupo de desenvolvedores e outro ao grupo de usuários informando sobre a nova versão;
6. Envie outro e-mail ao grupo de desenvolvedores chamando os empacotares Linux para providenciarem o empacotamento e distribuição da nova versão. * Os responsáveis são as pessoas do projeto que possuem a duty Package releases from release branches;
7. Envie uma mensagem à comunidade abnTeX2 do G+ sobre a nova versão;
8. Atualize o abnTeX2 no SuperDownloads: * Envie um e-mail a [email protected] e informe a nova versão.
9. Pronto!

Veja também

Ferramentas e procedimentos utilizados no desenvolvimento do abnTeX2

Como contribuir com o projeto

Como customizar o abnTeX2

Ferramentas para se trabalhar com LaTeX