README.rst

   1 e-cidadania
   2 ===========
   3
   4 Current version: 0.1.5 RC1
   5
   6 e-cidadania is a project to develop an open source application for citizen participation, usable by associations, companies and administrations.
   7
   8 The e-cidadania objective is to maintain the platform as easy as possible while improving in the user interface to be easier to use as possible.
   9
  10 Installation
  11 ------------
  12
  13 To install e-cidadania follow these steps:
  14
  15 * Download the source code from git, or from the official webpage.
  16 * Copy the directory **src/** into your web root.
  17 * You need to install the python packages specified in requirements.txt for e-cidadania, you can do it with pip::
  18
  19     sudo pip install -r requirements.txt
  20
  21 * Configure setting.py to you desire.
  22 * Generate the database with::
  23
  24     python manage.py syncdb
  25
  26 * Copy all the static files::
  27
  28     python manage.py collectstatic
  29
  30 * Run the development server
  31
  32     python manage.py runserver
  33
  34 Demonstration
  35 -------------
  36
  37 There is a demo running in the website http://demo.ecidadania.org.
  38
  39 Development
  40 -----------
  41
  42 **We need developers! If you want to join us, send an email to oscar.carballal AT cidadania DOT coop**
  43
  44 Development and bugtracking is done through `code.ecidadania.org <http://code.ecidadania.org>`_
  45
  46 Getting help
  47 ------------
  48
  49  * `Documentation <http://code.ecidadania.org/wiki/Documentation>`_ e-cidadania documentation.
  50  * `Mailing lists <http://code.ecidadania.org/wiki/MailingLists>`_ global and local.
  51  * `Social networks <http://code.ecidadania.org/wiki/SocialNetworks>`_ where e-cidadania present.
  52  * `Website <http://ecidadania.org>`_ e-cidadania official website.
  53  * `IRC channels <http://webchat.freenode.net>`_ #ecidadania-dev and #ecidadania for e-cidadania.
  54
  55 Useful information
  56 ------------------
  57
  58  * `Design concepts <http://code.ecidadania.org/wiki/DesignConcepts>`_ design concepts, this are the guides to follow when developing.
  59  * `Releases <http://code.ecidadania.org/wiki/Releases>`_ version roadmap. This is where we stablish the features, release dates and other things of every version.
  60
  61 Collaborate
  62 -----------
  63
  64 * **Developing** You can take the last code from the repository and experiment with it. When you're done, you can send us a "Merge request".
  65
  66 * **Documenting** Right now the documentation is a bit insufficient. If you want to document e-cidadania, feel free to do it. We use Sphinx (1.1.3) to generate the documents.
  67
  68 * **Translating** e-cidadania achieves to be international. If you want to translate it to your language just follow the steps in the documentation an send your catalog to us, we will include it ASAP.
  69
  70 * **Bug reporting** You can report the bugs you find in the application in this trac: http://code.ecidadania.org