This blog uses Jekyll (as a static site generator), supported by GitHub Pages as a built-in feature.
Currently, I'm using GitHub Pages to render and host this blog.
To generate a github blog create a public github repository of the following name:
<github-username>.github.io
A MarkDown file is create with the following structure
---
layout: post
title: "Pi-hole Setup"
categories: [security, raspberrypi]
tags: [raspberrypi, pihole]
---
Initial statement about the post, this will be visible in the main page.
# Introduction
.
.
.
Content continues ...
The markdown file has to be placed with a yyyy-mm-dd-title.md format in the _posts folder and pushed to github for the page to be published.
I am currently using _drafts as a folder to hold my draft posts and ideas.
To check that github is building your site without errors got to the Settings tab of your repository. It will show any build errors there.
cite: About Jekyll build errors for GitHub Pages sites
The post structure and blog styles are all controlled by the following files:
- _config.yml
- index.html
- _layouts/ folder
- _includes
- _sass
jekyll-theme-primer{:target="_blank"}
Update (2020-10-02): Migrated to Hyde theme{:target="_blank"}
Using the jekyll-theme-primer repository copy _layouts\default.html into your repository.
Change index.html to just have the content of the index.html without the html, head, body html tags.
Add the font-awesome script into the section.
The font-awesome script can be obtained by signing in with an email and getting the generated script details.
Ensure the following files are present:
- Dockerfile
- docker-compose.yml
- Gemfile
Run docker-compose up and navigate to localhost:4000
Obtained from mendhak
Customizing CSS and HTML in your Jekyll theme
- Search?