利用hexo和Github搭建个人免费博客
2017-11-10 12:57
691 查看
原文请移步:http://blog.liuxianan.com/build-blog-website-by-hexo-github.html
一:前言
使用github pages服务搭建博客的好处;
1:全是静态文件,访问速度快
2:免费方便,不用花一分钱就可以搭建一个自由的个人博客,不需要服务器不需要后台;
3:数据绝对安全,基于github的版本管理,想恢复那个版本都可以;
4:博客内容可以轻松打包、转移、发布到其他平台
二:准备工作
1.node.js
2.git
3.hexo
三:搭建github博客
3.1:创建仓库
新建一个名为你的用户名.github.iod的仓库,比如说我的github用户名是PGzxc,我就创建PGzxc.github.io的仓库,将来你的网站访问地址就是:http://PGzxc.github.io了,是不是很方便
由此可见:每个github账户最多只能创建一个可以直接使用域名访问的仓库
几个注意的地方:
1.注册的邮箱一定要验证,否则不会成功;
2.仓库名必须是:username.github.io,其中username是你的用户名;
3.仓库创建成功不会立即生效,需要过一段时间;
创建成功以后,默认会在你这个仓库里创建一些示例页面;以后你的网站里的所有代码都是放在这仓库里啦;
四:配置SSH key
为什么要配置这个呢?因为你提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh
key来解决本地和服务器的连接问题
4.1.创建SSH key和配置请移步:Github生成SSH key并加入管理
4.2.测试是否成功
打开git Bash,执行指令:ssh -T git@github.com,如果提示
到此说明SSH key配置成功
此时你还需要配置:
五:使用hexo写博客
Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。
官网: http://hexo.io
github: https://github.com/hexojs/hexo
由于github pages存放的都是静态文件,博客存放的不只是文章内容,还有文章列表、分类、标签、翻页等动态内容,假如每次写完一篇文章都要手动更新博文目录和相关链接信息,相信谁都会疯掉,所以hexo所做的就是将这些md文件都放在本地,每次写完文章后调用写好的命令来批量完成相关页面的生成,然后再将有改动的页面提交到github。
安装之前先来说几个注意事项:
很多命令既可以用Windows的cmd来完成,也可以使用git bash来完成,但是部分命令会有一些问题,为避免不必要的问题,建议全部使用git bash来执行;
hexo不同版本差别比较大,网上很多文章的配置信息都是基于2.x的,所以注意不要被误导;
hexo有2种
在电脑的某个地方新建一个名为hexo的文件夹(名字可以随便取),比如我的是D
hexo会自动下载一些文件到这个目录,包括node_modules,目录结构如下图:
执行以上命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的:
http://blog.liuxianan.com/windows-port-bind.html
第一次初始化的时候hexo已经帮我们写了一篇名为 Hello World 的文章,默认的主题比较丑,打开时就是这个样子:
既然默认主题很丑,那我们别的不做,首先来替换一个好看点的主题。这是 官方主题。
个人比较喜欢的2个主题:hexo-theme-jekyll 和 hexo-theme-yilia。
首先下载这个主题:
下载后的主题都在这里:
修改
如果出现一些莫名其妙的问题,可以先执行
发布之后的页面如图所示
在上传代码到github之前,一定要记得先把你以前所有代码下载下来(虽然github有版本管理,但备份一下总是好的),因为从hexo提交代码时会把你以前的所有代码都删掉。
如果你一切都配置好了,发布上传很容易,一句
首先,
其次,配置
正确写法:
错误写法:
后面一种写法是hexo2.x的写法,现在已经不行了,无论是哪种写法,此时直接执行
原因是还需要安装一个插件:
其它命令不确定,部署这个命令一定要用git bash,否则会提示
打开你的git bash,输入
此时可以使用http://PGzxc.github.io访问了
一:前言
使用github pages服务搭建博客的好处;
1:全是静态文件,访问速度快
2:免费方便,不用花一分钱就可以搭建一个自由的个人博客,不需要服务器不需要后台;
3:数据绝对安全,基于github的版本管理,想恢复那个版本都可以;
4:博客内容可以轻松打包、转移、发布到其他平台
二:准备工作
1.node.js
2.git
3.hexo
三:搭建github博客
3.1:创建仓库
新建一个名为你的用户名.github.iod的仓库,比如说我的github用户名是PGzxc,我就创建PGzxc.github.io的仓库,将来你的网站访问地址就是:http://PGzxc.github.io了,是不是很方便
由此可见:每个github账户最多只能创建一个可以直接使用域名访问的仓库
几个注意的地方:
1.注册的邮箱一定要验证,否则不会成功;
2.仓库名必须是:username.github.io,其中username是你的用户名;
3.仓库创建成功不会立即生效,需要过一段时间;
创建成功以后,默认会在你这个仓库里创建一些示例页面;以后你的网站里的所有代码都是放在这仓库里啦;
四:配置SSH key
为什么要配置这个呢?因为你提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh
key来解决本地和服务器的连接问题
4.1.创建SSH key和配置请移步:Github生成SSH key并加入管理
4.2.测试是否成功
打开git Bash,执行指令:ssh -T git@github.com,如果提示
Are you sure you want to continue connecting (yes/no)?,输入yes,然后会看到
到此说明SSH key配置成功
此时你还需要配置:
$ git config --global user.name "PGzxc"// 你的github用户名,非昵称 $ git config --global user.email "xxx@qq.com"// 填写你的github注册邮箱
五:使用hexo写博客
Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。
官网: http://hexo.io
github: https://github.com/hexojs/hexo
4.2. 原理
由于github pages存放的都是静态文件,博客存放的不只是文章内容,还有文章列表、分类、标签、翻页等动态内容,假如每次写完一篇文章都要手动更新博文目录和相关链接信息,相信谁都会疯掉,所以hexo所做的就是将这些md文件都放在本地,每次写完文章后调用写好的命令来批量完成相关页面的生成,然后再将有改动的页面提交到github。
4.3. 注意事项
安装之前先来说几个注意事项:很多命令既可以用Windows的cmd来完成,也可以使用git bash来完成,但是部分命令会有一些问题,为避免不必要的问题,建议全部使用git bash来执行;
hexo不同版本差别比较大,网上很多文章的配置信息都是基于2.x的,所以注意不要被误导;
hexo有2种
_config.yml文件,一个是根目录下的全局的
_config.yml,一个是各个
theme下的;
4.4. 安装
$ npm install -g hexo
4.5. 初始化
在电脑的某个地方新建一个名为hexo的文件夹(名字可以随便取),比如我的是D:\Code\hexo,由于这个文件夹将来就作为你存放代码的地方,所以最好不要随便放。
$ cd /d/Code/hexo/ $ hexo init
hexo会自动下载一些文件到这个目录,包括node_modules,目录结构如下图:
$ hexo g # 生成 $ hexo s # 启动服务
执行以上命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的:
hexo s是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故,因为4000这个端口太常见了,解决端口冲突问题请参考这篇文章:
http://blog.liuxianan.com/windows-port-bind.html
第一次初始化的时候hexo已经帮我们写了一篇名为 Hello World 的文章,默认的主题比较丑,打开时就是这个样子:
4.6. 修改主题
既然默认主题很丑,那我们别的不做,首先来替换一个好看点的主题。这是 官方主题。个人比较喜欢的2个主题:hexo-theme-jekyll 和 hexo-theme-yilia。
首先下载这个主题:
$ cd /d/Code/hexo/ $ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
下载后的主题都在这里:
修改
_config.yml中的
theme: landscape改为
theme: yilia,然后重新执行
hexo g来重新生成。
如果出现一些莫名其妙的问题,可以先执行
hexo clean来清理一下public的内容,然后再来重新生成和发布。
发布之后的页面如图所示
4.7. 上传之前
在上传代码到github之前,一定要记得先把你以前所有代码下载下来(虽然github有版本管理,但备份一下总是好的),因为从hexo提交代码时会把你以前的所有代码都删掉。
4.8. 上传到github
如果你一切都配置好了,发布上传很容易,一句hexo d就搞定,当然关键还是你要把所有东西配置好。
首先,
ssh key肯定要配置好。
其次,配置
_config.yml中有关deploy的部分:
正确写法:
deploy: type: git repository: git@github.com:PGzxc/PGzxc.github.io.git branch: master
错误写法:
deploy: type: github repository: https://github.com/PGzxc/PGzxc.github.io.git branch: master
后面一种写法是hexo2.x的写法,现在已经不行了,无论是哪种写法,此时直接执行
hexo d的话一般会报如下错误:
Deployer not found: github 或者 Deployer not found: git
原因是还需要安装一个插件:
npm install hexo-deployer-git --save
其它命令不确定,部署这个命令一定要用git bash,否则会提示
Permission denied (publickey).
打开你的git bash,输入
hexo d就会将本次有改动的代码全部提交,没有改动的不会:
此时可以使用http://PGzxc.github.io访问了
相关文章推荐
- 利用Hexo + GitHub搭建免费的个人博客
- 利用github和hexo一步步生成个人博客(1)---环境搭建
- 利用github与hexo搭建个人博客
- 利用Github免费搭建个人主页(个人博客)
- GitHubPages+Hexo搭建免费个人博客(windows平台)
- 使用hexo+github免费搭建个人博客网站超详细教程
- 零基础免费搭建个人博客-hexo+github
- 基于Hexo+GitHub Page搭建免费个人博客教程
- hexo+github搭建免费个人博客
- 利用github与hexo搭建个人博客
- 利用Github免费搭建个人主页(个人博客)
- 利用 Hexo + Github Pages 搭建免费博客 - 上传云端(二)
- 利用 Hexo + Github Pages 搭建免费博客 - 第一次运行(一)
- 利用Github免费搭建个人主页(个人博客)
- 零基础免费搭建个人博客-hexo+github
- 利用hexo搭建github个人博客
- 利用Github免费搭建个人主页(个人博客)
- 使用hexo+github搭建免费个人博客详细教程
- 零基础免费搭建个人博客-hexo+github
- 利用github和hexo搭建个人博客