Package: brasil.gov.temas
ConteúdoIntroduçãoTemasTema PadrãoTema BrancoEstado deste pacoteInstalaçãoDesenvolvimentoPasso a passoMais detalhesLinks de línguas no topo (Internacionalização)Fazendo releases com o zest.releaserContribuidoresChangelog2.0.3 (2019-02-22)2.0.2 (2018-12-28)2.0.1 (2018-12-07)2.0 (2018-12-04)2.0rc1 (2018-11-23)2.0b5 (2018-10-17)2.0b4 (2018-10-05)2.0b3 (2018-09-28)2.0b2 (2018-09-04)2.0b1 (2018-08-31)2.0a6 (2018-07-06)2.0a5 (2018-06-06)2.0a4 (2018-02-08)2.0a3 (2018-01-11)2.0a2 (2018-01-11)2.0a1 (2017-12-27)IntroduçãoEste pacote provê 2 temas (Diazo) modelo do Governo Federal para uso em sites Plone do Governo da República Federativa do Brasil.O desenvolvimento deste pacote foi feito como parte da iniciativaPortal Padrãoda comunidadePloneGov.Br.TemasTema PadrãoTema BrancoEstado deste pacoteObrasil.gov.temasconta testes automatizados e, a cada alteração em seu
código os testes são executados pelo serviçoTravis.O estado atual dos testes, a cobertura de código e o número de downloads deste pacote podem ser vistos nas imagens a seguir:InstalaçãoPara habilitar a instalação deste produto em um ambiente que utilize o buildout:Editar o arquivo buildout.cfg (ou outro arquivo de configuração) e adicionar o pacotebrasil.gov.temasà lista de eggs da instalação:[buildout]...eggs=brasil.gov.temasApós alterar o arquivo de configuração é necessário executar ‘’bin/buildout’’, que atualizará sua instalação.Reinicie o PloneAcesse o painel de controle e na opçãoTemasvocê verá os temas providos por este pacote listados.DesenvolvimentoPasso a passoAbrir um terminal, entrar na pasta do projeto, rodar buildout e iniciar a instancia;Abrir outro terminal, entrar na pasta do projeto, iniciar o comandobin/watch-brasilgovtemas;Alterar os arquivos na pastawebpack.Mais detalhesUtilizamoswebpackpara 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 buildoutsc.recipe.staticresourcespara integrar owebpackno Plone.Ao desenvolver os temas iniciamos o watcher dowebpacke trabalhamos somente na pasta “webpack” alterando os arquivos;
owebpackse encarrega de processar e gerar os arquivos em seu endereço final.Segue uma lista dos principais arquivos:$treewebpack/appwebpack/app
├── brasilgovtemas.js
├── favicons
│   └── Lista de imagens para o Favicon
├── fonts
│   └── Lista de Fontes utilizadas no site
├── index.html
├── js
│   └── Lista de módulos Javascript
├── rules.xml
├── scss
│   └── Lista de módulos Scss
├── tema-1
│   ├── brasilgovtemas.scss
│   ├── favicons
│   │   ├── browserconfig.xml
│   │   └── manifest.json
│   ├── img
│   │   └── sprite.png
│   ├── manifest.cfg
│   ├── preview.png
│   ├── sprite
│   │   └── Lista de Imagens para criação do sprite
│   └── _sprite.scss
├── tema-2
│   └── Arquivos do tema 2
└── tema-3
    └── Arquivos do tema 3Na estrutura atual, existem alguns arquivos comuns a todos os temas e alguns arquivos diferentes para cada tema.
