You'll need Ruby and the Bundler gem installed on your machine. As our site is hosted on GitHub pages, you are required to procure the same dependency versions they ship. We suggest using the rbenv version manager.
# install the Ruby version manager
brew install rbenv ruby-build
rbenv install $(cat .ruby-version)
# set the local Ruby version
rbenv local $(cat .ruby-version)
# install the package manager
gem install bundler
- Clone this repo, or download it into a directory of your choice.
- Inside the directory, run
bundle install
. It will fetch Jekyll and its dependencies.
Compatibility issues with your platform? Fear not! Just run bundle lock --add-platform <platform>
.
To get the server running:
bundle exec jekyll serve [--livereload]
# in alternative
jekyll serve [--livereload]
It will take care of livereloading and Sass compiling. If you need more info, please see the Jekyll docs.
When you push to master
, Github Pages will take care of building the website and deploying it at http://speckand.tech.
How to use the website to expose content. If you are an editor this is the section for you.
For a matter of simplicity, when the hero is in loading
mode several fields are not shown even if they have a value.
The hero is managed by editing _data/homepage-event.json
.
The most important field is type
. Is used to set the mode of the hero.
You can use two types of type
:
event
: During regular events when we have all necessary dataloading
: Before a new event
We are near event 42 and we need to display all the information on the homepage.
Set the type
field to event
.
Fill in all the other necessary fields. Remember that if a field has a value it will be visible.
Event 64 has finished, we need to remove the details from the homepage.
You need to change type
from event
to loading
and empty the ticket-url
field if filled.
We don't have details for the event but we want to publish the tickets page.
Once you have the link to the tickets page set the ticket-url
field.
Example: "ticket-url": "//bit.ly/ST-64"
.