If you aren't familiar with Jekyll yet, you should know that it is a static site generator. It will transform your plain text into static websites and blogs. No more databases, slow loading websites, risk of being hacked...just your content. And not only that, with Jekyll you get free hosting with GitHub Pages! This page itself is free hosted on Github with the help of Jekyll and Affiliates template that you're currently previewing. If you are a beginner we recommend you start with Jekyll's Docs. Now if you know how to use Jekyll, let's move on to using Affiliates template in Jekyll:
Download or Fork the website.
- In your local project, open
_config.yml
. Set yourbaseurl
, your Google Analytics code, Disqus username, Authors, Mailchimp, ShareThis code (https://www.sharethis.com/) etc. - Affiliates requires 2 plugins:
$ gem install jekyll-paginate
$ gem install jekyll-archives
.- Edit the header & footer in
default.html
. Edit home inindex.html
. Edit the contact form incontact.html
(https://formspree.io/).
- Start blogging by adding your .md files in
_posts
. If you download the template you will notice it already has a few as an example. - YAML front matter
- post featured -
featured:true
- post featured image -
image: assets/images/mypic.jpg
- page comments -
comments:true
- meta description (optional) -
description: "this is my meta description"
- post featured -
YAML Post Example:
--- layout: post title: "We all wait for summer" author: john categories: [ Jekyll, tutorial ] image: assets/images/5.jpg featured: true ---
YAML Page Example
--- layout: page title: the blockchain book comments: true ---
- Clone the repo.
- Create a branch off of master and give it a meaningful name
- Open a pull request on GitHub and describe the feature or fix.