hexo-blog-lionkk is an open-source Hexo blog starter repository that packages a heavily modified Butterfly theme into ready-to-run source code, so anyone can clone it, replace the site details, and deploy a full-featured blog.
What is hexo-blog-lionkk?
Hexo-blog-lionkk is the complete source code of author yangchaoyi's personal blog, shared on GitHub by Chocolate1999 and demonstrated at yangchaoyi.vip. It runs on Hexo 4.0+ with Node.js 8.0+, builds on the hexo-theme-butterfly theme, and is released under the Apache License 2.0. Unlike generated HTML output, this repo gives you the full site source: install dependencies with npm install, edit the root _config.yml, and generate or deploy the blog with standard Hexo commands.
Key Features
- Ready-to-deploy source — The repo contains the working Hexo source, so after changing the blog information to yours, you can run the standard Hexo commands to produce and publish a site.
- Extra built-in pages — Adds media, treasure box, microblog (微语), checklist, message board, friends, about, and music pages beyond the Butterfly defaults.
- Dual comment systems — Supports switching between Gitalk and Valine, and also integrates Gitment and Disqus; Valine adds Bilibili emoticons and WeChat/QQ notifications for author replies.
- Analytics and statistics — Includes Busuanzi visitor counts, Google Analytics, Baidu Analytics, Tencent Analytics, and article word-count statistics.
- Content and display tools — Provides MathJax and KaTeX rendering, TOC, local search (local_search), image lightbox, password-protected articles, copy-with-copyright notice, a default 404 page, summary excerpts, and a carousel banner.
- Custom widgets — Loading animation, rotating default avatar, footer beating heart, visitor map, calendar, Pixiv daily ranking, Bilibili anime page plugin, cartoon mascot (kanban娘), and Douban movie/book/game plugin.
- Theme and UX settings — Material Design styling, dark/light mode, simplified/traditional Chinese switch, responsive layout for desktop/tablet/mobile, and article pinning with a tip jar (打赏) option.
Who is it for?
- Blogging beginners — People with little or no programming experience get a complete, tested blog skeleton and only need to swap in their personal details before deploying.
- Hexo users — Hexo bloggers who want Butterfly-style design with extra pages and plugins without manually modifying theme code.
- Personal site owners — Individuals who want a blog plus friend links, gallery, message board, and anime/media widgets, all in one repo.
- Open-source contributors — Developers who want to improve the template can fork and submit pull requests, following the author's tutorial at yangchaoyi.vip/posts/520520.
What can you do with hexo-blog-lionkk?
- Launch a personal blog: Replace the site name, avatar, and config in _config.yml, then run hexo clean, hexo g, hexo s (local preview), and hexo d (deploy) to publish.
- Add anime/media content: Use the built-in Bilibili anime page plugin, Pixiv daily ranking page, and Douban movie/book/game sections to enrich a blog about hobbies.
- Communicate with readers: Enable Gitalk or Valine comments, local search, and visitor analytics so readers can discuss and you can track traffic.
- Customize the design: Modify the Butterfly-based theme's fonts, backgrounds, footer, and widgets, or follow the linked tutorial to implement checklist items not yet released.
How does hexo-blog-lionkk work?
The README describes a simple workflow: install Git and Node.js, fork or clone the repo, run npm install, change the blog information to your own, then run hexo clean to clear generated files, hexo g to generate pages, hexo s to preview locally, and hexo d to deploy. The root _config.yml keeps theme: Butterfly around line 98, so the site still builds on the original theme name.
Pros and cons
- Pros: Open source under Apache 2.0; detailed Chinese tutorial plus a Bilibili video guide; dual comment system; many pages and widgets pre-built.
- Cons: The author states this modified blog is not planned for further upgrades; some roadmap items such as random article links, a Steam library page, a botui dialog-style intro, and a talk page remain unimplemented.
FAQ
Is hexo-blog-lionkk free?
Yes. The repository is open source under the Apache License 2.0, and the source confirms it is free to download and modify. The author only asks for a star on GitHub if the project helps you.
Do I need to know programming to use it?
No. The repo is the actual blog source, not generated HTML, and it has been tested by the author and users. You install Git and Node.js, clone the repo, run npm install, replace the blog information with yours, and follow the standard Hexo commands.
What versions are supported?
Badges in the README list compatibility with Hexo 4.0+ and Node.js 8.0+. The current release is v2.0.0, updated in July 2020 to work with Butterfly theme v3.0.0.
What comment systems are included?
It supports Gitalk, Gitment, Valine, and Disqus, with a dual-comment switch between Gitalk and Valine. Valine adds Bilibili emoticons and can send WeChat/QQ notifications to the blog author.
What should I do if I run into bugs?
The README notes that the original Butterfly theme was not developed by the repo author, but the modified source has been tested and runs. Keep theme: Butterfly in the root config (around line 98), and bug reports or questions can be left in the article comments at yangchaoyi.vip.
