Hexo+码云快速搭建个人博客教程
前言
偶然间发现hexo这个搭建博客的利器,在最开始使用github+hexo搭建的时候,由于github的服务器在国外,cdn的域遭到dns的污染,导致无法连接使用过cdn加速分发服务器,才使得了国内访问github变得如此之慢,访问速度简直不忍直视,所以我果断转战hexo+gitee
搭建博客,在搭建完后,还可以根据自身喜爱去往hexo主题的官网进行选择下载后配置即可,我这个主题是hexo-theme-matery的基础上修改了一些配置,要是觉得不错,欢迎直接素质二连star&frok
我的博客源代码https://gitee.com/hcj123123/hexo-theme-matery,话不多说,let‘s go!
1.安装Node.js
首先去下载稳定版的Node.js,这里我所给出的是Windows64位的,若是macOS或其他的,起到node.js的官网找到对应的并下载即可。
安装选项全部选择默认,一路点击Next
。PS:你会看到addpath
这个默认选项,也就是帮你默认配好了环境变量。
最后安装好了之后,Win+R
打开命令提示符,输入node -v
和npm -v
,如果出现了版本号,则代表安装成功了。
2.添加国内镜像源(建议)
如果没有搭梯子的话,建议使用阿里的国内镜像进行加速。
npm config set registry https://registry.npm.taobao.org
3.安装Git
为了将本地的网页文件能够上传到gitee上,我们这里需要用到当下非常流行的分布式版本控制工具————Git[下载地址]。
安装选项也是全部选择默认,当然在下载到哪里的目录,建议自定义文件夹,在最后一步添加路径时选择Use Git from the Windows Command Prompt
,这样我们就可以直接在命令提示符里打开git了。
安装完成后也是在命令提示符中输入git --version
验证是否安装成功。
4.注册Gitee账号
若你已经注册过,则跳过这一步吧~
首先也是进入到码云的官网,之后按提示注册完后,选择右上角的+
下的新建仓库,然后按照提示输入内容,这里要注意,输入的仓库名一定要跟你的gitee名字一样,比如你的gitee名字叫abc,那么你的仓库名也要是abc。
5.安装hexo
在合适的地方建立一个文件夹用来存放你的博客文件,比如我的博客文件都存放在了D:\program\blog
目录下。
在该目录下右键点击 Git Bash Here
,打开git的控制台窗口,之后的一系列操作就是在git中完成。
定位到该目录下后,输入npm i hexo-cli -g
安装Hexo。这里是使用npm 来下载hexo相关的脚手架。
安装完后可以输入hexo -v
验证是否安装成功。
然后初始化我们的网站,输入hexo init
初始化文件夹,接着输入npm install
安装必备的组件依赖。PS:这里你可能会遇到hexo init很慢,经过我查阅网上资料后,发现有几种解决方案,一种是用浏览器访问 http://tool.chinaz.com 使用IP查询
工具获得github.com和github.global.ssl.fastly.net的ip地址,然后去hosts文件中按如下格式输入(其中192.30.253.112和151.101.44.249喜欢即可),然后Win+R
打开命令提示符,输入ipconfig /flushdns
更新dns缓存
192.30.253.112 github.com
151.101.44.249 github.global.ssl.fastly.net
第二种是配置git代理
,具体操作可自行百度~
还有一种是利用cmd
,ping github.com
。只要收到github站点的反馈,重启git bash
,再进行hexo init
就可以顺利进行。
若以上都不生效,那就去泡杯咖啡,然后静静等待吧~(时长约为5-10min)
这样之后我们就可以在本地跑起来了,输入hexo g
生成静态网页,然后输入hexo s
打开本地服务器,然后浏览器打开http://localhost:4000/,就可以看到我们的博客啦,效果如下:
输入hexo g
生成静态网页,然后输入hexo s
打开本地服务器,然后浏览器打开http://localhost:4000/,就可以看到我们的博客啦,效果如下:
按ctrl+c
即可关闭本地服务器。
6.连接gitee与本地
首先右键打开git bash,然后输入下面命令:
git config --global user.name "用户名"
git config --global user.email "邮箱"
用户名和邮箱根据你注册gitee的信息自行修改。
然后生成密钥SSH key:
ssh-keygen -t rsa -C "邮箱"
打开gitee,在头像下面点击setting
,再点击SSH公钥
,新建一个SSH,名字随便。
git bash中输入
cat ~/.ssh/id_rsa.pub
查看密钥 将公钥内容(全部)复制并粘贴(注意:公钥内容以ssh-rsa开头)。
粘贴地址 https://gitee.com/profile/sshkeys 添加到gitee 添加公钥完成后进行测试公钥(测试SSH链接)
ssh -T git@gitee.com
当终端提示welcome to Gitee.com,yourname!
表示链接成功 至此以后只要拷贝ssh链接地址,然后利用git指令即可进行相关操作了。
打开博客根目录下的_config.yml
文件,这是博客的配置文件,在这里你可以修改与博客相关的各种信息。
修改最后一行的配置:
deploy:
type: git
repository: 仓库
branch: master
这里的仓库修改为你自己的gitee项目中clone
的地址。然后在博客根目录下右键打开git bash,安装一个扩展npm i hexo-deployer-git
。这是一个hexo自动部署的依赖,安装后输入hexo clean
、hexo generate
、hexo deploy
。这样就上传了你的项目到gitee的仓库中。
打开gitee你的名字的仓库,选择上方的服务
,然后Gitee Pages
,点击启动
,等待gitee pages部署后就可以访问你的hexo博客了。
等等!怎么没有样式呢?,这是因为hexo默认是部署到github pages的,这里我们选择的是gitee+hexo,所以还要改一个配置。点击blog下的_config.yml
,修改约15-18行的url和root
,将url改成gitee pages分配给你的网址例如http://xxx.gitee.io/
,root改成/即可。保存后hexo三连:
hexo clean
清除缓存
hexo g
生成静态网页文件
hexo d
上传到gitee的仓库
如果不出意外的话打开 http://你的gitee用户名.gitee.io
就能够看到效果了!