brasil.gov.tiles 2.0b3

Tiles para o Portal Padrão do Governo Federal

Conteúdo

• Introdução

• Estado deste complemento

• Instalação

• Atualização de 1.x a 2.x

• Tiles do pacote

  • Citação

  • Foto do Dia

  • Galeria de fotos

  • Navegação

  • Carrossel de vídeos

  • Carrossel de grupo

  • Carrossel de destaques

  • Compartilhamento nas redes sociais

• Desenvolvimento

• Fazendo releases com o zest.releaser

• Contribuidores

• Changelog

  • 2.0b3 (2018-09-28)

  • 2.0b2 (2018-09-19)

  • 2.0b1 (2018-09-04)

  • 2.0a1 (2018-08-31)

Introdução

Este complemento provê tiles (Blocos de conteúdo) para uso em sites Plone do Governo da República Federativa do Brasil.

Estado deste complemento

O brasil.gov.tiles tem testes automatizados e, a cada alteração em seu código os testes são executados pelo serviço Travis CI.

O estado atual dos testes pode ser visto na imagem a seguir:

Instalação

Para habilitar a instalação deste produto em um ambiente que utilize o buildout:

1. Editar o arquivo buildout.cfg (ou outro arquivo de configuração) e adicionar o pacote brasil.gov.tiles à lista de eggs da instalação:

[buildout]
...
eggs =
    brasil.gov.tiles

2. Após alterar o arquivo de configuração é necessário executar ‘’bin/buildout’’, que atualizará sua instalação.

3. Reinicie o Plone

4. Acesse o painel de controle e na opção tiles você verá os tiles providos por este pacote listados.

Atualização de 1.x a 2.x

Warning

Só atualize para a versão 2.x do complemento depois de atualizar à versão mais recente da branch 1.x. O processo de migração remove os tiles descontinuados das capas existentes.

As atualizações da versão 1.x à 2.x só são suportadas das versões mais recentes de cada branch. Antes de atualizar confira que você está efetivamente utilizando a última versão da branch 1.x e que não existem upgrade steps pendentes de serem aplicados.

Esta versão remove os tiles Banner rotativo, Carrossel de mídia, Destaque, Em destaque e Social dos layouts existentes pois eles não são utilizados no IDG v2. Esses tiles serão removidos das capas existentes.

Esta versão também remove os overrides dos tiles padrão do collective.cover e collective.nitf. Esses tiles serão migrados das capas existentes. O processo de migração atualiza o atributo alt_text nesses tiles (o atributo variacao_titulo e simplesmente ignorado por ser um recurso que também não existe mais).

Tiles do pacote

Citação

Mostra uma citação de uma matéria.

Foto do Dia

Mostra uma foto excepcional selecionada diariamente.

Galeria de fotos

Mostra uma galeria de fotos.

Navegação

Mostra um menu de navegação exibindo os conteúdos como itens de menu a partir do caminho que foi adicionado.

Carrossel de vídeos

Mostra um carrossel de vídeos.

Carrossel de grupo

Mostra um carrossel de itens com imagens.

Carrossel de destaques

Mostra um carrossel de imagens em destaques.

Compartilhamento nas redes sociais

Uma funcionalidade de compartilhamento nas redes sociais pode ser habilitada em alguns tiles seguindo os seguintes critérios:

Tile NITF

Seu primeiro link aponte para um conteúdo interno.

Tile Rich Text

É necessário que adicione o estilo Box Colorido na configuração do tile (aba layout), e seu primeiro link aponte para um conteúdo interno.

Desenvolvimento

Utilizamos webpack para gerenciar o conteúdo estático do tema, tomando vantagem das diversas ferramentas e plugins disponíveis para suprir nossas necessidades.

Utilizamos a receita de buildout sc.recipe.staticresources para integrar o webpack no Plone.

Ao desenvolver os temas iniciamos o watcher do webpack e trabalhamos somente na pasta “webpack” alterando os arquivos; o webpack se encarrega de processar e gerar os arquivos em seu endereço final.

Este pacote adiciona os seguintes comandos na pasta bin do buildout para processar automaticamente os recursos estáticos:

$ bin/env-brasilgovtiles

Este comando adiciona no terminal o node do buildout no PATH do sistema, dessa forma voce pode trabalhar com webpack conforme a documentação oficial.

$ bin/watch-brasilgovtiles

Este comando instrui ao Webpack para esperar por qualquer mudança nos arquivos SASS e gera a versão minificada do CSS para a aplicação.

$ bin/debug-brasilgovtiles

