Hacker-Blog is a minimalistic, responsive jekyll theme built for hackers. It is based on the hacker theme for project pages.
Features
- Pagination
- SEO tags
- Archive Page
- RSS
- Sitemap
Installation
- Fork and Clone the project repository
- Customize your blog
- Add a new post in
_posts/
directory with proper name format (as shown in placeholder posts) - Commit and push to master
Local Build
If you want to see the changes before pushing the blog to Github, do a local build.
gem install jekyll
gem install jekyll-seo-tag
- (
cd
to the blog directory, then:)jekyll serve --watch --port 8000
Local build using docker
docker run --rm -p 8000:8000 \
--volume="LOCATION_OF_YOUR_JEKYLL_BLOG:/srv/jekyll" \
-it tocttou/jekyll:3.5 \
jekyll serve --watch --port 8000
Replace LOCATION_OF_YOUR_JEKYLL_BLOG
with the full path of your blog repository. Visit https://localhost:8000
to access the blog.
Customizing
Configuration variables
Edit the _config.yml
file and set the following variables:
title: [The title of your blog]
description: [A short description of your blog's purpose]
url: [Canonical URL for this blog]
author:
name: [Your name]
email: [Your email address]
url: [URL of your website]
paginate: [Number of posts in one paginated section (default: 3)]
owner: [Your name]
year: [Current Year]
Additionally, you may choose to set the following optional variables:
google_analytics: [Your Google Analytics tracking ID]
About Page
Edit about.md
Layout
If you would like to modify the site style:
HTML
Footer: Edit _includes/footer.html
Header: Edit _includes/header.html
Links in the header: Edit _includes/links.html
Meta tags, blog title display, and additional CSS: Edit _includes/head.html
Index page layout: Edit _layouts/default.html
Post layout: Edit _layouts/post.html
CSS
Site wide CSS: Edit _sass/base.scss
Custom CSS: Make _sass/custom.scss
and use it. Then add @import "custom";
to css/main.scss
404 page
Edit 404.md