***************************************************************
`.gov.br: Suporte a Busca Multifacetada`
***************************************************************
.. contents:: Conteúdo
:depth: 2
Introdução
-----------
Este pacote provê a instalação de produto para busca multifacetada, customização de visão sumária e widget de ordenação para o `Portal Padrão <http://portalpadrao.plone.org.br>`_.
Estado deste pacote
---------------------
O **brasil.gov.facetada** 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:: https://secure.travis-ci.org/plonegovbr/brasil.gov.facetada.png?branch=master
:target: http://travis-ci.org/plonegovbr/brasil.gov.facetada
.. image:: https://coveralls.io/repos/plonegovbr/brasil.gov.facetada/badge.png?branch=master
:target: https://coveralls.io/r/plonegovbr/brasil.gov.facetada
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.facetada`` à lista de eggs da instalação::
[buildout]
...
eggs =
brasil.gov.facetada
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
**.gov.br: Busca Multifacetada**.
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.
Colaboradores
---------------
* Danilo Barbato (dbarbato)
* Rodrigo Ferreira de Souza (rodfersou)
* Érico Andrei (ericof)
Alterações
-------------
1.0rc1 (2018-05-28)
^^^^^^^^^^^^^^^^^^^
- Traduz em pt_BR domínios eea e plone relacionados ao brasil.gov.facetada (fecha `#10 <https://github.com/plonegovbr/brasil.gov.facetada/issues/10>`_)
[idgserpro]
- Remove dependência no five.grok.
[claytonc]
- Corrige a classe ``ScaleImage`` que pegava a imagem duas vezes.
[claytonc]
1.0b1 (2016-11-30)
^^^^^^^^^^^^^^^^^^
- Pina eea.facetednavigation < 10 para evitar ``AttributeError`` (fecha `#6 <https://github.com/plonegovbr/brasil.gov.facetada/issues/6>`_)
[idgserpro]
1.0a1 (2014-11-01)
^^^^^^^^^^^^^^^^^^
- Versão inicial do pacote.
[dbarbato]