WebServer/hexo-theme-butterfly
1
0
Fork 0
mirror of https://github.com/jerryc127/hexo-theme-butterfly.git synced 2025-09-15 12:58:48 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
🦋 A Hexo Theme: Butterfly
520 Commits 2 Branches 79 Tags 22 MiB
JavaScript 40.3%
Stylus 37.7%
Pug 22%
5ee24defc3
Go to file
Jerry 5ee24defc3 feat: 預設關閉 structured_data 
feat: 升級一些項目依賴
feat: 重寫 README.md 和 README_CN.md，改進文檔結構和內容
feat: tags 標籤插件夜間模式調整
feat: 加按鈕懸停效果和動畫
fix: 修復右下角箭頭圖標位置沒有居中的 bug
feat: 增加右下角箭頭和滾動百分比的切換效果
improvement: 優化 tags 頁標籤雲顯示效果
improvement: 整合部分js到 init.js
improvement: 統一 CSS 變數使用，改進主題一致性
2025-08-19 14:49:39 +08:00
.github update 2025-02-16 20:38:17 +08:00
languages feat: 增加導覽欄顯示文章標題的選項 feat: 文章頁增加'返回首頁'文字 improvement: 當 per_page 為 0 時，頁面不顯示導覽列 2025-06-25 16:25:46 +08:00
layout feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00
scripts feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00
source feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00
_config.yml feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00
.gitignore chore: 补充缺少的依赖库 2025-04-30 16:56:46 +08:00
LICENSE update 2025-02-16 20:38:17 +08:00
package.json feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00
plugins.yml fix: 修復 aside 最後一個 沒有 margin-bottom 的 bug 2025-07-27 15:26:28 +08:00
README_CN.md feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00
README.md feat: 預設關閉 structured_data 2025-08-19 14:49:39 +08:00

README.md

Butterfly Logo

hexo-theme-butterfly

A modern, elegant and feature-rich theme for Hexo

master version dev version npm version hexo version license GitHub stars

📢 Demo: Butterfly Official | CrazyWong's Blog

📖 Documentation: English Docs | 中文文档

Butterfly Theme Preview

🚀 Quick Start

💾 Installation

Method 1: Git Installation (Recommended)

💡 Tip: If GitHub access is slow in mainland China, you can use the Gitee Mirror

Execute in your Hexo blog root directory:

# Install stable version (recommended)
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

# Install development version (early access to new features)
git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

Method 2: NPM Installation

⚠️ Note: NPM installation only supports Hexo 5.0.0 and above

npm install hexo-theme-butterfly

⚙️ Theme Configuration

  1. Enable Theme: Modify your Hexo configuration file _config.yml:
theme: butterfly
  1. Install Dependencies: If you haven't installed pug and stylus renderers, please run:
npm install hexo-renderer-pug hexo-renderer-stylus --save

✨ Theme Features

🎨 Design Style

  • Card-based Design - Modern card-style layout
  • Rounded/Square Design - Customizable border styles
  • Responsive Design - Perfect adaptation to all screen sizes
  • Two-column Layout - Optimized reading experience
  • Dark Mode - Eye-friendly night mode

📝 Content Features

  • Multi-level Menu - Support for secondary navigation menus
  • Reading Mode - Focused article reading experience
  • TOC Navigation - Desktop and mobile TOC support
  • Word Count - Display article word count and reading time
  • Related Articles - Smart recommendation of related content
  • Outdated Reminder - Automatic article update status alerts
  • Traditional/Simplified Chinese - Support for Traditional and Simplified Chinese switching
  • Tag Plugins - Rich tag plugin support

🔍 Search & Navigation

  • Multiple Search Options - Algolia Search / Local Search / Docsearch
  • Built-in 404 - Beautiful 404 error page
  • Pjax Support - Smooth page transition experience

🎨 Code Display

  • Syntax Highlighting - Built-in multiple themes (darker/pale night/light/ocean)
  • Code Features - Language display/fold expand/copy button/auto-wrap
  • Math Formulas - Support for Mathjax and Katex

💬 Social Interaction

  • Multiple Comment Systems - Disqus/Gitalk/Valine/Waline/Twikoo/Giscus/Artalk etc.
  • Dual Comments Support - Enable two comment systems simultaneously
  • Share Features - Sharejs/Addtoany sharing components
  • Live Chat - Chatra/Tidio/Crisp instant messaging

📊 Analytics & Statistics

  • Visit Statistics - Busuanzi counter
  • Site Analytics - Google Analytics/Baidu Analytics/Cloudflare Analytics/Microsoft Clarity/Umami
  • Webmaster Verification - Major search engine verification
  • Ad Support - Google AdSense/custom ad slots

🎪 Visual Effects

  • Typing Effects - activate_power_mode animations
  • Background Effects - Static ribbons/dynamic ribbons/floating ribbons/Canvas Nest
  • Mouse Effects - Fireworks/hearts/text click effects
  • Loading Animations - Preloader and pace.js progress bars
  • Image Effects - Medium Zoom/Fancybox image lightbox
  • Lazy Loading - Image lazy loading optimization

🛠️ Advanced Features

  • PWA Support - Progressive Web App
  • Copy Protection - Disable text copying/copyright info append
  • Theme Customization - Custom site color schemes
  • Chart Support - Mermaid flowcharts/Chart.js data charts
  • Music Notation - ABCJS music notation support
  • Music Player - APlayer/Meting music playback
  • Article Series - Series article organization
  • Instantpage - Page preloading acceleration
  • Snackbar - Elegant notification messages

🤝 Contributors

Thanks to all the developers who have contributed to the Butterfly theme!

Contributors

📸 Screenshots

Theme Demo

Theme Demo

Theme Demo

Theme Demo

⭐ Star History

Star History Chart

🤝 Building a Better Theme Together

We believe the power of open source comes from everyone's participation! Whether you're a developer, designer, or user, you can contribute to the development of the Butterfly theme.

💬 Get Help & Support

🎯 Contributing

Want to make Butterfly better? We welcome any form of contribution:

  • 🔧 Code Contributions - Fix bugs, add new features, optimize performance
  • 📝 Documentation - Improve docs, translate content, write tutorials
  • 🎨 Design Suggestions - UI/UX improvements, theme colors, icon design
  • 🧪 Testing & Feedback - Test new features, report issues, provide user experience
  • 💰 Financial Support - Sponsor the Project - Support long-term development

📄 License

This project is licensed under the Apache 2.0 License.

🙏 Acknowledgments

This theme is developed based on hexo-theme-melody. Thanks to the original author for their excellent work that provided inspiration and foundation!

Thanks to all friends who have contributed to the development of the Butterfly theme. Your support has made this theme continuously improve and progress.

✨ If this theme helps you, please give us a ⭐ Star! ✨