Metadata-Version: 2.1
Name: brasil.gov.tiles
Version: 2.0
Summary: Tiles para o Portal Padrão do Governo Federal
Home-page: https://github.com/plonegovbr/brasil.gov.tiles
Author: PloneGov.BR
Author-email: gov@plone.org.br
License: GPLv2
Keywords: plone tiles brasil gov
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Multimedia
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Acquisition
Requires-Dist: collective.cover
Requires-Dist: collective.nitf
Requires-Dist: collective.polls
Requires-Dist: plone.api
Requires-Dist: plone.app.uuid
Requires-Dist: plone.autoform
Requires-Dist: plone.memoize
Requires-Dist: plone.namedfile
Requires-Dist: plone.registry
Requires-Dist: plone.tiles
Requires-Dist: plone.app.imagecropping (<2.0b1)
Requires-Dist: Products.CMFPlone (>=4.3)
Requires-Dist: Products.CMFQuickInstallerTool
Requires-Dist: Products.GenericSetup
Requires-Dist: sc.embedder
Requires-Dist: setuptools
Requires-Dist: six
Requires-Dist: zope.component
Requires-Dist: zope.i18nmessageid
Requires-Dist: zope.interface
Requires-Dist: zope.schema
Provides-Extra: test
Requires-Dist: collective.cover[test] ; extra == 'test'
Requires-Dist: mock ; extra == 'test'
Requires-Dist: plone.api ; extra == 'test'
Requires-Dist: plone.app.referenceablebehavior ; extra == 'test'
Requires-Dist: plone.app.robotframework ; extra == 'test'
Requires-Dist: plone.app.testing[robot] ; extra == 'test'
Requires-Dist: plone.browserlayer ; extra == 'test'
Requires-Dist: plone.testing ; extra == 'test'
Requires-Dist: robotsuite ; extra == 'test'

***************************
.gov.br: Blocos de Conteúdo
***************************

.. contents:: Conteúdo
   :depth: 2

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:

.. image:: http://img.shields.io/pypi/v/brasil.gov.tiles.svg
    :target: https://pypi.python.org/pypi/brasil.gov.tiles

.. image:: https://img.shields.io/travis/plonegovbr/brasil.gov.tiles/master.svg
    :target: http://travis-ci.org/plonegovbr/brasil.gov.tiles

.. image:: https://img.shields.io/coveralls/plonegovbr/brasil.gov.tiles/master.svg
    :target: https://coveralls.io/r/plonegovbr/brasil.gov.tiles

.. image:: https://img.shields.io/codacy/grade/5a403e23e61d49d195fcb640d1566a89.svg
    :target: https://www.codacy.com/project/plonegovbr/brasil.gov.tiles/dashboard

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:

.. code-block:: ini

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

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/quote.png
    :align: center
    :height: 250px
    :width: 530px

Foto do Dia
^^^^^^^^^^^
Mostra uma foto excepcional selecionada diariamente.

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/potd.png
    :align: center
    :height: 577px
    :width: 867px

Galeria de fotos
^^^^^^^^^^^^^^^^
Mostra uma galeria de fotos.

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/photogallery.png
    :align: center
    :height: 533px
    :width: 800px

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

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/navigation.png
    :align: center
    :height: 100px
    :width: 800px


Carrossel de vídeos
^^^^^^^^^^^^^^^^^^^
Mostra um carrossel de vídeos.

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/videocarousel.png
    :align: center
    :height: 367px
    :width: 1253px

Carrossel de grupo
^^^^^^^^^^^^^^^^^^
Mostra um carrossel de itens com imagens.

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/groupcarousel.png
    :align: center
    :height: 393px
    :width: 800px

Carrossel de destaques
^^^^^^^^^^^^^^^^^^^^^^
Mostra um carrossel de imagens em destaques.

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/highlightscarousel.png
    :align: center
    :height: 550px
    :width: 1000px

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.

.. figure:: https://raw.github.com/plonegovbr/brasil.gov.tiles/master/docs/tileshare.png
    :align: center
    :height: 713px
    :width: 1092px

Desenvolvimento
---------------

Utilizamos `webpack <https://webpack.js.org/>`_ 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 <https://github.com/simplesconsultoria/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:

.. code-block:: console

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

.. code-block:: console

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

.. code-block:: console

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

.. code-block:: console

    $ 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 <https://webpack.js.org/>`_ 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 <https://github.com/zestsoftware/zest.releaser/issues/261>`_ 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 <https://upload.pypi.org/help/#file-name-reuse>`_.

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.0 (2020-03-13)
^^^^^^^^^^^^^^^^

- Remove atributo uuids (customizado) dos tiles audiogallery e videogallery.
  (`#274 <https://github.com/plonegovbr/brasil.gov.tiles/issues/274>`)
  [idgserpro]

- Adiciona requirements.txt e atualiza .travis.yml.
  [idgserpro]

- Corrige problema ao popular galeria de audio e video (fecha `#267 <https://github.com/plonegovbr/brasil.gov.tiles/issues/267>`_ `#268 <https://github.com/plonegovbr/brasil.gov.tiles/issues/268>`_).
  [rodfersou]


2.0rc1 (2018-11-23)
^^^^^^^^^^^^^^^^^^^

- Remove registro de recursos estaticos dos resource registries;
  agora utilizamos um viewlet para incluir eles simplificando a manutenção do complemento.
  [rodfersou]

- Atualiza configuração do webpack.
  [rodfersou]

- Remove override do tile de Coleção do collective.cover.
  [hvelarde, rodfersou]

- Remove override do tile Lista do collective.cover.
  [hvelarde, claytonc, rodfersou]


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 <https://github.com/plonegovbr/brasil.gov.tiles/issues/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 <https://nodejs.org/>`_ 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 <https://github.com/plonegovbr/brasil.gov.tiles/issues/255>`_).
  [hvelarde]

- Evita ``TypeError`` no tile de Citação (fecha `#254 <https://github.com/plonegovbr/brasil.gov.tiles/issues/254>`_).
  [hvelarde]

- Evita tipos de conteúdo duplicados no configlet do collective.cover (fecha `#252 <https://github.com/plonegovbr/brasil.gov.tiles/issues/252>`_).
  [hvelarde]

- Evita o erro ``WrongContainedType`` ao rodar o upgrade step da versão 4100 (fecha `#249 <https://github.com/plonegovbr/brasil.gov.tiles/issues/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 <https://pypi.python.org/pypi/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]


