前言
- 前段时间博客园整改，许多博客无法查看，偶然的机会接触到了许多博客框架，可用来快速搭建一个静态博客网站；最后选择使用hexo，看了不少大佬的教程，觉得挺有意思的，于是也总结了一下自己的搭建步骤，可供大家交流
- 写的不对的地方，欢迎指正哦
前期准备
- 安装nodejs，打开cmd输入node -v，显示版本表示安装成功
- 安装git，打开cmd输入git --version，显示版本表示安装成功
- 拥有一个github账号，没有需要注册：https://github.com/
搭建博客
- 登录自己的github账号，创建一个仓库：GitHub账号名.github.io ，勾选README初始化
- 选择一个默认的主题：Settings > GitHub Pages > Choose a theme，点击GitHub pages自动分配的网址预览
- 安装hexo
//选择一个文件夹作为本地博客，右键 > Git Bash Here
npm i hexo-cli -g //安装Hexo
hexo -v //查看hexo版本
hexo init chniny-blog //新建并初始化一个文件
cd chniny-blog //进入文件夹
npm install //安装所需模块
npm install hexo-deployer-git --save //安装用于写markdown文档的模块
配置主题
- 下载next主题到本地（这里我选择的是next）：https://github.com/theme-next/hexo-theme-next
- 解压后，重命名为next，复制到themes文件夹
- 打开hexo根目录的站点配置文件_config.yml，将theme项配置为next
theme: next # 主题
推送到远程仓库
- 配置远程仓库地址
# 站点配置文件
deploy:
type: git # 项与值之间必须存在一个空格
repository: https://github.com/chniny/chniny.github.io.git
branch: main # GitHub创建的仓库默认的分支名
- 推送
# 博客文件根目录右键 > Git Bash Here
hexo c # 清楚缓存
hexo g # 生成静态文件
hexo s # 启动本地服务，浏览器输入http://localhost:4000/可本地预览
hexo d # 推送到远程仓库
# 浏览器输入GitHub pages自动分配的网址查看主题是否设置成功
常用命令
hexo new post "文章名称" # 生成新的md文件
hexo g # 生成静态网页
hexo s # 启动服务器，可本地预览
hexo d # 推送到远程仓库网站主页
npm i hexo-cli -g # 安装Hexo
hexo -v # 查看hexo版本
hexo init # 初始化文件夹
hexo init chniny-blog # 初始化该文件夹没有则会创建
npm install # 安装所需模块
npm i hexo-deployer-git # 安装用于写博客的扩展
npm install hexo-deployer-git --save # 安装hexo部署到git page的deployer
hexo server -p 8080 # 切换服务器端口
hexo new page "pageName" # 新建页面
hexo d -g # 生成部署
hexo s -g # 生成预览
编写博客
- 本地博客根目录右键 > Git Bash Here
hexo new post "my blog" # Hexo\source\_posts目录下生成md文件
# 编写博客
hexo c # 清楚缓存
hexo g # 生成静态文件
hexo s # 可本地预览
hexo d # 推送到远程仓库
- 显示图片
# 站点配置文件打开本地资源管理
post_asset_folder: true
# Git Bash Here > 安装插件
npm install https://github.com/CodeFalling/hexo-asset-image --save
hexo n "标题" # 创建新文档时会同时生成对应的文件夹，用于存放图片
# 编写markdown，插入图片
{% asset_img 图片名.jpg 描述 %}
自定义域名
- 可在阿里云购买域名，需要实名认证；购买后解析
- GitHub > Settings > Custom domain > 设置自己的域名（这里我是www.chniny.co）
- 打开本地博客文件夹 > source > 创建CNAME文件，不要后缀 > 先用记事本打开写上www.chniny.co 然后去点文件后缀
- 最后推送
备份
- 例如我的本地博客是在GitPages目录下：D:\GitPages\chniny-blog
- 在GitPages文件夹，右键 > Git Bash Here
git init # 初始化为本地仓库
git add chniny-blog # 添加到暂存区
git commit -m "myblog" # 提交
git remote add origin [email protected]:用户名/仓库名.git # 关联远程仓库
git push <远程主机名> <本地分支名>:<远程分支名> # 推送
详细配置
- hexo主题：https://hexo.io/themes/
- 搭建参考教程：https://zhuanlan.zhihu.com/p/35668237
- 站点配置文件详解
- 主题优化参考教程：http://yearito.cn/posts/hexo-advanced-settings.html
- 主题优化参考2
- next主题配置文档：http://theme-next.iissnan.com/