JekyllBlog

blog (AminTaheri23) — Jekyll Blog Template

By AminTaheri23

AminTaheri23's blog is a free and open-source Jekyll-based blog theme, modified from simplygrey-jekyll and integrated with Super Search for real-time post search, under the MIT license.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-09-30View source

What stands out

A quick read of the recorded project description.

01

Free and open-source Jekyll-based blog theme under the MIT license, with code that can be modified, used commercially, and distributed

02

Derived from simplygrey-jekyll with modifications, and integrated with Super Search for real-time search of posts by title and description

03

Built-in homepage pagination, category archives, related posts, previous/next navigation, and Disqus comments

04

Includes a project list page and project detail pages, with project data spread across projects.md, _data/projects.json, and the _project/ directory

05

Supports social sharing, Google Analytics, sitemap, and XML Feed, and compresses output using Jekyll Compress HTML

Template Details

This is a blog theme for Jekyll. The repository states it is derived from simplygrey-jekyll with modifications, and the search functionality comes from Super Search. The theme provides homepage pagination, category archives, related posts, previous/next navigation, Disqus comments, a project list and project detail pages, social sharing, Google Analytics, and HTML output compression via Jekyll Compress HTML, while also generating a sitemap and XML Feed.

For content organization, posts go in the _posts/ directory with filenames following the "date-slug.md/.markdown" format. Front matter can declare title, date, categories, tags, and an image for og:image; categories require corresponding pages to be created under the category/ path first. Project content is spread across projects.md, _data/projects.json, and the _project/ directory, and personal information is edited in about.md.

Before use, you need to edit _config.yml to complete site settings; if you want to use the theme as the main site rather than a subpath site, you must remove the '/blog' prefix from the project. Local running depends on Ruby and Bundler; you can run bundle install and then preview via jekyll serve at 127.0.0.1:4000. The repository does not provide further details on style customization, browser compatibility, or deployment workflow.

JekyllBlog

Is it right for your project?

Use Cases

  • Building a personal technical blog focused on post lists and category archives
  • Content sites that need in-site real-time search of post titles and descriptions
  • Developer homepages that want to display both a personal project list and project detail pages
  • Blogs using Jekyll that need a sitemap, XML Feed, and basic SEO metadata

Suitable For

  • Developers familiar with Jekyll and Markdown who are willing to edit configuration files directly
  • Individual users who need a free, open-source blog theme whose code they can modify themselves
  • Small to medium-sized blogs that organize content primarily by categories and posts
  • Personal sites that need project showcase pages to coexist with a blog

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    First fork the repository, then edit the site settings in _config.yml

  2. 2

    Place posts in the _posts/ directory with filenames using the <date>-<slug>.md or .markdown format; categories must first be created under category/

  3. 3

    Project content requires maintaining projects.md, _data/projects.json, and detail files under _project/ simultaneously

  4. 4

    If you want to use the theme as the main site, remove all '/blog' path prefixes from the project

  5. 5

    For local preview, run bundle install and then jekyll serve, and visit http://127.0.0.1:4000

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.

Must comply with when using

  • You are allowed to use, modify, use commercially, and distribute the code of this version for free.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • The comment feature relies on the third-party Disqus service; you must register a Disqus site and configure the shortname yourself, and comment data is hosted by Disqus.
  • The analytics feature relies on Google Analytics; you must apply for an account and enter the tracking ID yourself, and use is subject to Google's terms of service.
  • The project is derived from simplygrey-jekyll with modifications; when redistributing, you must retain the upstream copyright and license notices.
  • The real-time search feature comes from the third-party Super Search component; its own license terms must be followed when using it.
  • HTML compression relies on the third-party Jekyll Compress HTML plugin; that plugin's license must be followed.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Disqus comment

Original README

Google analytics

Original README

This project forked and has been modified from [A simple grey theme for Jekyll]

Original README

the search posts using [Super Search]

Original README

HTML Minify _(Compress HTML)_ using [Jekyll Compress HTML]

Original README
https://github.com/AminTaheri23/blog/blob/master/LICENSEhttps://github.com/AminTaheri23/blog/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-01. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 83 / 100
Technologies
Jekyll
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-09-08
Screenshot last checked
2026-10-01

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 949596b03e955472c4c60ec2027a0fb8d10ac47ae13904804370b4bf2a95568c

2026-10-01T14:32:33.518Z

Source file / repository
## My blog

> This project forked and has been modified from [A simple grey theme for Jekyll](https://github.com/liamsymonds/simplygrey-jekyll),
> and the search posts using [Super Search](https://github.com/chinchang/super-search)
> I got this from Agus ([agusmakmun](agusmakmun.github.io))

### Demo
* [https://amintaheri23.github.io/blog](https://amintaheri23.github.io/blog)

#### Features

* Sitemap and XML Feed
* Pagination in homepage
* Posts under category
* Realtime Search Posts _(title & description)_ by query.
* Related Posts
* Highlight pre
* Next & Previous Post
* Disqus comment
* Projects page & Detail Project page
* Share on social media
* Google analytics
* HTML Minify _(Compress HTML)_ using [Jekyll Compress HTML](https://github.com/penibelst/jekyll-compress-html)

### Install & Configuration

1. Fork this repository
2. Edit site settings inside file of `_config.yml`
3. Edit your projects at file of `projects.md`, `_data/projects.json` and inside path of `_project/` _(for detail project)_.
4. Edit about yourself inside file of `about.md`
5. Remove the '/blog' from all of the project if you want this to be your main website.
### How to Use?

**a. Add new Category**

All categories saved inside path of `category/`, you can see the existed categories.

**b. Add new Posts**

* All posts bassed on markdown syntax _(please googling)_. allowed extensions is `*.markdown` or `*.md`.
* This files can found at the path of `_posts/`.
* and the name of files are following `<date:%Y-%m-%d>-<slug>.<extension>`, for example:

```
2013-09-23-welcome-to-jekyll.md

# or

2013-09-23-welcome-to-jekyll.markdown
```

Inside the file of it,

```
---
layout: post                          # (require) default post layout
title: "Your Title"                   # (require) a string title
date: 2016-04-20 19:51:02 +0700       # (require) a post date
categories: [python, django]          # (custom) some categories, but makesure these categories already exists inside path of `category/`
tags: [foo, bar]                      # (custom) tags only for meta `property="article:tag"`
image: Broadcast_Mail.png             # (custom) image only for meta `property="og:image"`, save your image inside path of `static/img/_posts`
---

# your content post with markdown syntax goes here...
```


#### Installing in your local

**Option 1:**

```
bundle install --path vendor/bundle

bundle exec jekyll serve
```

**Option 2:** If you already installed the jekyll

```
bundle install
jekyll serve
```

Then visit the http://127.0.0.1:4000

**Updating the `Gemfile.lock`**

```
bundle update
```
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.