Basic Dev Blog

A minimal GitHub Pages blog where each post is Markdown-based and keeps its images in the same folder as the post.

Structure

.
├── _layouts/
│ ├── default.html
│ ├── home.html
│ └── post.html
├── assets/
│ └── css/
│ └── style.css
├── posts/
│ └── welcome/
│ ├── index.md
│ └── cover.png
├── _config.yml
├── about.md
└── index.md

Add A New Post

Create a new folder under posts/:

posts/my-new-post/
├── index.md
├── cover.jpg
└── diagram.png

Use this front matter in index.md:

---title: "My New Post"date: 2026-07-25description: "Short summary shown on the homepage."tags:
- markdown
- github-pagescover: "cover.jpg"cover_alt: "Describe the cover image"---

Reference images with relative paths:

![Architecture diagram](diagram.png)

Run Locally

If Ruby and Bundler are installed:

bundle install
bundle exec jekyll serve

Then open http://127.0.0.1:4000.

Publish On GitHub Pages

Push this folder to a GitHub repository, then enable GitHub Pages in the repository settings. Use the branch and folder that contain this project, usually main and /root.

Optional Games

games/ contains a standalone catalog, and every game owns a separate folder. See games/README.md for the file structure and steps for adding or removing a game. To remove the entire games section, delete games/ and remove the Games link from _layouts/default.html.

Optional Tools

tools/ contains a standalone catalog, and every tool owns a separate folder. See tools/README.md for the file structure and steps for adding or removing a tool. To remove the entire tools section, delete tools/ and remove the Tools link from _layouts/default.html.