Liberxue Theme

Liberxue Theme is a lightweight, minimalist Jekyll blog theme designed for GitHub Pages that produces a static blog with automatic tag pages, JSON search, and an RSS feed. Created by liberxue and hosted in the open-source liberxue.github.io repository, this theme is freely available and runs entirely on Jekyll, making it an ideal choice for developers who want a fast, no-frills blog without the overhead of a larger framework.

What is Liberxue Theme?

Liberxue Theme is a Jekyll-based blog theme that turns a standard Jekyll site into a responsive card-style blog. It takes your Markdown posts and automatically generates tag pages, a JSON search index, an RSS feed (feed.xml), and pagination. The theme is configured through the _config.yml file, where you set your domain, navigation links, and pagination count. It is maintained by liberxue and is designed to deploy seamlessly on GitHub Pages.

Key Features

• Automatic tag generation — Creates dedicated tag pages from each post's front matter tags, improving content organization.
• JSON search — Generates a searchable JSON index that powers a built-in client-side search without requiring any external search service.
• Adaptive responsive design — The card-based layout adapts to mobile, tablet, and desktop screens for a consistent reading experience.
• Automatic feed.xml — Produces a standard RSS feed so visitors can subscribe to your blog updates.
• Automatic pagination — Uses the paginate setting in _config.yml to split your posts into pages automatically.
• Customizable menu — Edit the links array in _config.yml to change the navigation items displayed in the site header.
• One-line URL setup — After forking the repository, changing the url value in _config.yml is the only required step to make the blog live.
• Free with no copyright — The author explicitly waives copyright and asks only for a GitHub star; there are no license fees or donation requirements.

Who is it for?

• Technical bloggers who want a fast, static blog hosted free on GitHub Pages with built-in search and tag organization.
• Developers familiar with Git and YAML who can fork a repository and edit _config.yml to personalize their site.
• Minimalists who prefer a simple card-style design over feature-heavy themes with JavaScript frameworks.

What can you do with Liberxue Theme?

• Personal blogging: Publish Markdown posts and get a responsive blog with automatic tag pages and a searchable index.
• Project documentation: Use the archive and tag pages to organize technical notes and tutorials hierarchically.
• Rapid site launching: Go from forking the repo to a live blog in minutes by changing just the URL in _config.yml.

How does Liberxue Theme work?

The setup is intentionally simple: fork the liberxue.github.io repository, then edit _config.yml to set your domain under the url key. When Jekyll builds the site, it automatically generates tag pages, the JSON search file, feed.xml, and pagination based on your posts. On GitHub Pages, this build process runs every time you push new content, so your blog updates immediately.

Pricing

Liberxue Theme is free and open source. The author states, "I don't want any copyright also don't need you to donate, I only need you with a star." There are no paid tiers, subscriptions, or hidden costs.

FAQ

Is Liberxue Theme free?

Yes, it is completely free. The author explicitly waives copyright and requests only a GitHub star in return. There are no charges for using or modifying the theme.

How do I set up Liberxue Theme?

Fork the repository on GitHub, change the url value in _config.yml to your own domain, and push to the master branch. GitHub Pages will automatically build and serve your blog. This process takes only a few minutes.

Does Liberxue Theme have search functionality?

Yes, it automatically generates a JSON search index. The theme includes a client-side search interface that uses this index to provide full-text search without relying on third-party services like Algolia.

Can I change the navigation menu?

Yes. The navigation menu is controlled by the links array in _config.yml. Add, remove, or reorder items to customize what appears in the site header.

Does Liberxue Theme support tags?

Absolutely. Tag pages are generated automatically from the tags you define in each post's front matter, giving every topic its own archive page.