Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xinetzone/docs
https://github.com/xinetzone/docs
ai blog hexo katex
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/xinetzone/docs
- Owner: xinetzone
- License: apache-2.0
- Created: 2020-11-18T09:29:18.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-02-09T00:52:34.000Z (almost 4 years ago)
- Last Synced: 2024-10-30T01:55:33.733Z (3 months ago)
- Topics: ai, blog, hexo, katex
- Homepage: https://xinetzone.github.io/dao
- Size: 7.52 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dao
刘新伟的博客
[](https://github.com/xinetzone/xinetzone.github.io/issues) [](https://github.com/xinetzone/xinetzone.github.io/network) [](https://github.com/xinetzone/xinetzone.github.io/stargazers) [](https://github.com/xinetzone/xinetzone.github.io/blob/master/LICENSE) [](http://hits.dwyl.io/xinetzone/xinetzone.github.io)  [](https://github.com/xinetzone/xinetzone.github.io/graphs/contributors) [](https://github.com/xinetzone/xinetzone.github.io/watchers) [](https://badge.fury.io/gh/xinetzone%2Fxinetzone.github.io)
本项目基于 [blinkfox/hexo-theme-matery](https://github.com/blinkfox/hexo-theme-matery) 修改了一个 matery 主题网站的搭建的模板。由于 MathJax 加载速度慢，不能很好的支持公式对齐，所以将其替换为 Katex。
## 如何使用
1. `star` 本项目之后，可以直接`fork`一份源码到您的仓库（需要将 `dao` 改成您自己的`账户名称.github.io`），然后 `clone` 到本地磁盘
2. 安装 [Git](https://git-scm.com/downloads)，[node.js](https://nodejs.org/en/)，为了支持 Katex 需要安装 [Pandoc](https://pandoc.org/installing.html)
3. 使用命令 `npm i -g hexo-cli` 安装 Hexo
4. 在本地博客仓库进入到 `docs/` 目录，运行 `npm install` 命令安装依赖包
5. 仍然在 `docs/` 目录下，运行 `hexo s` 便可在本地预览网站。
6. 修改配置 `docs/_config.yml` 和 `docs/themes/hexo-matery/_config.yml` 信息，改成您自己的信息
7. 替换 `docs/themes/hexo-matery/source/medias/reward` 之下的二维码为您自己的
8. 运行命令`hexo clean`（清除生成文件），`hexo g`（生成网页）， `hexo s`（本地预览），`hexo d`（部署），详细教程可参考 Hexo 官方网站：[写作](https://hexo.io/zh-cn/docs/writing)
因为本网站是支持多语种的（详细内容见 [多语种的网站](https://hexo.io/zh-cn/docs/permalinks.html)），所以当您建立新文章时，最好使用如下格式：
```sh
$ hexo new "Hello World" --lang zh-CN
# => source/_posts/zh-CN/Hello-World.md
```
其中 `zh-CN` 表示简体中文。
最终的网站的成品：，其中 `xinetzone` 改成您自己的账户名称即可。
## 自定义主题
您可以修改一些主题设置：
### 1 修改网站的友情链接
修改 `docs/source/_data/friends.json`，比如：
```json
{
"avatar": "https://xinetzone.github.io/medias/avatars/cnblogs.jpg",
"name": "写意生活",
"introduction": "博客园",
"url": "https://www.cnblogs.com/q735613050/",
"title": "欢迎进入个人博客"
}
```
其中 `"avatar"` 是友情链接的图标，放在 `themes/matery/source/medias/avatars/cnblogs.jpg` 之下。
### 2 在主页添加自定义音乐播放
在 `themes/matery/source/medias/` 目录下创建 `music/` 目录，并将需要的音乐放进入；接着修改文件 `docs/source/_data/musics.json`。比如：
```json
{
"name": "出山",
"artist": "花粥",
"url": "/medias/music/出山.mp3",
"cover": "/medias/music/avatars/chushan.jpg"
}
```
其中 `"name"`，`"artist"`，`"cover"` 分别表示歌曲名字，歌者，封面。歌曲的封面的获取可以使用如下方法（firefox 浏览器）：
首先，进入网易云音乐的网页：，搜索您想要的歌曲，比如："出山"，然后按键 `F12`，弹出如下界面：
接着选择 `无障碍环境`，然后按照下图指示找到 `DOMNode:img.j-img` 并用鼠标点击：
接着，可在下图的对应位置找到封面的链接：
最后，将链接的 `?param=130y130` 部分删除，便可直接保存封面图片了。
### 3 添加 gitalk 支持
修改 `docs/themes/matery/_config.yml` 中的 gitalk 配置为：
```json
gitalk:
enable: true
owner: xinetzone # 您的账户名称
repo: xinetzone.github.io # 网站域名，即“账户名称.github.io”
oauth:
clientId: # 填入
clientSecret: # 填入
admin: xinetzone # 您的账户名称
```
## 可能存在的问题
### 1. RPC failed
当您使用 `git clone` 克隆本仓库，而不是使用 `git clone --recurse` 时，如若报下面的错误：
```sh
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
ffatal: the remote end hung up unexpectedly
atal: early EOF
fatal: index-pack failed
```
可以在终端输入如下命令解决：
```sh
$ git config --global http.postBuffer 524288000
```
如果使用过程中有什么问题可以在文章最后评论区**留言和讨论**，如果觉得文章有用，请:smile:打赏按键：
## 未完成计划
查看 hits：
- [ ] 学习[给自己的博客加上看板娘——Live2d蕾姆 | 雷姆](https://zhuanlan.zhihu.com/p/35351118)
- [ ] [hexo博客添加一级分类相册功能](https://liyangzone.com/2019/07/22/hexo博客添加一级分类相册/)