Kothing

This website is built with Jekyll and Kothing template for Jekyll. Kothing template for Jekyll is compatible with Github pages, in fact even this demo is created with Github Pages and hosted with Github.

Documentation

"Kothing" is a free Jekyll theme for blogging, collections, resources, reviews websites

Features

• Built for Jekyll
• Compatible with Github pages
• Featured Posts
• Index Pagination
• Multi Language
• SEO
• Feed
• Sitemap
• Post Share
• Post Categories
• Prev/Next Link
• Category Archives (Compatible with Github pages)
• Jumbotron Categories
• Post Reviews with Stars
• Blurred Spoilers
• Table of Content
• Lazy Load Images
• Integrations:
  • Disqus Comments
  • Google Analaytics
  • Mailchimp Integration
• Design Features:
  • Bootstrap v4.x
  • Font Awesome
  • Masonry
• Layouts:
  • Default
  • Post
  • Page
  • Archive
  • Categories (for 100% compatibility with Github pages)

What’s Jekyll

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 Kothing 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 Kothing template in Jekyll:

How to use "Kothing" theme

1. Download or git clone https://github.com/kothing/kothing-theme.git
2. cd kothing-theme
3. bundle
4. Edit _config.yml options. If your site is in root: baseurl: ''. Also, change your Google Analytics code, disqus username, authors, Mailchimp list etc.
5. jekyll serve --watch
6. Start by adding your .md files in _posts. Kothing already has a few examples.
7. YAML front matter
   • featured post - featured:true
   • exclude featured post from “All stories” loop to avoid duplicated posts - hidden:true
   • post image - image: assets/images/mypic.jpg
   • external post image - image: "https://externalwebsite.com/image4.jpg"
   • page comments - comments:true
   • meta description (optional) - description: "this is my meta description"

YAML Post Example:

---
layout: post
title:  "We all wait for summer"
author: john
categories: [ Jekyll, tutorial ]
image: assets/images/5.jpg
description: "Something about this post here"
---

YAML Post Example:

---
layout: page
title: Kothing Template for Jekyll
comments: true
---

Rating

---
layout: post
title:  "We all wait for summer"
author: john
categories: [ Jekyll, tutorial ]
image: assets/images/5.jpg
description: "Something about this post here"
rating: 4.5
---

Lazy Load Images

Enable this option by editing _config.yml.

# Lazy Images ("enabled" or "disabled")
lazyimages: "enabled"

Table of Contents

---
layout: post
title:  "Education must also train one for quick, resolute and effective thinking."
author: john
categories: [ Jekyll, tutorial ]
image: assets/images/3.jpg
beforetoc: "Markdown editor is a very powerful thing.
toc: true
---

beforetoc adds a paragraph before the TOC is displayed. Demo

Questions or bug reports?

Head over to our Github repository!