{ Personal } is a free, responsive Jekyll theme with a minimal aesthetic β perfect for your personal blog and portfolio. Tell your story with a beautiful timeline and share your thoughts through an elegant blog.
π Live Demo
- Fork this repository
- Rename the forked repository to
yourusername.github.io - Update
_config.yml:url: "https://yourusername.github.io" baseurl: ""
- Commit your changes β once the GitHub Action succeeds, your site will be
live at
https://yourusername.github.io
No need to install Ruby or dependencies locally:
docker-compose up --buildThe site will be available at http://localhost:4000.
Prerequisites:
Installation:
# Install dependencies
bundle install
# Start the development server with live reload
bundle exec jekyll serve --watch --livereloadThe site will be available at http://localhost:4000.
All site configuration is managed through _config.yml. Key settings include:
| Setting | Description |
|---|---|
url |
Your site's URL |
title |
Site title displayed in the header |
author |
Your name |
description |
Site description for SEO |
me-img |
Your profile image |
background-img |
Header background image |
events |
Timeline entries |
social |
Social media links |
- π¨ Modern, minimal aesthetic with white-on-black text
- π Dark mode with a theme toggle button β preference saved in localStorage
- π± Fully responsive β looks great on mobile, tablet, and desktop
- πΌοΈ Customizable header with dynamic text and profile image
- π Tell your story with a sleek timeline
- πΌοΈ Add images, dates, and descriptions for each milestone
- βοΈ Full-featured blog with archive page
- π·οΈ Hashtags and categories support
- π¬ Comments integration (Cusdis) with dark/light theme sync
- π Social share buttons (X, Facebook, LinkedIn, Reddit, Hacker News, and more)
- π¨ Syntax highlighting for code blocks
- π Mermaid diagram support
- π‘ RSS feed
- π Google Analytics integration
- πΊοΈ Automatic sitemap generation
- π SEO-friendly meta tags
- πͺ Cookie consent banner
- π‘οΈ Email harvesting protection
Detailed documentation is available as blog posts on the demo site.
This project uses Conventional Commits to generate release notes automatically.
To enforce conventional commits locally, run:
sh .githooks/setup.shThis will configure git to validate your commit messages before each commit.
<type>[optional scope]: <description>
Allowed types: feat, fix, docs, style, refactor, perf, test,
build, ci, chore, revert
Examples:
feat: add dark mode support
fix(comments): resolve Cusdis loading issue
docs: update installation instructions
This theme is a fork of Timeline, which is a mashup of:
This project is licensed under the Apache License 2.0 β see the LICENSE file for details.