Este comando faz o mesmo que o comando watch, mas não minifica o CSS final. Utilizado para debugar a geração do CSS.

$ bin/build-brasilgovtiles

Este comando cria o CSS minificado, mas não espera por mudanças.

Fazendo releases com o zest.releaser

Os recursos estáticos do pacote são gerados usando o webpack e não são inclusos no VCS. Se você está fazendo release usando o zest.releaser, você precisa fazer upload manual dos arquivos no PyPI ou você vai criar uma distribuição quebrada:

• execute longtest, como de costume

• execute fullrelease, como de costume, respondendo “não” a pergunta “Check out the tag?” para evitar o upload ao PyPI

• faça checkout na tag do release que você está liberando

• execute bin/build-brasilgovtiles para criar os recursos estáticos

• crie os arquivos da distribuição usando python setup.py sdist bdist_wheel, como de costume

• faça o upload manual dos arquivos usando twine upload dist/*

Em caso de erro você terá que criar um novo release pois o PyPI Warehouse não permite reutilizar um nome de arquivo.

Contribuidores

O brasil.gov.tiles não seria possível sem a contribuição das seguintes pessoas:

• André Nogueira

• Danilo Barbato

• Érico Andrei

• Felipe Duardo

• Héctor Velarde

• Leonardo J. Caballero G.

• Rennan Rodrigues

• Rodrigo Ferreira de Souza

• Silvestre Huens

Changelog

2.0b3 (2018-09-28)

• Revisa regras para aplicar compartilhamento em tiles. [rodfersou]

• Deixa a seta do carrossel invisível quando ela estiver inativa. [agnogueira]

2.0b2 (2018-09-19)

• Evita o erro NotFound ao rodar o upgrade step da versão 4100 (fecha #260). [hvelarde]

• Evita a emissão de source maps dos recursos estáticos. [hvelarde]

2.0b1 (2018-09-04)

Warning

Este release atualiza as dependências do processamento de recursos estáticos. Em ambiente de desenvolvimento pode ser necessário remover as pastas parts e webpack/node_modules para efetivar a atualização de ambiente.

• Atualiza i18n e traduções ao Português Brasileiro. [agnogueira, hvelarde]

• Atualiza versões do Node.js e sc.recipe.staticresources. [rodfersou]

• Evita registrar recursos estáticos do Swiper no upgrade step da versão 4100. [rodfersou]

• Evita AttributeError no tile de Foto do dia (fecha #255). [hvelarde]

• Evita TypeError no tile de Citação (fecha #254). [hvelarde]

• Evita tipos de conteúdo duplicados no configlet do collective.cover (fecha #252). [hvelarde]

• Evita o erro WrongContainedType ao rodar o upgrade step da versão 4100 (fecha #249). [hvelarde]

2.0a1 (2018-08-31)

Warning

Atualizações da branch 1.x do pacote só serão suportadas da versão mais recente dessa branch. Esta versão remove os tiles Banner rotativo, Carrossel de mídia, Destaque, Em destaque e Social dos layouts existentes pois eles não são utilizados no IDG v2. Esta versão também remove os overrides dos tiles padrão do collective.cover e collective.nitf. Um processo de migração atualiza o atributo alt_text nesses tiles (o atributo variacao_titulo e simplesmente ignorado por ser um recurso que também não existe mais).

• Adiciona funcionalidade de compartilhamento nas redes sociais nos tiles de matéria (collective.nitf) e texto rico. [rodfersou]

• Adiciona um tile para mostrar um Carrossel de destaques. [claytonc]

• Remove os tiles Banner rotativo, Carrossel de mídia, Destaque, Em destaque e Social. [hvelarde]

• Adiciona um tile para mostrar um Carrossel de grupo. [claytonc]

• Usa o six ao invés do future para compatibilidade futura com o Python 3. [hvelarde]

• Adiciona um tile para mostrar um Carrossel de vídeos. [rodfersou]

• Remove overrides dos tiles Banner, Básico e Embed do collective.cover. [hvelarde]

• Remove override do tile de matéria (collective.nitf). [hvelarde]

• Adiciona um tile para mostrar um menu de navegação. [claytonc]

• Adiciona um tile para mostrar uma Galeria de fotos. [claytonc]

• Adiciona um tile para mostrar a Foto do Dia. [claytonc, hvelarde]

• Adiciona um tile para mostrar uma citação de uma matéria. [rodfersou]

• Corrige dependências do pacote. [hvelarde]

• Adiciona suporte para processamento de recursos estáticos usando o webpack. [rodfersou]

• Remove upgrade steps antigos. [rodfersou]