halo-theme-hao/README.md

194 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
<!-- 主题Logo -->
<img width="100px" src="https://liuzhihang.com/upload/logo.png">
<!-- 主题名称 -->
<h1>Halo-Theme-Hao</h1>
<!-- 主题徽章 -->
<p align="center">
<!-- halo版本 -->
<a href="https://github.com/halo-dev/halo"><img alt="Halo version" src="https://img.shields.io/badge/dynamic/yaml?label=Halo&query=%24.spec.require&url=https://raw.githubusercontent.com/liuzhihang/halo-theme-hao/master/theme.yaml&logo=data:image/webp;base64,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" /></a>
<!-- 下载总数 -->
<a href="https://github.com/liuzhihang/halo-theme-hao/releases"><img alt="size" src="https://img.shields.io/github/downloads/liuzhihang/halo-theme-hao/total.svg?style=flat-square""/></a>
<!-- 许可协议 -->
<a href="./LICENSE"><img alt="LICENSE" src="https://img.shields.io/badge/license-GPL-yellow.svg"></a>
</p>
<!-- 快捷导航 -->
<p align="center">
[主题预览](#-预览) | [快速上手](#-安装) | [使用文档](https://docs.liuzhihang.com) | [加入我们](#-讨论)
</p>
</div>
<!-- 主题预览图 -->
<table>
<tr>
<td>
<img src="https://liuzhihang.com/upload/hao_white.jpg"/>
</td>
<td>
<img src="https://liuzhihang.com/upload/hao_dark.jpg"/>
</td>
</tr>
</table>
## 🔥 预览
| 站点名称 | 站点地址 |
|:--------:|:-------------------------:|
| 程序员小航 | https://liuzhihang.com |
| 小孙同学 | https://blog.sunguoqi.com |
| 流殃 | https://shyblog.world |
| 羡羡 | https://www.hydsb0.com/ |
| 困困鱼 | https://0206.ink |
| Top John | https://op-lab.top |
| Roozen | https://roozen.top |
| Lanbin | https://lib.lanbin.top |
## 👋 简介
[Halo-Theme-Hao](https://github.com/liuzhihang/halo-theme-hao) 是一款适用于 [Halo2.x](https://github.com/halo-dev/halo) 的博客主题。
移植自 [Hexo](https://hexo.io/zh-cn/index.html) 社区中 [张洪 Heo](https://blog.zhheo.com/)
对 [Hexo-Theme-Butterfly](https://github.com/liuzhihang/halo-theme-hao)
主题的魔改版本。
## 🚨 注意事项(看我看我)
1. **建站时间必填**
2. 如果安装主题后报错,请仔细查阅[主题说明](https://github.com/liuzhihang/halo-theme-hao)与[更新说明](https://github.com/liuzhihang/halo-theme-hao/releases)
3. 如果还未解决,可以加群求助!!!
4. 如果群友也解决不了再考虑提ISSUE
5. `1.3.1`及以上版本需要`Halo`版本>=`2.8.0`
6. **若安装主题后出现500错误请到主题设置页面将每个设置项都保存一下**
## 🛠 安装
### 🚗 自动安装
1. 点击 [此链接](https://halo.run/store/apps/app-MgZJX) 进入 Halo 官方应用市场,找到本主题
2. 点击左下角 `下载` 按钮
3. 弹出的对话框中,输入自己的网站地址,点击安装
### 🚲 手动安装
#### 🚂 本地安装
1. 在 [ Release](https://github.com/liuzhihang/halo-theme-hao/releases) 页面 `下载` 最新主题包 (zip)
2. 进入 Halo 后台 -> 主题 (左侧面板)
3. 点击右上角 “主题”, 在弹出的窗口中选择 `安装主题`
4. 选择下载好的主题包zip
5. 安装完成后的主题将会出现在 “未安装” 内,点击 `启用主题`
#### 🛸 远程安装
1. 复制地址 `https://github.com/liuzhihang/halo-theme-hao`
2. 进入Halo后台 -> 外观 -> 主题 (左侧面板)
3. 点击右上方 `安装` 按钮, 然后选择 `远程下载`
4. 在文本框中粘贴仓库地址后点击下载
### 🔌 插件依赖
> 所有插件均为可选,不安装则不会出现对应功能。
> 部分插件可能已经预设在 Halo 内。
> 部分插件主题尚未适配。
- 评论功能 [plugin-comment-widget](https://github.com/halo-sigs/plugin-comment-widget/releases)
- 搜索功能 [plugin-search-widget](https://github.com/halo-sigs/plugin-search-widget/releases)
- 友链页面 [plugin-links](https://github.com/halo-sigs/plugin-links)
- 瞬间页面 [plugin-moments](https://github.com/halo-sigs/plugin-moments)
- 代码高亮 [plugin-prismjs](https://github.com/liuzhihang/plugin-prismjs)
- 图片懒加载 [plugin-lazyload](https://github.com/liuzhihang/plugin-lazyload)
- 追番插件 [plugin-bilibili-bangumi](https://github.com/Roozenlz/plugin-bilibili-bangumi)
- 图库插件 [plugin-photos](https://github.com/halo-sigs/plugin-photos)
- Tool-Bench [Tool-Bench](https://github.com/DioxideCN/Tool-Bench)
> 更多插件请参见https://github.com/halo-sigs/awesome-halo
## 📝 使用
正在编写的文档,[点我查看](https://docs.liuzhihang.com)
## 🔐 许可
[Halo-Theme-Hao](https://github.com/liuzhihang/halo-theme-hao) 使用 [GPL-v3.0](./LICENSE) 协议开源,请遵守开源协议。
## 💬 讨论
如果你对主题有什么建议或者意见,欢迎提 PR & issue。
想了解更多信息可以关注 「 程序员小航 」。
发送 "hao 群" 可以加群 (群验证信息最好是个人网站)
发送"加好友",可以加我微信,我拉你进群 (群二维码失效时)
<img width="360" src="https://liuzhihang.com/themes/theme-hao/assets/images/wechat/wechat1.png" />
> 卖服务器的广告人,就不要加了。
## 👨‍💻 贡献
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)) :)
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-14-orange.svg?style=flat-square)](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="16.66%"><a href="https://liuzhihang.com/"><img src="https://avatars.githubusercontent.com/u/26057042?v=4?s=100" width="100px;" alt="liuzhihang"/><br /><sub><b>liuzhihang</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=liuzhihang" title="Code">💻</a> <a href="#tutorial-liuzhihang" title="Tutorials"></a></td>
<td align="center" valign="top" width="16.66%"><a href="https://shyblog.world/"><img src="https://avatars.githubusercontent.com/u/50973219?v=4?s=100" width="100px;" alt="sunheyi"/><br /><sub><b>sunheyi</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=shy-share" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://github.com/Joydevelop"><img src="https://avatars.githubusercontent.com/u/79132319?v=4?s=100" width="100px;" alt="Joy"/><br /><sub><b>Joy</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=Joydevelop" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://johnniang.me"><img src="https://avatars.githubusercontent.com/u/16865714?v=4?s=100" width="100px;" alt="John Niang"/><br /><sub><b>John Niang</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=JohnNiang" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://lanbinovo.cn"><img src="https://avatars.githubusercontent.com/u/62149873?v=4?s=100" width="100px;" alt="Lanbin"/><br /><sub><b>Lanbin</b></sub></a><br /><a href="#tutorial-lanbinshijie" title="Tutorials"></a></td>
<td align="center" valign="top" width="16.66%"><a href="https://blog.sunguoqi.com/"><img src="https://avatars.githubusercontent.com/u/79169717?v=4?s=100" width="100px;" alt="小孙同学"/><br /><sub><b>小孙同学</b></sub></a><br /><a href="#tutorial-sun0225SUN" title="Tutorials"></a> <a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=sun0225SUN" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="16.66%"><a href="http://airbozh.cn"><img src="https://avatars.githubusercontent.com/u/50261327?v=4?s=100" width="100px;" alt="airbo"/><br /><sub><b>airbo</b></sub></a><br /><a href="#tutorial-AirboZH" title="Tutorials"></a> <a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=AirboZH" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://github.com/gadore"><img src="https://avatars.githubusercontent.com/u/18081104?v=4?s=100" width="100px;" alt="Gadore"/><br /><sub><b>Gadore</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=gadore" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://www.hydsb0.com"><img src="https://avatars.githubusercontent.com/u/64968400?v=4?s=100" width="100px;" alt="羡羡"/><br /><sub><b>羡羡</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=xyhcode" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://github.com/chengzhongxue"><img src="https://avatars.githubusercontent.com/u/89380218?v=4?s=100" width="100px;" alt="困困鱼"/><br /><sub><b>困困鱼</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=chengzhongxue" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://op-lab.top"><img src="https://avatars.githubusercontent.com/u/7914367?v=4?s=100" width="100px;" alt="Top John"/><br /><sub><b>Top John</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=TopJohn" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://khbit.cn"><img src="https://avatars.githubusercontent.com/u/72146468?v=4?s=100" width="100px;" alt="BugJi"/><br /><sub><b>BugJi</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=daizihan233" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="16.66%"><a href="http://roozen.top"><img src="https://avatars.githubusercontent.com/u/93673944?v=4?s=100" width="100px;" alt="Roozen"/><br /><sub><b>Roozen</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=Roozenlz" title="Code">💻</a></td>
<td align="center" valign="top" width="16.66%"><a href="https://www.stonewu.com/"><img src="https://avatars.githubusercontent.com/u/25025423?v=4?s=100" width="100px;" alt="石头君"/><br /><sub><b>石头君</b></sub></a><br /><a href="https://github.com/liuzhihang/halo-theme-hao/commits?author=Stonewuu" title="Code">💻</a></td>
</tr>
</tbody>
<tfoot>
<tr>
<td align="center" size="13px" colspan="6">
<img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
<a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
</img>
</td>
</tr>
</tfoot>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
## 📊 指标
![Alt](https://repobeats.axiom.co/api/embed/7cb154a9a3fe9cda4fe1a982bdd20adb760edf20.svg "Repobeats analytics image")
> 本项目使用 JetBrains IDEA 进行开发
<a href="https://www.jetbrains.com/?from=Toolkit"><img src="https://cdn.jsdelivr.net/gh/liuzhihang/oss/pic/article/jetbrains-logo-MrNwcp.png" width="10%" height="10%"></a>
<a href="https://www.jetbrains.com/?from=Toolkit"><img src="https://cdn.jsdelivr.net/gh/liuzhihang/oss/pic/article/idea-logo-XpnqgG.png" width="10%" height="10%"> </a>