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