Hexo Theme Yilia L is a minimalist Hexo blog theme forked from the yilia theme, adding table of contents, Valine comments, site search, donation, and social sharing to the original design.
What is Hexo Theme Yilia L?
Hexo Theme Yilia L is a Hexo blog theme based on the yilia theme, available as an open-source GitHub repository under the name hexo-theme-yilia-l. It preserves the original yilia design's simplicity and performance while introducing a status bar, micro resume, automatic table of contents for posts, Valine comment integration, built-in site search, donation support, and social share buttons. The theme is configured through the Hexo _config.yml file and supports per-post overrides for TOC, comments, and donation. It is built for Hexo, the static site generator, with content written in Markdown and styled using Stylus.
Key Features
- Status bar — Displays recent status updates on the homepage, with content defined via the
recentContentconfig option. - Micro resume — Shows a brief introduction card on the homepage only, toggled by the
resumeoption. - Table of contents — Automatically generates a TOC for posts of type
post; set a post's layout topost-noTOCto opt out. - Valine comments — Integrates Valine, a lean commenting system; enable globally with
valine: trueand disable per post withcomment: false. - Site search — Built-in search functionality enabled with the
search: trueconfig. - Donation button — Adds a donation section to posts, configurable globally with
donate: trueand per post withdonate: false. - Social sharing — Adds share buttons to articles when
socialShare: trueis set. - Customizable navigation and subnav — Menu items for categories and pages (about me, front-end development, work logs, life) plus a subnav linking to GitHub, Weibo, RSS, and Zhihu, among others.
- Theme options — Includes tag cloud, friend links, about me widget, Google Analytics, MathJax, Fancybox, yearly archives, and avatar and favicon settings.
Who is it for?
- Hexo bloggers who want a lightweight, elegant theme with extra functionality beyond the stock yilia theme, such as TOC and comments.
- Developers who prefer a static site workflow with Markdown content and per-post controls for features like comments and TOC.
- Performance-conscious writers who value the original yilia theme's speed and want to keep that edge while adding modern blog features.
What can you do with Hexo Theme Yilia L?
- Personal bloggers: Set up a clean blog with a status bar, micro resume, and Valine comments to engage readers directly.
- Technical writers: Publish posts with automatic TOC and organize content by categories like front-end development and work logs for easy navigation.
- Content creators with donations: Enable the donate feature to accept support from readers, with the ability to disable it for specific posts.
How does Hexo Theme Yilia L work?
Install the theme by cloning the repository into the themes/yilia-l directory of a Hexo site, then set theme: yilia-l in the root _config.yml. After installation, configure options such as menu, subnav, TOC, Valine, donate, and search through the theme's config section. Updates are pulled with git pull inside the theme directory.
Pricing
Hexo Theme Yilia L is free and open source; the repository is publicly available on GitHub and can be used without charge.
Alternatives
- yilia — the original minimal Hexo theme that this fork builds upon.
FAQ
How do I install Hexo Theme Yilia L?
Clone the repository to themes/yilia-l in your Hexo project, then set theme: yilia-l in the root _config.yml. Run hexo generate to see the theme applied.
How do I disable TOC for a specific post?
Set the post's layout to post-noTOC in the front matter. For example, layout: post-noTOC will prevent that individual post from showing a table of contents while the global toc: true remains.
How do I disable comments on a post?
Set comment: false in the front matter of the post. This works even when Valine comments are globally enabled via valine: true.
How do I enable site search?
Set search: true in the theme configuration. The search feature is built into the theme and does not require a third-party plugin.
Is Hexo Theme Yilia L free?
Yes, it is an open-source theme available on GitHub. The repository is publicly accessible and can be cloned and modified freely.
