Metadata-Version: 2.0
Name: brasil.gov.portlets
Version: 1.0rc2
Summary: Portlets para Portal PadrÄĹo
Home-page: https://github.com/plonegovbr/brasil.gov.portlets
Author: PloneGovBr
Author-email: gov@plone.org.br
License: GPLv2
Keywords: plonegovbr portlets brasil plone
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Products.CMFPlone (>=4.3)
Requires-Dist: Products.CMFQuickInstallerTool
Requires-Dist: Products.GenericSetup
Requires-Dist: brasil.gov.portal
Requires-Dist: brasil.gov.tiles
Requires-Dist: five.pt
Requires-Dist: lxml
Requires-Dist: plone.api
Requires-Dist: plone.app.dexterity
Requires-Dist: plone.app.portlets
Requires-Dist: plone.app.upgrade
Requires-Dist: plone.memoize
Requires-Dist: plone.portlets
Requires-Dist: sc.embedder
Requires-Dist: setuptools
Requires-Dist: zope.component
Requires-Dist: zope.i18nmessageid
Requires-Dist: zope.interface
Requires-Dist: zope.schema
Provides-Extra: test
Requires-Dist: plone.app.contenttypes (<1.1a1); extra == 'test'
Requires-Dist: plone.app.robotframework; extra == 'test'
Requires-Dist: plone.app.testing[robot] (>=4.2.2); extra == 'test'
Requires-Dist: plone.browserlayer; extra == 'test'
Requires-Dist: plone.namedfile; extra == 'test'
Requires-Dist: plone.testing; extra == 'test'
Requires-Dist: robotsuite; extra == 'test'

***************************************************************
.gov.br: Pacote de Portlets
***************************************************************

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

Introdução
==========

Este pacote provê a instalação de produto com pacote de portlets multimídia seguindo padrão de estilização do Portal Padrão.

Requisitos
==========

Este pacote foi desenvolvido especificadamente para o Portal Padrão, dessa forma, para uso sem erros de funcionalidades e estilização é indicado que seja utilizado como complemento ao Portal Padrão.


Estado deste pacote
===================

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

O estado atual dos testes pode ser visto nas imagens a seguir:

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

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

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

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.portlets`` à lista de eggs da instalação::

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

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 instale o produto
**brasil.gov.portlets: Instalação do Pacote**.

Rodando o buildout de uma tag antiga do pacote
----------------------------------------------

Para atender ao relato de ter vários jobs de integração contínua em pacotes brasil.gov.* (ver https://github.com/plonegovbr/portalpadrao.release/issues/11), no fim da seção extends do buildout.cfg de todos os pacotes brasil.gov.* temos a seguinte linha:

.. code-block:: cfg

    https://raw.githubusercontent.com/plonegovbr/portal.buildout/master/buildout.d/versions.cfg

Hoje, esse arquivo contém sempre as versões pinadas de um release a ser lançado. Por esse motivo, quando é feito o checkout de uma tag mais antiga provavelmente você não conseguirá rodar o buildout. Dessa forma, após fazer o checkout de uma tag antiga, recomendamos que adicione, na última linha do extends, o arquivo de versões do IDG compatível com aquela tag, presente no repositório https://github.com/plonegovbr/portalpadrao.release/.

Exemplo: você clonou o repositório do brasil.gov.portal na sua máquina, e deu checkout na tag 1.0.5. Ao editar o buildout.cfg, ficaria dessa forma, já com a última linha adicionada:

.. code-block:: cfg

    extends =
        https://raw.github.com/collective/buildout.plonetest/master/test-4.3.x.cfg
        https://raw.github.com/collective/buildout.plonetest/master/qa.cfg
        http://downloads.plone.org.br/release/1.0.4/versions.cfg
        https://raw.githubusercontent.com/plonegovbr/portal.buildout/master/buildout.d/versions.cfg
        https://raw.githubusercontent.com/plone/plone.app.robotframework/master/versions.cfg
        https://raw.githubusercontent.com/plonegovbr/portalpadrao.release/master/1.0.5/versions.cfg

Para saber qual arquivo de versões é compatível, no caso do brasil.gov.portal, é simples pois é a mesma versão (no máximo um bug fix, por exemplo, brasil.gov.portal é 1.1.3 e o arquivo de versão é 1.1.3.1). Para os demais pacotes, recomendamos comparar a data da tag do pacote e a data nos changelog entre uma versão e outra para adivinhar a versão compatível.

Contributors
============

* Rodrigo Ferreira de Souza (rodfersou)
* Felipe Duardo (felipeduardo)
* Danilo Barbato (dbarbato)
* Héctor Velarde (hvelarde)

Changelog
=========

1.0rc2 (2016-11-07)
-------------------

- Não registra novamente os javascrips inclusos no brasil.gov.tiles (closes `#287`_).
  [claytonc]
- Exibe somente conteúdos com imagens no portlet de carrossel de imagens (closes `#8`_).
  [idgserpro]


1.0rc1 (2016-06-09)
-------------------

- A lista de dependências do pacote foi atualizada.
  [hvelarde]

- Adiciona tradução em inglês para o nome dos portlets. [idgserpro]


1.0b1 (2014-12-05)
------------------

- Versão inicial.

.. _`#8`: https://github.com/plonegovbr/brasil.gov.portlets/issues/8
.. _`#287`: https://github.com/plonegovbr/brasil.gov.portal/issues/287


