Hexo搭建个人静态博客网站

前言

• 前段时间博客园整改，许多博客无法查看，偶然的机会接触到了许多博客框架，可用来快速搭建一个静态博客网站；最后选择使用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 git@github.com:用户名/仓库名.git   # 关联远程仓库
git push <远程主机名> <本地分支名>:<远程分支名>   # 推送
 

详细配置

• hexo主题：https://hexo.io/themes/
• 搭建参考教程：https://zhuanlan.zhihu.com/p/35668237
• 站点配置文件详解：https://blog.csdn.net/zemprogram/article/details/104288872
• 主题优化参考教程：http://yearito.cn/posts/hexo-advanced-settings.html
• 主题优化参考2：https://blog.csdn.net/as480133937/article/details/100138838
• next主题配置文档：http://theme-next.iissnan.com/