Montreal.rb website

[![ZenHub] (https://raw.githubusercontent.com/ZenHubIO/support/master/zenhub-badge.png)] (https://zenhub.io)

Description

This is the Montreal.rb organization's website. It is still in development stage so you are welcome to contribute.

Requirements

Runtime

ruby 2.2.3
Postgresql 9.3+

Development Setup

Fork the repository and clone it to your machine. Then change directory to Montreal.rb

$ git clone <your_fork> && cd Montreal.rb

Ruby

You should have Ruby version 2.2.3 installed using your prefered Ruby version management tool (or by globally updating your system Ruby)

Most Popular Ruby Version Managers

rbenv
rvm

Database

Do you have Postgres installed?

$ postgres --version
Postgresql 9.3

For the next parts, you need Postgresql installed, configured and running and a .pgpass file in your home directory. The content of that file should look like:

# hostname:port:database:username:password
localhost:5432:*:sdeziel:myverysecurepassword

Install Postgres

$ brew install postgresql

Rails

You should check out Ruby on Rails' guides if you are not familiar with the framework : http://guides.rubyonrails.org/

Setup your Project

$ bin/setup

IMPORTANT: pg gem installation error

If you experience an error during the execution of that script related to the installation of the pg gem, you might want to try the following procedure:

$ sudo find / -name "pg_config"
# Use the most appropriate path found by the command above
$ gem install pg -- --with-pg-config=<your_pg_config_path>
$ bin/setup

Once successfully completed, this setup script will:

install bundler for managing your gem dependencies
install your project's required gems
create and setup your database
cleanup logs and temporary files

Start your Web Server

You should be ready to start your webserver using:

$ bin/rails server

By default, your application is accessible at http://localhost:3000 in your browser.

Testing

RSpec is used to test the application. You can run all the tests using

$ bin/rspec

or you can run a specific test file (example 1), or a single test (example 2, 17 is the line number of your test)

$ bin/rspec spec/path/to/your/file.rb    # example 1

$ bin/rspec spec/path/to/your/file.rb:17 # example 2

You can also use guard to test automatically when you save a file

$ bundle exec guard

PROTIP: install ctags and guard will automatically generate an index (or tag) file of language objects found in source files that allows these items to be quickly and easily located by a text editor.

ex: macos brew install ctags && sudo mv /usr/bin/ctags /usr/bin/ctags.bak
ex: ubuntu sudo apt-get install exuberant-ctags

Deploy

This application is automatically deployed to heroku after a successful Travis CI build of the master branch.

URLs

The heroku url is: https://montreal-rb.herokuapp.com/
The official url is: https://montrealrb.com/

Bug Tracker

If you find any bug, please open an issue in the project's Github repository (https://github.com/montrealrb/Montreal.rb/issues)

Contributing

Please see CONTRIBUTING.md.

Everyone interacting in Montrealrb.com and its sub-projects' codebases, issue trackers, chat rooms, and mailing lists is expected to follow our code of conduct.

License

montrealrb.com is released under the MIT License.

cawel/Montreal.rb