CARTOSET

Requirements.

The requirements you will need in order to run a Cartoset based project are:

• valid Ruby interpreter (versions 1.8.7 and 1.9.2 supported)
• rubygems
• git
• PostgreSQL 9.0
• A cartoDB account

If you are running linux you need to install some development libraries. The installation commands depend on the distro you're using, we provide them for ubuntu. You can also execute script/ubuntu_install.sh which installs all you need to run cartoset.

• libxml2-dev

• libxslt-dev

• libcurl4-gnutls-dev

  $ sudo apt-get install libxml2-dev libxslt-dev libcurl4-gnutls-dev
  

• install postgresql-9.0

  $ sudo apt-get install python-software-properties checkinstall
  $ sudo add-apt-repository ppa:pitti/postgresql
  $ sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable
  $ sudo apt-get update
  $ sudo apt-get install postgresql-9.0 postgresql-server-dev-9.0
  

Setting up a new Cartoset based project.

1. First of all, download the source code clicking in the 'Downloads' button, in the Cartoset github's repository.

2. Unzip the downloaded file into your desired folder, and then open a new terminal session. cd to the folder.

3. Install the bundler gem.

4. Install Ruby 1.9.2:

   $ cd cartoset $ rvm install 1.9.2 $ rvm use 1.9.2 $ rvm gemset create cartoset $ rvm use 1.9.2@cartoset $ gem install bundler $ bundle install

5. Start a new server session:

   $ rails server

6. Go to http://localhost:3000. It will redirect you to the setup wizard.

7. Go through the setup wizard. At some point you'll be asked to select a cartoDB table. This table must have the next columns:

   • title (string)
   • description (text)
   • the_geom (geometry - point type). This column is created by default in new empty tables in cartoDB.

8. When you finish the setup proccess, you will have your cartoset project configured!

9. Customize your cartoset project, adding some css styles and giving it some love!