{"id":19597894,"url":"https://github.com/willow-god/hexo-theme-liushen","last_synced_at":"2025-10-24T21:12:20.864Z","repository":{"id":262113103,"uuid":"886252179","full_name":"willow-god/hexo-theme-liushen","owner":"willow-god","description":"🫠柳神的主题仓库，目前正在开发中，请谨慎使用，由于学业原因，不提供部署帮助","archived":false,"fork":false,"pushed_at":"2024-11-10T15:53:02.000Z","size":1044,"stargazers_count":6,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T03:41:35.418Z","etag":null,"topics":["css","hexo","hexo-theme","javascript","pug","stylus"],"latest_commit_sha":null,"homepage":"https://blog.liushen.fun","language":"Stylus","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/willow-god.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-10T15:39:59.000Z","updated_at":"2025-03-18T01:01:21.000Z","dependencies_parsed_at":"2024-11-10T16:37:56.256Z","dependency_job_id":"656584f6-643d-40e2-8359-503893a62952","html_url":"https://github.com/willow-god/hexo-theme-liushen","commit_stats":null,"previous_names":["willow-god/hexo-theme-liushen"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willow-god%2Fhexo-theme-liushen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willow-god%2Fhexo-theme-liushen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willow-god%2Fhexo-theme-liushen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willow-god%2Fhexo-theme-liushen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/willow-god","download_url":"https://codeload.github.com/willow-god/hexo-theme-liushen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253823748,"owners_count":21969903,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","hexo","hexo-theme","javascript","pug","stylus"],"created_at":"2024-11-11T09:03:19.994Z","updated_at":"2025-10-24T21:12:20.789Z","avatar_url":"https://github.com/willow-god.png","language":"Stylus","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1 style=\"background: linear-gradient(to right, #76CBEC, #F7A137); -webkit-background-clip: text; color: transparent; font-size: 4.4rem\"\u003ehexo-theme-LiuShen\u003c/h1\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  一个基于 hexo-theme-butterfly 的定制化 Hexo 博客主题，具有独特的风格和各种各样的功能，可爱又不臃肿，漂亮而不奢华！\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://fastly.jsdelivr.net/gh/god-willow/pic@main/pic/202411102327875.webp\" alt=\"hexo-theme-LiuShen\"\u003e\n\u003c/p\u003e\n\n## 🚧 正在开发\n\n目前此主题仍在开发中，功能尚未完善，可能无法正常使用。如对 Hexo 主题配置不熟悉，请暂勿使用。\n\n---\n\n## 说明\n\nhexo-theme-LiuShen 是基于 [hexo-theme-butterfly](https://github.com/jerryc127/hexo-theme-butterfly.git) 的个性化改进版本。除了延续 Butterfly 的设计风格，本主题加入了更多样化的视觉效果和功能，适合喜爱极简设计又注重功能性的用户。\n\n### 💻 安装方法\n\n#### Git 安装（推荐）\n\n在博客根目录中，执行以下命令，安装最新版本：\n\n```bash\ngit clone https://github.com/willow-god/hexo-theme-liushen.git themes/liushen\n```\n\n#### npm 安装（仅支持 Hexo 5.0.0 以上版本）\n\n在博客根目录中执行：\n\n```bash\nnpm i hexo-theme-liushen\n```\n\n### ⚙ 应用主题\n\n1. 打开 Hexo 的配置文件 `_config.yml`\n2. 将 `theme` 字段修改为 `liushen`：\n\n   ```yaml\n   theme: liushen\n   ```\n\n\u003e 注意：请确保已安装 pug 和 stylus 渲染器，执行以下命令进行安装：\n\u003e\n\u003e ```bash\n\u003e npm install hexo-renderer-pug hexo-renderer-stylus --save\n\u003e ```\n\n---\n\n## 🎉 主题特色功能\n\n### 设计风格\n\n- **卡片化设计**：支持卡片式排版，使内容层次更清晰。\n- **自定义圆角/直角设计**：用户可以自由选择卡片样式，以适配不同审美。\n- **响应式布局**：支持 PC 和移动端自适应，体验一致。\n- **支持暗黑模式**：自动或手动切换夜间模式，保护眼睛。\n\n### 页面布局\n\n- **双栏布局**：双栏内容展示，方便浏览和导航。\n- **二级目录支持**：支持复杂文章目录层级，适合长文结构化展示。\n- **动态文章封面**：展示文章封面，提升视觉吸引力。\n\n### 内容展示\n\n- **多样化代码高亮配色**：支持 darker、pale night、light、ocean 等多种代码主题风格，满足不同的审美需求。\n- **文章阅读模式**：增强文章阅读体验，加入 TOC 目录、字数统计等小功能。\n- **简繁体切换**：支持简体、繁体内容切换。\n- **过期文章提醒**：可自定义设置过期提示，确保信息有效性。\n\n### 功能扩展\n\n- **搜索功能**：提供 Algolia 搜索、本地搜索等多种选择，帮助用户快速找到内容。\n- **评论系统**：集成 Disqus、Gitalk、Valine 等多种评论工具，并支持双评论系统。\n- **社交分享**：支持 Sharejs、Addtoany 等多种分享选项，提升内容传播。\n- **访客统计**：集成不蒜子访客统计，实时记录站点访客情况。\n\n### 特效和交互\n\n- **动态背景**：提供静态和彩带、Canvas Nest 动态背景，让网页更具趣味性。\n- **鼠标点击特效**：多种鼠标点击效果，如烟花、爱心等，提升互动体验。\n- **加载动画**：内置 Preloader 动画和 pace.js 加载动画条，提升网页加载视觉体验。\n\n### 工具与增强\n\n- **PWA 支持**：支持 Progressive Web App，提升移动端访问体验。\n- **SEO 优化**：支持站长验证及优化的 SEO 配置。\n- **多种图表支持**：内置 Mermaid 图表展示、照片墙等插件，适合丰富的内容展示场景。\n\n---\n\n## 🔧 常见问题\n\n### 如何切换暗黑模式？\n\n进入 `_config.yml` 配置文件，找到 `dark_mode` 配置项，选择 `true` 即可开启夜间模式：\n\n```yaml\ndark_mode: true\n```\n\n### 如何更改主题配色？\n\nLiuShen 主题允许通过配置文件 `_config.yml` 更改站点的整体配色。找到 `theme_color` 项，填写所需颜色值：\n\n```yaml\ntheme_color: \"#FF6B6B\"  # 示例颜色\n```\n\n---\n\n## 📝 常见问题与支持\n\n1. **主题不完整或功能缺失**  \n   由于主题仍在开发中，部分功能可能尚未完善，如遇到问题可在 GitHub 提交 Issue。\n\n2. **代码高亮或特效异常**  \n   若部分特效或代码高亮异常，可尝试在配置文件中关闭或选择其他模式。\n\n3. **其他问题**  \n   如有其他问题，建议查看 [hexo-theme-butterfly](https://github.com/jerryc127/hexo-theme-butterfly.git) 的文档，本主题基于 Butterfly，许多配置方法通用。\n\n---\n\n### 📜 版权与声明\n\n- 本项目基于 Butterfly 开发，但保留部分独有功能。\n- 若引用请遵循开源协议注明来源。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillow-god%2Fhexo-theme-liushen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwillow-god%2Fhexo-theme-liushen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillow-god%2Fhexo-theme-liushen/lists"}