本篇主要是博客的搭建
Hexo + Gitee 博客搭建详细指南
- hexo安装
-
- Hexo简介
- Hexo安装
- hexo主题修改
- Gitee配置
-
- 创建gitee公开仓库
- 安装部署命令
- 配置 _confing.yml
- hexo 推送
- 开启GiteePages
- 效果
hexo安装
Hexo简介
Hexo是一款基于Node.js的静态博客框架,依赖少易于安装使用,可以方便的生成静态网页托管在GitHub和Coding上。
Hexo安装
- 安装git,略
- 安装node.js,略
- 安装hexo
cmd或右键git bash都行,安装hexo
npm install -g hexo-cli
hexo -v 查看hexo版本
在这里插入代码片
找个blog路径,初始化hexo,自动创建了myblog文件夹
hexo init myblog
cd myblog
npm install
生成文件如图,_config.yml 为全局配置文件
hexo g --生成网站静态文件到默认设置的 public 文件夹
hexo s --启动本地服务器,默认地址:http://localhost:4000/
补充:hexo clean
清除缓存文件 db.json 和已生成的静态文件 public。
网站显示异常时可以执行这条命令试试。
有时候端口会被其他占用,添加 参数 -p 5000(端口号),修改即可
已经成功启动本地hexo,效果如下
hexo主题修改
https://hexo.io/themes/
可以到这里选个喜欢的主题模版
我选择的是Butterfly主题
git拉取到themes文件夹下,方便之后更新。
修改文件名 hexo-theme-butterfly为butterfly
修改myblog文件夹下全局配置文件
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: butterfly
hexo s 部署下,可以看到效果
其他:
主题也可以通过npm方式安装,这种方式就不在themes目录下,而在node_modules目录,详情可以看各主题的文档说明
Gitee配置
创建gitee公开仓库
仓库名必须是用户名
各种博客里面仓库都是 用户名.gitee.io或者gitee.io,导致访问路径不对,样式也没有。
giteepages页有使用帮助
安装部署命令
npm install hexo-deployer-git --save
配置 _confing.yml
找到deploy,配置gitee仓库
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repository: https://gitee.com/rainscloud/rainscloud.git
branch: master
其他
创建仓库时的README.md描述文件会被hexo 提交覆盖掉。
在source目录下创建README.md
在_confing.yml配置中找到skip_render添加
skip_render: README.md
hexo 推送
hexo c -- 清除缓存json和生成的静态文件
hexo g --生成静态文件
hexo d --上传到git
开启GiteePages
服务里面Gitee Pages 启动
效果
本篇主要完成博客的搭建,后续继续对其中各功能进行丰富。