Theme setup
25th December 2020
Getting started with Jekyll + alternate
alternate was designed as a portfolio theme for alternatyves, but you can use this theme to start a regular Jekyll blog and tweak it any way you like.
Setup
- Install Jekyll
- Add your site and author details in
_config.yml. - Get a workflow going to see your site’s output with Jekyll locally using Jekyll commands or Gulp.
Supply was built with Jekyll version 4.0.0, and should support newer versions as well.
Install the dependencies with Bundler:
$ bundle install
Run jekyll commands through Bundler to ensure you’re using the right versions:
$ bundle exec jekyll serve
Config
Add your custom configuration in the _config file.
Navigation
Exposed as a data file to give clients better access Set in the Data / Navigation section, look for navigation.yml in _data.
Footer
Look for footer.html in _includes to add your footer links.
Develop
Tachyons
You can change the site styling using Tachyons, look for sup-theme in the src folder.
Please refer to Tachyons documentation, you can also start with https://github.com/dwyl/learn-tachyons
Gulp commands with browser reload
In the terminal, simply run
gulp build
to build your site concatenate your css (in asset -> css)
Use
gulp watch
This command builds the site locally on port 3000, with Browsersync so you can quickly revise design changes.
Preview your site with browser reload at: localhost:3000 Use the address localhost:3001 for additional help like grid preview, css highlight and more during development.
Editing
Posts
- Add, update or remove a post in the Posts collection.
- Change the defaults when new posts are created in
_posts/_defaults.md.
Collections
Read about collections in the Jekyll documentation.