Blinktrade Bitcoin Exchange

Technologies we are using

• jekyll, a static generator in Ruby, to create the static html pages
• google closure library for the javascript application
• google closure templates for some of the javascript ui views

Install the pre-requesites

1 - Install Git, Ruby anda Java, in case you don't have them yet.

2 - Once installed these dependecies, open up the terminal and install Jekyll with the following commands.

$ gem install jekyll

2 - Install jekyll multiple languages plugin

$ gem install jekyll-multiple-languages-plugin

How to run the exchange on github pages

1 - Fork the repo

2 - Rename it to exchange or any name you wish. Let's use exchange for this example

3 - clone your new repo

$ git clone https://github.com/yourgithubusername/exchange
$ cd exchange

4 - Create a github page for your repo $ git checkout --orphan gh-pages

5 - Setup your gh-pages repo

$ git rm -rf .
$ touch .nojekyll
$ git add .nojekyll 
$ git commit -am "created gh-pages build" 
$ git push origin gh-pages
# After the first push, it can take up to 15 minutes before your GitHub Pages site is available. 
# You'll receive an email if your build is unsuccessful.

6 - Build the exchange.

$ git checkout master 
$ ln -s _config.demo.yml  _config.yml
$ ./build_javascript.sh # Only needed in case you changed the ./jsdev application
$ ./deploy.sh gh-pages ""
$ git push

8 - Open your browser and point it to http://yourgithubusername.github.io/exchange/

How to run the exchange locally

1 - Fork the repo

2 - Rename it to exchange or any name you wish. Let's use exchange for this example

3 - clone your new repo

$ git clone https://github.com/yourgithubusername/exchange
$ cd exchange

4 - And finally run:

$ jekyll server --watch

You'll have access to the website at localhost:4000 :D

Browser Support

| | | | --- | --- | --- | --- | --- | IE 11+ ✔ | Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ |

How build the javascript application

The defaults are US english (en_US) and the default theme ('default'), but can be overriden. To build the british english version with a custom theme:

$ cd ./jsdev 
$ LANG=en_GB THEME=custom sh build_release.sh

File Structure

The file structure for the project is organized in the following way:

.
|-- _includes
|-- _layouts
|-- _posts
|-- _config.yml
|-- jsdev
  |-- bitex
  |-- closure-bootstrap
  |-- closure-library
  |-- externs
  |-- scottlogic/chart
  |-- tools
  |-- translations
  |-- uniform
  |-- build_release.sh
|-- themes
  |-- default
  |-- ander
|-- assets
|-- index.html

_includes

They're blocks of code used to generate the main page of the site (index.html).

_layouts

Here you'll find the default template of the application.

_posts

Here you'll find a list of files for each post.

_config.yml

It stores most of the settings of the application.

index.html

The static html page

jsdev

The google closure javascript application

assets

Images, CSS, Compiled Javascripts, Fonts and all static content.

License

GNU GENERAL PUBLIC LICENSE © Blinktrade, Inc.