Hexo搭建个人静态博客网站

时间：2022-04-25 22:26:06

前言

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

详细配置

相关文章