Simple polling site writen in Ruby, using Sinatra.
First of all, one need the Ruby programming language installed. One can install this from the official Ruby Website or one'll most likely have it available through one's main package manager.
One need to use Ruby Gems to install Bundler, gems should come with one's installation of Ruby. In one's terminal, type:
gem install bundler
Make sure one adds the .gem bin/ path to one's $PATH
variable in one's main shell.
e.g. in one's ~/.bashrc
add
export PATH="$(ruby -r rubygems -e 'puts Gem.user_dir')/bin:$PATH"
Then restart one's shell session, by typing bash
or whatever shell one uses.
One needs to make sure one has eventmachine
installed, for the thin
server to work.
One does this by running:
gem install eventmachine
If one gets errors about failing to build native extensions, read up in libraries needed to build (g , gcc, musl-dev, make libstdc , etc). Read about it here https://github.com/eventmachine/eventmachine/wiki/Building-EventMachine.
Now one clones this repo, or fork it, depending on whether one wants to simply run the server, or contribute to the site, respectively. Either simply type:
git clone https://github.com/Demonstrandum/Veto.git
in one's shell to clone it, or fork it by pressing the fork button on this webpage, then clone that fork instead, for which one can later submit a pull request. One now wants to enter this directory, one does this by simply typing:
cd Veto
After this, one would want to install the gems from the Gemfile
file, this one does by running:
bundle install
whilst in the root directory of this repo.
One should now be ready to run the server locally! Whilst in the Veto/ directory, kindly type:
bundle exec ruby server.rb
One should see Sinatra take the stage with backup from Thin, (their words). If not, and one's getting issues with eventmachine
and/or trouble finding the Thin server, please revisit the steps above concerning eventmachine
installation.
Otherwise, one should be fine, now one can access localhost:8080, and one can make any changes locally. One only needs to restart the server if one has made changes to the server.rb
file, otherwise any changes to any other .erb, .js, .css files, etc. should not require a restart.
Someone help me make it look pretty. I'm too lazy to write heaps of CSS again