<h1 align="center">hexo-theme-async</h1>

<div align="center">

[Gitee](https://gitee.com/ml13/hexo-theme-async) ｜
[演示](https://hexo-theme-async.imalun.com/demosite/) ｜
[示例预览](https://www.imalun.com) ｜
[使用文档](https://hexo-theme-async.imalun.com/)

一个简单而轻量级的 Hexo 主题。

</div>

<p align="center">
  <a title="Github release" target="_blank" href="https://github.com/MaLuns/hexo-theme-async/releases">
    <img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/Maluns/hexo-theme-async?logo=github">
  </a>
  <a title="Npm Version" target="_blank" href="https://www.npmjs.com/package/hexo-theme-async">
    <img src="https://img.shields.io/npm/v/hexo-theme-async?logo=npm&color=%09%23bf00ff" alt="https://img.shields.io/npm/v/hexo-theme-async?color=%09%23bf00ff">
  </a>
  <a title="Hexo Version" target="_blank" href="https://hexo.io/zh-cn/">
    <img src="https://img.shields.io/badge/hexo-6.3.0+-0e83c?logo=hexo" alt="hexo version">
  </a>
	<img src="https://img.shields.io/badge/v14.x-x?logo=node.js&label=node" alt="node version">
  <img src="https://img.shields.io/github/languages/code-size/MaLuns/hexo-theme-async?logo=Visual Studio Code&logoColor=blue" alt="GitHub code size in bytes">
  <a title="GitHub Discussions" target="_blank" href="https://github.com/MaLuns/hexo-theme-async/discussions">
    <img src="https://img.shields.io/github/discussions/MaLuns/hexo-theme-async?color=9cf&logo=github" alt="GitHub Discussions">
  </a>
  <a title="SATA License" target="_blank" href="https://github.com/zTrix/sata-license">
    <img src="https://img.shields.io/badge/license-SATA-green.svg" alt="SATA License">
  </a>
</p>

<p align="center">
  🇨🇳 中文简体  |  
  <a title="English" href="README.md">🇬🇧 English</a>
</p>

<p align="center">
  <img width="80%" style="border-radius:8px;" src="docs/public/imgs/demo2.png" alt="demo.png" border="0" />
</p>

## 文档

一份详细的使用文档，能解决你大部分不清楚地方了🤣

- 中文文档：
    - <https://hexo-theme-async.imalun.com> (dev)
    - <https://async-docs.imalun.com> (master)
- 英文文档：
    - <https://hexo-theme-async.imalun.com/en/guide/> (dev)
    - <https://async-docs.imalun.com/en/guide/> (master)

## 安装

安装 hexo-theme-async、less、ejs 等插件

``` bash
npm install --save hexo-theme-async hexo-renderer-less hexo-renderer-ejs
```

或者

``` bash
yarn add --save hexo-theme-async hexo-renderer-less hexo-renderer-ejs
```

您可以创建一个 \_config.async.yml 来覆盖主题默认 \_config.yml  中配置，可以参考 [Hexo Docs](https://hexo.io/zh-cn/docs/configuration#%E4%BD%BF%E7%94%A8%E4%BB%A3%E6%9B%BF%E4%B8%BB%E9%A2%98%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6)

## 更新

你只需要执行:

``` bash
npm install hexo-theme-async@latest
```
## 参与贡献
非常欢迎你的贡献，你可以通过以下方式一起共建 :smiley:：

- 遇到 Bug 通过提交 [Issue](https://github.com/MaLuns/hexo-theme-async/issues) 报告。
- 有建议和疑问欢迎前往 [Discussions](https://github.com/MaLuns/hexo-theme-async/discussions) 讨论。
- 提交 Pull Request 改进 **Hexo-theme-async** 的代码。


## 协议

本主题采用 [SATA License](https://github.com/zTrix/sata-license)。

> 你不知道这代表什么？简单来说，就是如果你使用了该主题，你需要马不停蹄地点一个 Star，接下来你便可以随意使用它。

## 演示站点

如果你已经使用了本主题，欢迎前往 [Demo Sites | 示例站点 | Discussions](https://github.com/MaLuns/hexo-theme-async/discussions/7) 留下你的站点，我将会将其添加到下方的示例站点中。

也可以直接修改 [sites.json](https://github.com/MaLuns/hexo-theme-async/blob/dev/docs/.vitepress/assets/sites.json) 创建 PR。

<!-- demo-start -->
<table>
  <tr align="center">
        <td>
            <a href="https://hexo-theme-async.imalun.com/demosite/" target="_blank">
                <img width="80px" src="https://hexo-theme-async.imalun.com/demosite/img/favicon.svg" />
                <br />
                <sub title="主题默认示例">默认示例</sub>
            </a>
        </td>
        <td>
            <a href="https://yxy.imalun.com" target="_blank">
                <img width="80px" src="https://yxy.imalun.com/images/avatar.gif" />
                <br />
                <sub title="两人对酌山花开，一杯一杯复一杯。我醉欲眠卿且去，明朝有意抱琴来。">游小游</sub>
            </a>
        </td>
        <td>
            <a href="https://blog.offends.cn" target="_blank">
                <img width="80px" src="https://blog.offends.cn/img/avatar.png" />
                <br />
                <sub title="现充爆炸吧">Offends</sub>
            </a>
        </td>
        <td>
            <a href="https://blog.shawn404.top/" target="_blank">
                <img width="80px" src="https://blog.shawn404.top/img/logo.svg" />
                <br />
                <sub title="Strive hard and work novelty">Shawn's Blog</sub>
            </a>
        </td>
        <td>
            <a href="https://dracewang.github.io/" target="_blank">
                <img width="80px" src="https://s2.loli.net/2023/10/09/XwlqZH67cJo2NC5.jpg" />
                <br />
                <sub title="江湖险恶，不行就撤">Hexagon</sub>
            </a>
        </td>
        <td>
            <a href="https://cyphersun.github.io/" target="_blank">
                <img width="80px" src="https://avatars.githubusercontent.com/u/80212458?v=4" />
                <br />
                <sub title="吾日百省，知行合一">CypherSun</sub>
            </a>
        </td>
      </tr>
</table>
<!-- demo-end -->