You'll need Ruby installed on your system. macOS comes with Ruby pre-installed.
-
Install Jekyll and dependencies:
gem install bundler jekyll bundle install
-
Run Jekyll locally:
bundle exec jekyll serve -
Open your browser to: http://localhost:4000
To deploy to GitHub Pages:
- Go to your repository Settings > Pages
- Under "Source", select "Deploy from a branch"
- Choose your branch (usually
mainormaster) - Select
/(root) as the folder - Click Save
Your site will be available at: https://[username].github.io/reading-list/
_config.yml- Jekyll configuration_layouts/default.html- Page layout and styles_entries/- Individual book/author entriesindex.md- Main page that pulls from entriesheader.png- Header image
- Edit CSS in
_layouts/default.html - Modify entry display in
index.md - Add new entries to
_entries/folder