This is the GitHub repository for the Bokeh Project Blog, blog.bokeh.org. The blog is used for publishing release announcements, case studies, howtos, or other project news. The repository for the source code of Bokeh itself can be found at github.com/bokeh/bokeh.

Full docs for setting up a GitHub Pages Jekyll blog can be found here.

After installing docker, run make serve to build and run the website within the a container built from the jekyll/jekyll image that contains all the necessary prerequisites. The site will be available at http://localhost:4000. Modifying source files will cause the website to rebuild in real time (refresh the browser page to see changes).

To build manually, you will need to have Ruby>=2.1 installed on your system. If necessary, run

gem install bundler

The first time you build locally you will need to install necessary dependcies. In the top level direcotory of this repository, run:

bundle install

Then, to serve the site, run:

bundle exec jekyll serve --future

The site will be available at http://localhost:4000. While this program remains running, you can edit the source files and Jekyll will automatically rebuild the site (refresh the browser page to see changes).