Chalk is a high quality, completely customizable, performant and 100% free Jekyll blog theme.
Switch branches/tags
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_assets feat: theme toggle as option in config Dec 11, 2018
_includes feat: theme toggle as option in config Dec 11, 2018
_layouts chore(excerpt): use else instead of elsif Jan 5, 2018
_my_tags Setup documentation phase 1 Oct 24, 2016
_posts Fix zooming issue, update documentation and update versions May 21, 2018
bin Remove sudo Jun 6, 2017
.gitignore Fix zooming issue, update documentation and update versions May 21, 2018
.ruby-version Fix zooming issue, update documentation and update versions May 21, 2018
.travis.yml Added Travis support for the theme (#160) May 21, 2018
404.html Added Header and Footer to the 404 Page for consistent design May 21, 2018
CNAME Use new Jekyll relative_url and absolute_urls (#7) Nov 10, 2016
Gemfile Fix zooming issue, update documentation and update versions May 21, 2018
LICENSE Create LICENSE Jun 29, 2017
README.md Fix zooming issue, update documentation and update versions May 21, 2018
_config.yml feat: theme toggle as option in config Dec 11, 2018
about.html Update to jekyll-assets 3 + ruby + jekyll Dec 24, 2017
circle.yml Add latest node version to circle ci config May 21, 2018
feed.xml Use https when available Jun 6, 2017
index.html chore(excerpt): use else instead of elsif Jan 5, 2018
package.json Fix zooming issue, update documentation and update versions May 21, 2018
robots.txt Initial commit Jul 26, 2016
tags.html Adding Tag Cloud Page. May 23, 2018

README.md

Chalk is a high quality, completely customizable, performant and 100% free blog template for Jekyll.

Overview

Features:

  • About page.
  • Automatic RSS feed.
  • Automatic sitemap.
  • Automatic time to read post indicator.
  • Cross browser support (supports all modern browsers).
  • Custom 404 page.
  • Custom code highlighting.
  • Customizable pagination.
  • Dark and Light theme.
  • Easy setup and deploying.
  • Enlarge images on click.
  • Filter on tags.
  • Frequently updated with new versions.
  • Many social media links supported.
  • Media embed for videos.
  • PageSpeed optimized.
  • Proper sharing links for posts on Facebook, Twitter and Google Plus.
  • SEO optimized.
  • Support for local fonts.
  • Support for emoji's.

Integrations

Used tools

Usage

Installation

If you haven't installed the following tools then go ahead and do so (make sure you have Homebrew installed):

brew install ruby
brew install npm

On windows, install Ruby and Node with the installers found here:

Next setup your environment:

npm run setup

Development

Run Jekyll:

npm run local

Deploy to GitHub Pages

Before you deploy, commit your changes to any working branch except the gh-pages one and run the following command:

npm run publish

Important note: Chalk does not support the standard way of Jekyll hosting on GitHub Pages. You need to deploy your working branch (can be any branch, for xxx.github.io users: use another branch than master) with the npm run publish command. Reason for this is because Chalk uses Jekyll plugins that aren't supported by GitHub pages. The npm run publish command will automatically build the entire project, then push it to the gh-pages branch of your repo. The script creates that branch for you so no need to create it yourself. Also, if you are developing a project site, you must set the baseurl in _config.yml to the name of your repository.

You can find more info on how to use the gh-pages branch and a custom domain here.

View this for more info about automated deployment with Circle CI.

License

MIT License

Contributing

  1. Fork it (https://github.com/[my-github-username]/chalk/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request