Configuration Guide

General Site & Build Settings

These settings control the basic site details:

# Site Settings
baseurl: ""
url: ""

Configure Jekyll build options:

# Build settings
markdown: kramdown
permalink: /blog/:title/
sass:
  style: compressed
  sass_dir: _sass
  sourcemap: never

These plugins extend Jekyll functionality:

# Plugins
plugins:
  - jekyll-feed
  - jekyll-seo-tag
  - jekyll-sitemap
  - jekyll-paginate-v2
  - jekyll-watch
  - jekyll-toc

Configure Table of Contents settings:

# TOC Settings for documentation
toc:
  min_level: 2
  max_level: 3
  ordered: false
  numbered_items: true
  auto_ids: true
  sanitize: false

Settings for blog and project pagination:

# Pagination
pagination:
  enabled: true
  collections:
    - name: 'posts'
      per_page: 6
      permalink: '/blog/page:num/'

Define collections for projects and authors:

# Collections
collections:
  projects:
    output: true
    permalink: /projects/:path/
  authors:
    output: true
    permalink: /authors/:path/

Settings for automatic page reloading:

# LiveReload settings
livereload_max_delay: 5
livereload_min_delay: 2.5