Colaboradados

Colaboradados

THE COLLABORATIVE VEHICLE ABOUT TRANSPARENCY AND OPEN DATA IN BRAZIL.

This repository contains our website and collaborative database that you can access here.


Stack

  • Ruby: a necessary programming language for Jekyll.
  • Jekyll: static pages generator.
  • SCSS: for styling.

Table of Contents


Installing

Docker

You can use Docker to avoid installing Ruby and Jekyll in your machine and to build the server really fast.

Pre-requisites:

Running the project

sudo docker-compose up

Windows

Installing

Pre-requisites:

Install all of them as specified in their pages, open GitBash and run the following command:

gem install jekyll bundler

Running the project

  1. Fork the repository
  2. Use GitBash to clone it with the following command:
    $ git clone https://github.com/<seu_usuario>/colaboradados.github.io.git
    
  3. Navigate to the project folder using the command line
  4. Using GitBash, run
    $ bundle install
    

    and

    $ bundle exec jekyll serve
    
  5. Open http://localhost:4000/ in your browser. You’ll see the website running in your machine.

Linux Debian-based

Installing

Pre-requisites:

  1. Open a new terminal window and run
    $ sudo apt-get update
    
  2. Then, install the Ruby packages with
    $ sudo apt-get install ruby-full build-essential zlib1g-dev
    
  3. Install RubyGems with
    sudo apt install rubygems
    
  4. After that, run
    $ gem install jekyll bundler
    

Running the project

  1. Fork the repository
  2. Use the terminal to clone it with the following command:
    $ git clone https://github.com/<seu_usuario>/colaboradados.github.io.git
    
  3. Navigate to the project folder using the command line
  4. Using the terminal, run
    $ bundle install
    

    and

    $ bundle exec jekyll serve
    
  5. Open http://localhost:4000/ in your browser. You’ll see the website running in your machine.

Mac

Installing

Just run

$ gem install --user-install bundler jekyll

Running the project

  1. Fork the repository
  2. Use the terminal to clone it with the following command:
    $ git clone https://github.com/<seu_usuario>/colaboradados.github.io.git
    
  3. Navigate to the project folder using the command line
  4. Using the terminal, run
    $ bundle install
    

    and

    $ bundle exec jekyll serve
    
  5. Open http://localhost:4000/ in your browser. You’ll see the website running in your machine.

Search Indexing on Algolia

In order to correctly load the search index you have to define these variables on _config.yml:

algolia:
  application_id: GVM6HECTJP
  index_name: colaboradados
  search_only_api_key: rvtp4mqkxaeqyf9d6wkj52xj9lahmjg4

Then run:

$ ALGOLIA_API_KEY='<password>' bundle exec jekyll algolia

Contributing with the database

Colaboradados is a community driven and non-profit organization. In order to collaborate with the database you’ll have to go inside colaboradados.github.io/_posts and choose whatever file you want to add your contribution. All the files are in Markdown format and you may use wichever text editor you prefer. The files must be edited using the same pattern for lists, titles and alphabetical order, this will make the work more concise and helps the @colabora_bot functioning. If you have questions, feel free to contact us.


Credits

This project was developed by Judite Cypreste, with great help from Jessica Temporal, João Ernane and Miriam Retka.

The website was developed using HTML5 UP’s design and the Jekyll integration was made by Andrew Banchich.


The MIT License (MIT)

Copyright (c) 2019 Judite Cypreste

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.