
版权申明:本文为博主原创文章,未经博主允许不得转载。如需转载,请私聊博主。
什么是hexo
Hexo是一个开源的静态博客生成器,用node.js开发,作者是*大学生tommy351。
前期准备
安装node.js.
这里我推荐大家使用v5的版本,下载地址:node.js.找到node-v5.12.0-x64.msi 下载安装即可。v6以及以上的版本听一些大佬说会出现令人蛋疼的麻烦,有兴趣的童鞋可以去尝试一下v6或者v7版本。本文案例使用的5.12的版本。
安装git.
下载地址:git.由于穷本人只有一台电脑,所以这里的教程只针对windows用户,要是有童鞋觉得文章可以的话可以赞赏一下,给我的早餐加个卤蛋也许我会更有动力更新关于mac和linux用户的教程。
安装hexo
安装完git之后就可以安装hexo了,如果某些童鞋的电脑桌面上没有git bash,可尝试在开始菜单里查找。打开git bash 之后输入以下命令回车将hexo安装到全局。
$ npm install -g hexo
测试安装hexo
然后输入hexo -v如果显示以下内容则安装成功。版本不同可能会有少许差异,不过无伤大雅。
hexo-cli: 1.0.2
os: Windows_NT 10.0.14393 win32 x64
http_parser: 2.7.0
node: 5.12.0
v8: 4.6.85.32
uv: 1.8.0
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 47
openssl: 1.0.2h
注册github账号
由于我们的博客是使用github托管的,不懂github是什么的童靴请自行百度了解,因此我们需要注册一个github的账号,注册地址:github.注册流程和我们注册QQ一样简单。
新建一个Github仓库
注册完成之后在你的右上角头像点击下拉列表选择your profile,然后选择Repositories,点击绿色的new 按钮,在Repository name的输入框内写入和你的owner名字+github.io,这里我的用户名是JavaEngineerLiu,所以我的Repository name也是JavaEngineerLiu.github.io。最后create repository.
hexo初始化
前面我们已经安装完了hexo,但是我们还需要给它初始化,在你的任意一个盘符里新建一个文件夹,这里我选择的是在D盘新建的一个hexo的文件夹。打开文件夹右键git bash,输入以下命令。
$ hexo init
生成静态页面
初始化完成之后会自动生成一篇“hello world”的文章,现在我们需要输入以下命令将文章转换为静态页面。当然你也可以使用缩写格式hexo g.
$ hexo generate
启动本地预览
在git bash 上输入以下命令(你也可以使用快捷命令hexo s),然后在浏览器中输入http://localhost:4000/查看生成的页面效果。
hexo server
如果显示以下图片则你的博客已经搭载成功了。!
部署本地文件到github
这里打开前面自己新建的文件夹下面的_config.yml文件,用记事本打开即可。在文件的最下方,添加如下配置。
deploy:
type: git
repository: https://github.com/JavaEngineerLiu/JavaEngineerLiu.github.io
branch: master
注:每一个冒号之后需要空一格,第一个JavaEngineerLiu为Github的用户名,第二个JavaEngineerLiu为之前New的Repository的名字,不要把我的给复制上去了。
配置SSH key
如果你是第一次使用github则需要配置SSH key.
-
右键选择git bash ,输入以下命令,your_email@youremail.com换成注册github的邮箱号。
$ ssh-keygen -t rsa -C "your_email@youremail.com"
-
之后会要求确认路径和输入密码,我们这使用默认的一路回车就行,成功的话会在C:\Users\Administrator下生成.ssh文件夹,如果你的电脑的用户名是中文,则会在C:\用户\电脑用户名下生成.ssh文件夹,进入该文件夹,以文本的形式打开id_rsa.pub,复制里面的key,即复制文件的全部内容。如果你在这边只看见2个id_rsa文件,没看到id_rsa.pub,应该是你把后缀名隐藏了,可以设置显示后缀,或者直接把两个文件都以文本的形式打开,内容短的并且以ssh-rsa开头的即为所需的SSH key。回到github,进入Settings,选择SSH and GPG Keys -> New SSH Key,title随便填,粘贴key。为了验证是否成功,在git bash下输入:
$ ssh -T git@github.com
有些童靴如果显示continue,输入yes就会看到:You’ve successfully authenticated, but GitHub does not provide shell access ,这就表示已成功连上github。
上传本地仓库到github
在git bash 里分别输入以下命令。your name换成你的github用户名,your_email@youremail.com换成你注册github的邮箱。
$ git config --global user.name "your name"
$ git config --global user.email "your_email@youremail.com"
测试自己的域名是否能用
打开浏览器输入JavaEngineerLiu.github.io,如果显示的是你在本地服务预览的那个界面,那本博客就到此结束了,如果显示无法链接到服务器,那就接着以下的步骤继续操作。
继续部署github
-
执行以下目录进行部署,中途需要输入你的github注册用户名,回车之后再输入密码,输入密码时不会显示任何字符串,不要像我一样以为自己键盘坏掉了。
$ hexo deploy
-
如果执行上述命令报错,请先执行以下命令。然后再执行以上命令
$ npm install hexo-deployer-git --save
部署成功后,你在浏览器中输入JavaEngineerLiu.github.io,就能看到和本地一样的效果了。
后话
- 短短三个小时,包括昨晚在博客园上码文的三个小时,只有六个小时的样子,时间短暂,文章难免有不足之处,多多见谅,如果有童靴在搭载博客过程中遇到问题,欢迎私聊博主或者在下方评论区留言,您的支持是我不断前进的动力。