在安装好git
, Node.js
和hexo
之后,我们就可以开始正式搭建了,可以按照下面的步骤一步步操作。
在GitHub
上创建Repository
登录GitHub
后,新建一个Repository用于存放以后个人网站的所有内容。注意在新建时将仓库名称命名为<username>.github.io
,其中<username>
内容为你自己GitHub
的用户名。
配置SSH Keys
检查电脑现有的SSH Key
在终端输入命令:
~ % cd ~/.ssh
若提示 「No such file or directory」,说明我们需要生成一个新的SSH Key。
生成SSH Key
在终端输入命令:
~ % ssh-keygen -t rsa -C "<your email>@xxx.com
# ssh-keygen -t rsa -C "yangj@163.com"
注意这里的邮箱是你自己的GitHub
注册邮箱。之后终端会要求你输入密码,如下:
~ % Enter passphrase (empty for no passphrase): <设置密码>
~ % Enter same passphrase again: <再次输入密码>
添加SSH Key到GitHub
上
在本地文件夹找到id_rsa.pub
文件,这个文件的具体位置在上述生成SSH Key时会告诉你,讲文件打开后,复制全部内容。
回到GitHub
的Repository中,依次点击Setting
->SSH and GPG keys
,然后填写「Title」及「Key」这两部分内容。其中「Title」是你对这个SSH Key的命名,可根据自己喜好来填写。「Key」部分内容就是刚刚我们在id_rsa.pub
文件中复制的全部内容。
测试是否关联成功
输入命令:
~ % ssh -T git@github.com
根据提示进行操作,输入密码后,若看到「You’ve successfully authenticated…」内容则说明关联成功。
配置用户信息
输入命令:
~ % git config --global user.name "<username>" // 输入注册时的username
~ % git config --global user.email "<your email>@xxx.com" // 填写注册邮箱
至此,SSH Key配置成功啦!💗
在配置过程中有什么问题请参考官方文档「Connecting to GitHub with SSH」
在本地搭建Hexo博客
在本地建立一个文件夹,用于存放和编辑你的所有网站内容。然后在终端通过命令进入目录。
~ % cd <your directory> // 进入本地博客目录
之后,使用hexo
系列命令进行博客创建
~ % hexo init // 创建hexo
~ % npm install // 安装依赖
~ % npm install hexo-deployer-git --save // 确保git部署
完成以上操作后,恭喜你!现在已经搭建好本地的 Hexo 博客了。🎉
然后执行以下命令:
~ % hexo g
~ % hexo s
现在就可以在浏览器中输入localhost:400
来预览本地的博客网站啦!
注意:在进行博客搭建工作时,每次使用
hexo
系列命令都要在你的本地博客目录下,而且每次进行相应改动后都要hexo g
生成一下
将博客部署到<username>.github.io
打开本地博客目录中的_config.yml
文件,按照下面的内容修改文件中的最后配置内容:
deploy:
type: git
repository: git@github.com:<username>/<username>.github.io.git //你的GitHub 仓库的SSH码
branch: master // GitHub的分支名称
最后,使用下面的命令就将本地博客部署到GitHub
上了:
~ % hexo d
现在,你在浏览器中输入你的博客网址:<username>.github.io
,就能看到你自己的个人网站啦!
这里的分支名称是
master
,实际上在新建Repository是的默认分支名称是main
,需要注意一下到底哪个是活动分支。这里可能会出现明明使用hexo d
进行了部署更新但是服务器确依然显示的是更新前的内容,若出现这种情况可以参考:关于hexo更新到GitHub后博客内容未变问题
总结
恭喜你,你已经拥有一个自己的个人网站啦!🎉🎉👏👏下面就是如何写好自己的博客。Hexo
功能十分强大,也有很多丰富的主题可以供大家选择。希望我们可以用心维护自己的个人网站,这一定是一件很酷的事情!!
参考资料
(END)