1.安装node.js
Hexo框架需要node生成 node.js官网
终端输入指令 sudo su 输入电脑密码,进入root用户
查看node版本:node -v 验证是否安装成功,显示版本号则安装成功
安装node后会自动安装好npm包管理器,npm -v 查看npm版本
2.设置淘宝镜像源cnpm
Hexo需要借助npm包管理器来安装,国内使用npm镜像源速度很慢,需要设置淘宝镜像源cnpm,终端输入
npm install -g cnpm --registry=https://registry.npm.taobao.org
完成后输入 cnpm -v 查看版本,验证是否安装成功
如果报错需要在命令前加 sudo 赋予权限
3.使用cnpm安装Hexo博客框架
cnpm install -g hexo-cli
hexo -v 查看版本,验证是否安装成功
4.本地创建博客文件夹并初始化
所有hexo博客文件将在这里创建,如果初始化过程中出现错误的话将文件夹干掉重来即可(重要文件备份,不要误伤)
终端cd 进入文件夹根目录,初始化博客文件
sudo hexo init
Win10不需要加sudo,但要以管理员身份进入,下完git后,打开git里的cmd,新建文件夹后继续hexo init sudo 是linux/mac 中获得管理员权限的命令 windows里不需要加上sudo命令
初始化完成后会在文件夹内生成一些文件,之后博客设置及更新全部基于这些文件进行,终端ls -l查看,或者直接打开文件夹
5.启动hexo
终端 hexo s (s即serve)启动,注意需要在博客文件夹根目录下执行
会在本地的localhost:4000端口启动预览,浏览器输入localhost:4000就可以访问
4000端口一般做测试用,写好的博客可以先在本地4000预览,然后再部署到服务器上
打开后可以看到已经自动生成了第一篇博客”hello world“,标注了一些简单的hexo操作指令及文档链接
博文以Markdown格式保存在博客文件夹中,如果想新建博文,可以使用文档中提供的指令创建和编辑,也可以用支持Markdown格式的编辑器写好后放进文件夹中
此文件夹中的所有操作都需要电脑管理员权限
博文文件位置:/blog/source/_posts/
Ctrl+C 关闭4000端口
6.部署到GitHub
github上新建一个仓库(new repository)
用户部署个人博客的github仓库的命名必须符合要求,之后在浏览器中访问的就是这个地址
你的github用户名.github.io
备注仓库信息,设置公开/私有,Create repository
在博客文件夹下安装部署插件,终端
cnpm install --save hexo-deployer-git
打开博客文件夹下_config.yml文件,拉到最下方deploy:位置,添加字段
deploy: type: git repo: https://github.com/用户名/用户名.github.io.git (刚刚在github中创建的仓库地址) branch: main
终端输入 hexo d 开始部署,期间需要输入github账号名和令牌密码personal access token
2021年8月之后不能用密码登陆,需要在GitHub的setting-Developer setting-Personal access token中设置personal access token作为密码登陆
令牌建议妥善保存,后续更新博客都需要令牌作为密码,令牌有时效限制,需要定期更新,如果忘记了可以重新生成,但任何使用此令牌的脚本或应用程序都需要更新向远端推送完成后可以看到github仓库里多了一些文件,这些就是博客生成的内容,之后就可以通过github仓库访问博客了
访问地址 用户名.github.io
7.更新博客内容
清理,重新生成,部署到github
hexo clean hexo g hexo d
部署期间需要输入用户名和令牌密码
注意令牌的时效,定期更换
完成
8.更换博客主题
如果不喜欢Hexo默认的主题界面,可以自己更换
这里以主题yilia为示例 github下载地址
终端 cd 到博客文件夹根目录
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
会将主题文件clone到根目录下themes文件夹中
修改根目录下的 _config.yml文件中theme:字段
默认主题 theme: landscape 修改为 theme: yilia
清理,重新生成,部署到github
hexo clean hexo g hexo d
部署期间需要输入用户名和令牌密码
完成主题配置文件在主目录下的_config.yml,github下载地址中有详细的配置介绍,根据自己需要修改使用
如果有其他喜欢的主题,也可以自行更换,失败没关系,多尝试折腾下