Os arquivos globais ficam na pastawebpack/appenquanto os demais arquivos ficam dentro da pasta de cada tema.Foi adotada a estratégia pouco comum ao Plone de não registrar os arquivos CSS e JS noportal_csseportal_javascripts;
Ao invés disso, deixamos o trabalho de gerar um novo nome desses arquivos para owebpack.O arquivobrasilgovtemas.jsé escrito em ES6 e, ao processar,
cria um arquivobrasilgovtemas-[hash].jstransformado em ES5 através do compiladorBabel,
e é criada uma cópia por tema desse arquivo.Na pastafaviconsexistem as imagens necessárias para incluir o favicon do site para todas as plataformas.Na pastafontspossui as web fontes utilizadas nos temas deste pacote.O arquivoindex.htmlda pasta do Diazo não está no controlador de versões.
Ao invés disso, existe umindex.htmlna pasta “webpack” que é processado a cada execução do buildout ou dowebpack,
e gera arquivos JS, CSS eindex.htmlna pasta do Diazo.
Os arquivos JS e CSS possuem nomes especiais com um hash que é renovados a cada execução do buildout.O arquivorules.xmlé copiado para cada tema, e a princípio é igual para todos os temas.Na pastascssexistem os arquivos de estilos propriamente dito,
é la que devemos alterar alguma estrutura de CSS compartilhada por todos os temas,
e uma alteração nessa pasta repercurte em alteração me todos os temas após execução dowebpack.Existe um arquivobrasilgovtemas.scsspara cada tema;
nele existem definições de variáveis do que muda em cada tema, fontes, tamanhos e cores,
e importa os arquivos da pasta “scss” para processar cada tema.
Esse arquivo é transformado embrasilgovtemas-[hash].cssapós processamento.Na pastafaviconsdentro do tema possui arquivos de configuração relacionados ao favicon para algumas plataformas.
Estes arquivos foram criados um para cada tema pois precisam ser alterados em cada tema.Existem ainda os arquivosmanifest.cfgepreview.pngque são únicos para cada tema, e são necessários pelo Diazo.Cada tema ainda possui uma pasta “sprite”, onde são adicionados os ícones utilizados no tema.
Esses ícones são processados gerando os arquivos_sprite.scsseimg/sprite.pngno tema.
O primeiro arquivo cria mixins utilizados no tema para facilitar a inserção de regras do sprite,
e o segundo arquivo é o sprite propriamente dito, que junta todas as imagens existens na pasta “sprite”.Foi adicionado um plugin para remover os arquivos antigos gerados com hash, para não acumular arquivos CSS e JS na pasta.Este pacote adiciona os seguintes comandos na pasta bin do buildout para processar automaticamente os recursos estáticos:$bin/env-brasilgovtemasEste 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-brasilgovtemasEste 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-brasilgovtemasEste 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-brasilgovtemasEste comando cria o CSS minificado, mas não espera por mudanças.Links de línguas no topo (Internacionalização)Hoje nos arquivos CSS existem regras para mostrar links de línguas,
como as classeslanguage-enelanguage-es.
Para adicionar links dessas línguas sem precisar customizar o tema,
adicione emsite_actionsactions com esse mesmo id e as regras do Diazo pegarão os links renderizados das actions posicionando corretamente na lista de línguas no tema.Fazendo releases com o zest.releaserOs recursos estáticos do pacote são gerados usando owebpacke não são inclusos no VCS.
Se você está fazendo release usando o zest.releaser, você precisa fazerupload manual dos arquivos no PyPIou você vai criar uma distribuição quebrada:executelongtest, como de costumeexecutefullrelease, como de costume, respondendo “não” a pergunta “Check out the tag?” para evitar o upload ao PyPIfaça checkout na tag do release que você está liberandoexecutebin/build-brasilgovtemaspara criar os recursos estáticoscrie os arquivos da distribuição usandopython setup.py sdist bdist_wheel, como de costumefaça o upload manual dos arquivos usandotwine upload dist/*Em caso de erro você terá que criar um novo release pois o PyPI Warehousenão permite reutilizar um nome de arquivo.ContribuidoresObrasil.gov.temasnão seria possível sem a contribuição das
seguintes pessoas:André NogueiraCarlos VieiraDanilo BarbatoÉrico AndreiHéctor VelardeIgor PradoFelipe DuardoRennan RodriguesRodrigo Ferreira de SouzaTânia AndreaPara comunicar problemas e sugerir melhorias,abra um ticket no repositório deste pacote.Changelog2.0.3 (2019-02-22)Corrige sobreposição do texto no tile de destaque no topo no responsivo.
[agnogueira]Exibe corretamente o valor do atributo “data-base-url” da tag Body.
[agnogueira]2.0.2 (2018-12-28)Corrige resultado de busca no responsivo.
[agnogueira]Corrige topo expansível no responsivo.
[agnogueira]Corrige posts do liveblog no responsivo.
[agnogueira]Ajustes de fontes no header e tiles.
[agnogueira]Alterar margens das linhas da capa.
[agnogueira]Corrige posicionamento do Em Alta (header expansível).
[agnogueira]2.0.1 (2018-12-07)Reposiciona link que impedia clique na aba de trocar senha.
[agnogueira]Correção de estilos do responsivo
[agnogueira]Corrige link para permitir que o video do liveblog seja iniciado.
[rodfersou, agnogueira]2.0 (2018-12-04)Usa API do YouTube para controlar video no topo do liveblog.
[rodfersou]Estilos para o tile de coleção.
[agnogueira]Estilos para vídeo de fundo na busca do header expansivel.
[agnogueira]Ajustes diversos no responsivo dos títulos dos tiles.
[agnogueira]2.0rc1 (2018-11-23)Corrige erro de posicionamento do Destaque Topo causado pelas alterações de posicionamento do Social Like.
[agnogueira]Ajustes diversos no responsivo do tema (tiles e menu).
[agnogueira]Ajustes de layout no liveblog.
[agnogueira]2.0b5 (2018-10-17)Limita movimentação dos ícones de redes sociais para não invadir o rodapé do site.
[rodfersou]Corrige inserção dos links do portal actions.
[rodfersou]Atualiza configuração do webpack.
[rodfersou]Corrige inserção de viewlet de redes para permitir internacionalização.
[rodfersou]Move link para voltar para o topo em um viewlet no brasil.gov.portal para permitir internacionalização.
[rodfersou]Corrige cabeçalho expandido (fecha#543).
[rodfersou, agnogueira]Move texto da licença de uso para um viewlet no brasil.gov.portal para permitir internacionalização.
[rodfersou]Corrige posição dos botões de compartilhamento da notícia.
[agnogueira, rodfersou]2.0b4 (2018-10-05)Alteração na largura do menu.
[agnogueira, rodfersou]Corrige altura da linha de destaque no topo.
[agnogueira, rodfersou]2.0b3 (2018-09-28)Adiciona estilo para controlar degrade do destaque topo.
[agnogueira]Altera a cor de fundo básica dos temas.
[agnogueira]Adiciona estilos para permitir uma imagem de fundo para o topo de uma capa.
[agnogueira]Corrige icone do estilo tile vinculado.
[agnogueira]Evita a emissão de source maps dos recursos estáticos.
[hvelarde]2.0b2 (2018-09-04)WarningEste release atualiza as dependências do processamento de recursos estáticos.
Em ambiente de desenvolvimento pode ser necessário remover as pastaspartsewebpack/node_modulespara efetivar a atualização de ambiente.Estilos iniciais para permitir a utilização de uma capa com fundo colorido.
Para que o estilo funcione, o usuário deve criar um modelo de capa com o nome “Capa fundo destacado”.
[agnogueira]Corrige largura do tile de navegação.
[agnogueira]Corrige largura na tela de configuração (fecha#211).
[agnogueira]Atualiza versões doNode.jse sc.recipe.staticresources.
[rodfersou]Altera a cor do header de noticias no tema padrão.
[agnogueira]Correção de estilos para o funcionamento do share dos tiles
[agnogueira]Novas variações de tamanho para a foto sobreposta
[agnogueira]Novo título grande para notícias destacadas
[agnogueira]Deixa skip links visíveis quando acessados via teclado.
[agnogueira]Adiciona retorno visual para a navegação via teclado.
[agnogueira]2.0b1 (2018-08-31)Adiciona visäo de Filtro de resultados.
[rodfersou]Adiciona visão de Central de conteúdo.
[rodfersou]Novos estilos para a variação do header
[agnogueira]Adiciona novo tema branco.
[agnogueira, rodfersou]Corrige SCSS para que o tema funcione a partir de variáveis.
[agnogueira, rodfersou]Novos estilos para os tiles
[agnogueira]Adiciona template adicional ao diazo para variação do header
[agnogueira]Remove duplicidade de ID nos icones de redes sociais
[agnogueira]Utiliza logos do rodapé a partir da barra
[agnogueira]Adiciona novas variações da fonte principal.
[agnogueira]Revisão geral de fontes no header, footer, conteúdo e tiles.
[agnogueira]Altera a largura geral do Portal.
[agnogueira]Novo estilo para as tags.
[agnogueira]Ajustes visuais para as visões de coleção e filtro.
[agnogueira]Altera o ícone de contraste.
[agnogueira]Corrige o texto da licença do site e exibe em todas as páginas (ref.#190).
[hvelarde, agnogueira]Corrige a exibição dos scripts para suporte a estatísticas web (fecha#188).
[agnogueira]2.0a6 (2018-07-06)Ajusta a largura da página, cor de fundo e fontes.
[agnogueira]Revisa as fontes do topo do portal.
[agnogueira]Revisa estilos para brasil.gov.agenda.
[agnogueira]2.0a5 (2018-06-06)Revisa view de Galleria de Fotos.
[rodfersou]Revisão dos estilos para o topo do portal.
[agnogueira]Criação de estilos para os tiles do portal
[agnogueira]Criação de estilos para os tiles destacados no topo do portal
[agnogueira]Adiciona comportamento Flex por padrao aos tiles
[agnogueira]Variação na cor do header para seções específicas
[agnogueira]Evolução de estilos para o responsivo
[agnogueira]Variações visuais para linhas e colunas
[agnogueira]Estilos gerais para texto em notícias e páginas
[agnogueira]2.0a4 (2018-02-08)Corrige o path padrão do tema para não iniciar com “/”.
[rodfersou]Não esconde o titulo do portal para dispositivos móveis.
[rodfersou]2.0a3 (2018-01-11)Corrige release quebrado.
[hvelarde]2.0a2 (2018-01-11)Ajustes do responsivo.
[agnogueira]Ajusta a busca.
[rodfersou, agnogueira]Adiciona favicon.
[rodfersou]Corrige funcionamento do contraste.
[rodfersou, agnogueira]Formatação básica dos conteúdos.
[agnogueira]Adiciona icones de redes sociais no topo e no rodapé.
[agnogueira]Adiciona estilos para os tiles.
[agnogueira]Corrige título e logo do portal.
[agnogueira]2.0a1 (2017-12-27)Release inicial.
[agnogueira, rodfersou, hvelarde]