Skip to main content

Tiles para o Portal Padrão do Governo Federal

Project description

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:

http://img.shields.io/pypi/v/brasil.gov.tiles.svg https://img.shields.io/travis/plonegovbr/brasil.gov.tiles/master.svg https://img.shields.io/coveralls/plonegovbr/brasil.gov.tiles/master.svg https://img.shields.io/codacy/grade/5a403e23e61d49d195fcb640d1566a89.svg

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
  1. Após alterar o arquivo de configuração é necessário executar ‘’bin/buildout’’, que atualizará sua instalação.

  2. Reinicie o Plone

  3. 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

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.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/quote.png

Foto do Dia

Mostra uma foto excepcional selecionada diariamente.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/potd.png

Galeria de fotos

Mostra uma galeria de fotos.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/photogallery.png

Carrossel de vídeos

Mostra um carrossel de vídeos.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/videocarousel.png

Carrossel de grupo

Mostra um carrossel de itens com imagens.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/groupcarousel.png

Carrossel de destaques

Mostra um carrossel de imagens em destaques.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/highlightscarousel.png

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 alguma classe na configuração do tile (aba layout), e seu primeiro link aponte para um conteúdo interno.

https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/tileshare.png

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-brasilgovtemas 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.0b1 (2018-09-04)

  • 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)

  • 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]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brasil.gov.tiles-2.0b1.tar.gz (2.6 MB view hashes)

Uploaded Source

Built Distribution

brasil.gov.tiles-2.0b1-py2-none-any.whl (393.8 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page