Hexo搭建个人静态博客网站

时间:2022-10-03 20:56:46

前言

  • 前段时间博客园整改,许多博客无法查看,偶然的机会接触到了许多博客框架,可用来快速搭建一个静态博客网站;最后选择使用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文档的模块

配置主题

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 <远程主机名> <本地分支名>:<远程分支名> # 推送

详细配置