- Fork the repo
- Remove posts from
_postsfolder and add yours.
- Change repo name to
A quick checklist of the files you’ll want to edit to get up and running.
Site Wide Configuration
_config.yml is your friend. Open it up and personalize it. Most variables are self explanatory but here’s an explanation of each if needed:
The title of your site… shocker!
title: My Awesome Site
The description to show on your homepage.
The description to use for meta tags and navigation menu.
Set true to show reading time for posts. And set
words_per_minute, mine is 225.
Your site’s logo. It will show on homepage and navigation menu. Also used for twitter meta tags.
Image for background. If you don’t set it, color will be used as a background.
It’s enabled. But if you don’t want to use it. Set it false in
Third Party Services
You can set your username for third party services like matrix, github, etc. in
_config.yml. If you don’t want to use one of them, just remove it or comment it out. If you add
_config.yml, they will be used for comments and analytics.
To set what links appear in the top navigation edit
_data/navigation.yml. Use the following format to set the URL and title for as many links as you’d like. External links will open in a new window.
Layouts and Content
This theme uses Jekyll Compress to compress html output. But it can cause errors if you use “linenos” (line numbers). I suggest don’t use line numbers for codes, because it won’t look good with this theme, also i didn’t give a proper style for them. If you insist to use line numbers, just remove
layout: compress string from layouts. It will disable compressing.
You can set feature image per post. Just add
feature: some link to your post’s front matter.
feature: /assets/img/some-image.png or feaure: http://example.com/some-image.png
This also will be used for twitter card: