Hexo是个快速、简洁且高效的博客框架,它是一款基于Node.js的静态博客生成程序,作者是中国台湾tommy351。它的安装运行等甚至生成文章页面 生成目录,网站配置都是在爱代码模式下进行的。还有就是要学会使用Hexo,就得学会使用Git,并且对Git常用基础命令要有所了解,还有就是需要安装Node.js,这个软件是Hexo本地搭建必不可少的工具,值得一提的是Hexo博客可以部署到GitHub、Gitee、GitLab、Coding、七牛,都是完全免费的,可以让你实现免服务器,免域名搭建一个完整的博客。
Hexo官网:https://hexo.io
1. 安装Git
Git是目前世界上最先进的分布式版本控制系统,可以有效、高速的处理从很小到非常大的项目版本管理。也就是用来管理你的hexo博客文章,上传到GitHub的工具。
Windows:下载并安装 git:https://git-scm.com/download/win
对于中国大陆地区用户,可以前往 淘宝 Git for Windows 镜像 下载 git 安装包。
Linux (Ubuntu, Debian):sudo apt-get install git-core
Linux (Fedora, Red Hat, CentOS):sudo yum install git-core
2. 安装nodejs
Hexo是基于nodeJS编写的,所以需要安装一下nodeJs和里面的npm工具。
windows:打开nodejs:https://nodejs.org/en/download/ 选择LTS版本。
linux:安装完后,打开命令行
1 | sudo apt-get install nodejs |
然后检查一下有没有安装成功
1 | node -v |
3. 安装hexo
然后安装hexo,你可以先创建一个文件夹blog,在这个文件夹下的空白地方,右键git bash打开
1 | npm install -g hexo-cli |
然后初始化hexo,这个hexoblog可以随便填
1 | hexo init hexoblog |
用cd进入hexoblig里(或者直接打开这个文件夹,在空白地方右键 git bash打开 )
1 | cd hexoblog |
这个时候hexoblog文件夹里有指定文件夹目录下有:
node_modules: 依赖包
public:存放生成的页面
scaffolds:生成文章的一些模板
source:用来存放你的文章
themes:主题
_config.yml: 博客的配置文件
db.json:source解析所得到的
package.json:项目所需模块项目的配置信息
然后本地运行测试一下
1 | hexo generate |
hexo generate 顾名思义,生成静态文章,可以用 hexo g缩写
hexo server 顾名思义,启动服务 本地运行,可以用 hexo s缩写
在浏览器输入 localhost:4000 就可以看到你生成的博客了。
使用ctrl+c可以把服务关掉。
4.在GitHub创建一个放博客文件的仓库
GitHub官网:https://github.com/
没有账号的注册一个,登录后,点击右上角New repository
创建一个和你用户名相同的仓库,后面加.github.io,只有这样,将来要部署到GitHub page的时候,才会被识别,也就是xxx.github.io,其中xxx就是你注册GitHub的用户名。我这里是已经建过了。点击create repository。
5. 生成SSH添加到GitHub
在博客根目录 右键点击 Git Bash Here
输入命令
1 | git config --global user.name "yourname" |
yourname输入你GitHub用户名,youremail输入你GitHub的邮箱。(在双引号里面输入,双引号别删)
检查一下你有没有输对
1 | git config user.name |
输入下面命令( youremail 是GitHub邮箱)创建SSH ,然后一路回车
1 | ssh-keygen -t rsa -C "youremail" |
在你的C盘中找到这个文件夹。打开 id_rsa.pub
其中,id_rsa是你这台电脑的私人秘钥,不能给别人看的,id_rsa.pub是公共秘钥,可以随便给别人看。把这个公钥放在GitHub上,这样当你链接GitHub自己的账户时,它就会根据公钥匹配你的私钥,当能够相互匹配时,才能够顺利的通过git上传你的文件到GitHub上。
点击GitHub的右上角setting中 -> 点击左边SSH and GPG keys -> 点击New SSH key
title随便填,把C盘的id_rsa.pub里面的信息复制到key里。
回到git bash中,查看是否成功
1 | ssh -T git@github.com |
这个时候要输入一次yes,然后再回车
6. 将hexo部署到GitHub
打开站点配置文件 _config.yml,拉到最后,修改为
1422756921就是你的GitHub账户
1 | deploy: |
注意:现在GitHub的默认分支已经是main了,不是master !!!!
这个时候需要先安装deploy-git ,也就是部署的命令,这样你才能用命令部署到GitHub。
1 | npm install hexo-deployer-git --save |
然后
1 | hexo clean |
其中 hexo clean清除了你之前生成的东西
hexo deploy 部署文章,可以用hexo d缩写
输入hexo deploy之后会出现一个小弹窗,要你输入GitHub的username和password。(用户名是邮箱)
过一会儿就可以在https://1422756921.github.io 这个网站看到你的博客了!
关于站点文件配置请参考官方文档:https://hexo.io/zh-cn/docs/configuration.html