Static Pages and Blog

The fulcrum.org project maintains static, informational web pages and a blog to promote the project to new users and clients. To manage these pages and the blog easily inside our rails application, we use Jekyll static site generator to build the static pages. While Jekyll is very well documented, in order to make Jekyll to work inside a rails application like Heliotrope, we've made a few changes to the standard Jekyll setup. The documentation below discusses our customization of Jekyll, specifically where things live, how to make changes to the static web pages of fulcrum.org, and how the static pages get built on deployment to staging, preview, or production.

Where things live

.
├── Gemfile             # uses 'jekyll' gem
├── config
│   └── jekyll.yml      # configuration file for jekyll
├── fulcrum             # the source for static pages, make changes here
│   ├── _posts          # where blog posts go, authored in markdown
│   │   └── 2016-06-30-year-one-report.markdown # a blog post!
├── lib
│   ├── tasks
│   │   └── jekyll.rake # run be rake jekyll:build to auto regenerate site while working
├── public              # the destination, where jekyll builds the static pages

Updating static pages

Adding a blog post

Static page deployment