## 总览
------
# [Tangyuxian](https://www.tangyuxian.com)
> 糖羽仙深度定制的HEXO专属主题
## 贡献
> 本主题基于[**hexo-theme-nexmoe**](https://github.com/tangyuxian/hexo-theme-nexmoe)深度定制,感谢原作者开源
>
## 演示
[**糖羽仙**](https://www.tangyuxian.com)
## 特色功能
1. 基于hexo-theme-nexmoe-4.2.2深度定制,继承其所有优点,扩展性更高,兼容性更强;
2. 主题色百变搭配,将想象力全权交给您
3. 本地搜索功能与互联网搜索功能控件自由切换,随心而改
4. 动态看板娘与静态立绘板互相组合,动静结合互相辉映
5. 右侧时钟天气控件,自由开关,看文学习不忘记时间,天气变化随时注意,细微之处皆是关怀
6. ~~即时通讯插件自由开关,让联系您的人与您实时沟通,不错过任何一次机会~~
7. 更多特色等待您来探索
## 教程
1. 使用本主题包前请阅读[HEXO官方文档](https://hexo.io/zh-cn/docs/),本主题包仅适用于HEXO,请确认您已安装HEXO相关依赖
2. 开始使用本主题
- 运行以下命令以安装 Tangyuxian：
```
npm install hexo-theme-tangyuxian hexo-renderer-inferno
```
- 使用Tangyuxian
- 方法1 在项目的根目录中编辑 `_config.yml`。将名为 `theme` 的键的值更改为 `tangyuxian`
- 方法2
```
hexo config theme tangyuxian
```
- 配置tangyuxian
在项目的根目录中编辑 `_config.tangyuxian.yml`。
- 设置文章信息
```
---
title: 此处为标题
date: 此处为时间
tags:
- 标签1
- 标签2
categories:
- 分组名
cover: /images/post/markerdown.jpg(可选:封面地址,可以是相对也可以是绝对路径)
coverWidth: 1200(可选:封面宽度)
coverHeight: 320(可选:封面高度)
author:文章作者(可选)
from:文章来源(可选)
---
```
- 自动通过标签来匹配封面
在`_config.tangyuxian.yml`的`tagsCovers`下可配置对应类型的封面，默认内置了常见封面，可直接使用，也可自行配置封面。
- 文章归档
为了让文章归档到一个页面,请在项目的根目录`/source/`下创建`archives.md`文件,文件内填写如下内容即可:
```
---
title: 文章归档
layout: archives
permalink: archives.html
---
```
- 更多...
3. 修改本主题并在本地使用方法
在根目录的`package.json`中增加配置项
```json
"workspaces": [
"packages/*"
]
```
在根目录创建文件夹`packages`，将本主题下载后放到该文件夹里，然后在根目录的`package.json`中修改内容
```
"hexo-theme-tangyuxian": "workspace:^"
```
之后就可以在本地随时修改本主题
4. 以下是本主题包的目录结构图
```
├── languages //国际化语言包
├── layout //ejs模板布局文件夹
├── scripts //自定义执行脚本
├── source //静态资源文件夹
├── package.json //node配置项
└── README.md //说明文档
```
5. ~~即时通讯插件~~
~~`daovoice`需要您到[daovoice官网](http://dashboard.daovoice.io/)申请key并配置~~
6. 主题色个性化配置
默认配置内容如下：
```css
:root {
--gutter: 24px;
--radius: 13px;
--color-primary: #e67249;
--color2: rgba(255, 118, 30, 0.5);
--color3: #ffb900;
--color4: #33d57a;
--color5: #00dbff;
--color6: #1a98ff;
--color7: #9090ff;
--color-primary-bg: rgba(255, 78, 106, 0.15);
--color2-bg: rgba(255, 118, 30, 0.15);
--color3-bg: rgba(255, 185, 0, 0.15);
--color4-bg: rgba(51, 213, 122, 0.15);
--color5-bg: rgba(0, 219, 255, 0.15);
--color6-bg: rgba(26, 152, 255, 0.15);
--color7-bg: rgba(144, 144, 255, 0.15);
--color-shadow: rgba(161, 177, 204, 0.4);
--color-card: #fff;
--color-text-1: #111;
--color-text-2: #444;
--color-text-3: #363636;
--clock-logo:url("/images/background/clock_logo.png");
--qweather-logo:url("/images/background/clock_logo.png");
--character:url("/images/background/character.png");
}
```
其中 `--clock-logo` 是时钟中间显示的图片，`--qweather-logo`是天气旁边显示的图片，`--character`是左侧的立绘图片，在根目录中的 `_config.tangyuxian.yml` 中设置 `customStyles` 的值。 默认配置如下：
yaml
```
customStyles:
- custom.css
- themes/umaru/index.css
```
然后，在名为 `source` 的路径中创建和配置对应路径的文件。这样就可以编写自己的自定义样式，下面会覆盖上面，注意顺序。
7. 本地搜索功能依赖
参考[hexo-generator-search](https://www.npmjs.com/package/hexo-generator-search),配置相关参数,用于生成`search.xml`,本地搜索依赖该文件进行检索
8. 看板娘配置方法
参考[hexo-helper-live2d](https://github.com/tangyuxian/hexo-helper-live2d)配置看板娘插件.
附赠更多丰富的看板娘插件[live2D大礼包](https://github.com/tangyuxian/live2D)(ps:里面有超级萌小埋哦)
## 许可
> 根据 Apache License 2.0 许可证开源。
## 卖萌
喜欢的小伙伴记得start哦