Bal6eem ia based on Herring Cove, a clean and responsive theme for Jekyll.
- Good support for Arabic and other RTL languages
- Clean and blog-friendly
- Categories and tag support
- Easy to configure
- Install Jekyll
- Fork or download this theme repo
- Edit the
_config.yml
file
- Create a
{username}.github.io
or{orgname}.github.io
repository - Fork this project. Delete the
master
branch and rename thegh-pages
tomaster
- clone the
gh-pages
branch of this repository to your own project
A new file needs to be created in the _posts/
directory with following schema: yyyy-mm-dd-Some-Title.markdown
.
The post format is Github-flavored markdown, which is a strict superset of HTML, so you are free to mix them as you please. Every File has a YAML Front Matter at its start, with optional parameters that specify how the site is to be displayed. A full example (##
are comments):
---
title: "Some title for your site"
date: 2013-11-08 19:55:16
categories: osdev bootloader
tags: c x86 real-mode
direction: ltr ## this is optional, if left out it defaults to rtl (right to left)
comments: true ## enable disqus comments?
author: a3f ## can be left out
---
Your text here in Github flavoured Markdown
Any post can have an author tag in the YAML front matter. If a link/avatar/bio are wished for, it is quite easy to. Open _data/authors.yml
and just add a new entry:
jekyll:
name: Dr. Henry Jekyll
gravatar: deadbeefdeadbeefdeadbeefdeadbeef
site: example/com
contact: jekyll@example.com
biodir: ltr
bio: Dr. Jekyll is a large, well-made, smooth-faced man of fifty with something of a
slyish cast", who occasionally feels he is battling between the good and
evil within himself, thus leading to the struggle between his dual personalities
of Henry Jekyll and Edward Hyde.
Now any post by said author will have the author name linking to his site and have the bio at the end of the article.
For on-site longer bios, a page can be created and stylized with markdown. For that see next point.
Just add a page under pages/
with following content:
---
layout: page
permalink: /author/jekyll/
---
---
#Dr. Henry Jekyll
Hello my name is <em>Jekyll</em> and I preprocess and serve **static blogs** by day. I mutate by night.
Tags are meant as keywords for your posts, if you want to add new tags, navigate to _data/tags.yml
. A tag entry looks like this:
ia32:
name: IA32
This can then be used to tag posts via the tags:
YAML-Parameter. The tag overview page has to be created manually. For that duplicate any tag file in /tag/*.md
and adjust the parameters.
If you want to add new categories, navigate to _data/categories.yml
. A category entry looks like this:
linux:
name: Linux
This can then be used to categorize posts via the categories:
YAML-Parameter. The category overview page has to be created manually. For that duplicate any category file in /category/*.md
and adjust the parameters. An overview page of all categories exists at /categories.html
and is populated automatically according to posts in /_posts
and categories in _data/categories.yml
.
The default direction is RTL. If a Left-to-Right direction is wished for in a single blog post this can be done by adding this line in the YAML frontmatter (the parameters at the top of the blog post):
direction: ltr