Skip to content

Technical Documentation

Bill McMillin edited this page Aug 27, 2015 · 3 revisions

About Jekyll

Jekyll is a Rails gem that generates static websites from markdown, HTML, and other formats. See the official Jekyll documentation for details.

We also recommend checking out the Jekyll cheat sheet's Tags and Filters page.


Using Jekyll

After following the instructions on the Home Page of the wiki, there are a few things you'll need to know to make updates:

Relative vs. absolute paths

When you clone the master branch for local development:

  • When editing on your local machine, you'll have to change the entry in "_data/path.yml" from '/2016.code4lib.org/' to '/'. Make sure your _data/path.yml file is in the .gitignore file and the only content in the path.yml file is: '/'.
  • When using absolute paths in your html, use "{{ site.data.path }}absolute/path/to/whatever"

Updating less variables for Bootstrap

Recompiling

Data for Speakers page

-Data is in the _data/speakers.yml file

Data for Schedule page

-Data is here

Additional Resources