I'll be giving an intro to Jekyll from 1400-1600. This repo contains everything you need.
If you have it that's great, but if you don't Jekyll is a really really good way to learn!
All you need to know is how to get to a command line (the terminal on a Mac)! Don't worry if you don't know much about the command line.
If you'd like to follow along, install Jekyll and build the example site I've provided. (If you don't want to follow along that's cool too, you can just skip this):
Install Jekyll using the command line, with the instructions on this page. (Questions? Ping me on slack @astrid
!)
Go to the repo, click Clone or download
and copy the URL, then clone it locally on the command line or in the Github GUI. This will download all the working files you'll need.
After installing, go to your terminal and go to the repo folder.
For example, on my machine I keep all repos in a folder called GitHub
and I get to this repo like this:
$ cd ~/GitHub/ail_jekyll
Once you're in the folder, list the contents. Everything is in a folder called docs/
:
$ ls
README.md docs
Navigate to the docs folder:
$ cd docs/
Then, build and run the site:
$ bundle exec jekyll serve
When the site's ready these lines will print:
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.
Open a web browser, and go to the URL localhost:4000
. Voila!
As you make changes in a text editor and save them, Jekyll will automatically rebuild your site. Just refresh the page when it's finished to see your changes.