_postsfolder and add yours.
If you want to make a Project Page, you have to use
gh-pages branch. For Personal Page;
master branch. More info here.
See a live version of Halve hosted on GitHub.
A quick checklist of the files you’ll want to edit to get up and running.
_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 use for meta tags and homepage.
Used to generate absolute urls in
feed.xml, and for generating canonical URLs in
<head>. When developing locally either comment this out or use something like
http://localhost:4000 so all assets load properly. Don’t include a trailing
Your site’s logo. It will be shown on homepage. Also used for twitter meta tags.
Here we will set images for left block. Example:
background: homepage: images/home.png post-list: images/unsplash-image-10.jpg default-post: images/unsplash-gallery-image-3.jpg
To set what image links appear in the overlay menu edit
_data/projects.yaml. Use the following format to set the URL, title, image and project status for as many links as you’d like. If you set
completed: false, it won’t be clickable until you set it true like
Halve Theme use 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 left block image per post. Just add
image: some link to your post’s front matter. If you don’t set this, default post image will be used from
image: /assets/img/some-image.png or image: http://example.com/some-image.png
This also will be used for twitter card:
Found a bug or aren’t quite sure how something works? By all means file a GitHub Issue. And if you make something cool with this theme feel free to let me know.
This theme is free and open source software, distributed under the MIT License. So feel free to use this Jekyll theme on your site without linking back to me or including a disclaimer.