Skip to content

Latest commit

 

History

History
75 lines (42 loc) · 3.37 KB

INSTALL.md

File metadata and controls

75 lines (42 loc) · 3.37 KB
Raw

Instalando en local

Para instalar la aplicación en local es necesario seguir los siguientes pasos:

  • Instalar los componentes utilizados por la aplicación. Actualmente, la aplicación requiere coffin 0.4.0, así como django 1.4.2:

      $ pip install -r requirements.txt
    • Incompatibilidad con otras versiones de coffin y django:
      • En coffin > 0.4.0 desaparece coffin.common.env.
      • En django > 1.6 desaparece el argumento deprecado mimetype.
      • En django > = 1.5 desaparece django.views.generic.simple.
      • En django < 1.4.2 no se ha incorporado aún la compatibilidad con django.utils.six.

  • Borrar base de datos:

      $ dropdb -h localhost presupuestos

  • Crear la base de datos:

      $ createdb -h localhost presupuestos

  • Copiar local_settings.py-example a local_settings.py y modificar las credenciales de la base de datos.

  • Crear el esquema de la base de datos y cargar los datos básicos:

      $ python manage.py syncdb

  $ python manage.py load_glossary
  $ python manage.py load_entities
  $ python manage.py load_stats
  $ python manage.py load_budget 2014

  • Cargar los datos de al menos un par de comarcas:

      $ python manage.py load_budget_data comarca 2014Q1

  • Arrancar el servidor

      $ python manage.py runserver

Para más información, consulta la [documentación técnica del proyecto](docs/Documentación Técnica.pdf).

Configurando el buscador

Por defecto la aplicación usa el método estándar de búsqueda de texto de Postgres. Es posible crear métodos de búsqueda adaptados a un idioma concreto, de forma que -por ejemplo- Postgres ignore los acentos a la hora de buscar resultados. Si deseamos configurar la búsqueda para funcionar en español, creamos primero una nueva configuración de búsqueda, como se explica en la documentación de Postgres:

$ psql presupuestos_dev

> CREATE EXTENSION unaccent;

> CREATE TEXT SEARCH CONFIGURATION unaccent_spa ( COPY = pg_catalog.spanish );

> ALTER TEXT SEARCH CONFIGURATION unaccent_spa
    ALTER MAPPING FOR hword, hword_part, word
    WITH unaccent, spanish_stem;

Mientras hacemos pruebas en psql podemos configurar el método de búsqueda por defecto:

> SET default_text_search_config = 'unaccent_spa';

Pero para usarlo de manera regular debemos configurar la aplicación, vía local_settings.py:

'SEARCH_CONFIG': 'unaccent_spa'

Adaptando el aspecto visual

La aplicación soporta el concepto de 'themes' capaces de modificar el aspecto visual de la web: tanto recursos estáticos (imágenes, hojas de estilo...) como las plantillas que generan el contenido de la web. El repositorio presupuesto-dvmi de Civio -una adaptación del software de Aragón Open Data a los Presupuestos Generales del Estado- es un buen ejemplo de cómo puede organizarse el contenido de un theme.

El theme a usar se configura mediante la variable THEME, que es referenciada en diversos puntos de settings.py para instalar los directorios del theme (plantillas y recursos estáticos) justo antes de los de la aplicación principal.