-此教程不仅面向计算机专业的同学,任何想搭建个人独立博客的同学,都可以来看看-
--By Y.R.H
摘要:本文是一篇关于如何在 Windows 下搭建一个独立博客的教程,里面介绍了如何使用 GitHub Pages 和 Hexo 搭建一个属于自己的博客,并配置它的过程。
前言
偶然间发现我的姓名拼音的域名没有被人购买,心想,作为一名准程序员,怎么能把个人域名让给别人,于是勒紧裤腰带,花光身上仅剩的一点点积蓄将其买了下来,买下来后不知道用它能做点什么(我不会网页制作),想起了很久以前在知乎上看到的一个问题:如何搭建个人独立博客,心想闲着也是闲着,不如折腾一下,说不定就能成功,以后把学习笔记什么的都放到个人博客上,之后回味起来也方便,于是便开始查资料,经过两天的折腾,个人博客也基本成型了,搭建的步骤也差不多都很熟练了,于是便写下这篇教程,有两个目的:其一,熟练markdown的语法(此教程使用纯 markdown 写成),并整理下自己的思路,锻炼下自己的语言表达能力;其二,本着能帮一个是一个,大家一起讨论才能进步的原则,将自己所学到的知识分享给各位小伙伴,大家一起折腾起来,我们一同学习,一同进步。
有人可能会问为什么要写博客?请看这里
特别鸣谢:陈素封,我也是跟着他的教程一点一点学会的。
特别声明:此教程中部分内容转自cnFeat编写的教程大家也可移步去学习
为什么要搭建独立博客
- 1 独立的才是自己的
- 2 锻炼自己的动手能力
- 3 更好的宣传自己
新人须知
- 1 请保持足够的耐心
- 2 善于使用搜索引擎
- 3 可以适当了解写网页制作的基础知识
为什么选择GitHub Pages
很多人用wordpress,你为什么要用GitHub Pages来搭建?
- 1 GitHub Pages 有300M免费空间,资料自己管理,保存可靠;
- 2 学着用 GitHub ,享受 GitHub 的便利,上面有很多大牛,眼界会开阔很多;
- 3 顺便看看 GitHub 工作原理,最好的团队协作流程;
- 4 GitHub 是趋势;
- 5 你不觉得一个文科生用 GitHub 很geek吗?瞬间跻身技术界;
- 6 就算 GitHub 被墙了,我可以搬到国内的 GitCafe 中去。
GitHub Pages 是什么?
GitHub Pages本用于介绍托管在GitHub的项目, 不过,由于他的空间免费稳定,用来做搭建一个博客再好不过了。
GitHub Pages 可以被认为是用户编写的、托管在 GitHub 上的静态网页。
![](http://7xi78f.com1.z0.glb.clouddn.com/github pages.png)
注册 GitHub
访问:https://www.github.com
注册十分简单,一定要记住注册时使用的邮箱,因为 GitHub 上很多通知都是通过邮箱的。
如图:
申请成功后,在 GitHub 官网上登录,并验证邮箱。
如果还是不明白,详细也可以看:
一步步在GitHub上创建博客主页 全系列 by pchou(推荐)
环境安装
依次下载安装以下软件(直接一直点下一步即可)
Node.js (由于Node.js 不翻墙下载速度比较慢 博主把已下好的安装包放到了百度云盘)
32位系统 链接: http://pan.baidu.com/s/1o6oQl1S 密码: 5enh
64位系统 链接: http://pan.baidu.com/s/1ntoSmI9 密码: 1mqqGitHub for Windows (安装好后即可直接登录刚才申请的 GitHub 账号)
PS:cnFeat 教程 使用的是 Git ,但经过本人操作,觉得使用 GitHub for Windows 更加方便(无需配置SSH keys)
如图:
提示:若因种种原因 GitHub 客户端没登上自己的账号,可以通过如下方法登录,也可以通过此方法查看是否登录成功
如图:
测试 SSH Key
在桌面或开始菜单中找到 Git Shell(win7为例,win8及8.1 在 Metro 界面也可以找到)
-
等待打开后输入以下命令('$'符号无需输入)
$ ssh -T git@github.com
如图:
-
如果是下面之类的反馈(或者显示 Hi xxx):
The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?
不用紧张,输入 yes 之后,你就会看到:
Hi xxx(你的用户名)! You've successfully authenticated, but GitHub does not provide shell access.
这时,便测试成功了。
如图:
提示:如果出现问题,请卸载 GitHub for Windows 客户端,重新安装一遍,或转到使用 Git 方法
常见错误请参考:
GitHub Help - Generating SSH Keys
GitHub Help - Error Permission denied (publickey)
使用 GitHub Pages 建立博客
与 GitHub 建立好链接之后,就可以方便的使用它提供的 Pages 服务,GitHub Pages 分两种,一种是你的GitHub用户名建立的username.github.io这样的用户&组织页(站),另一种是依附项目的pages。
想建立个人博客是用的第一种,形如yangruihan0306.github.io这样的可访问的站,每个用户名下面只能建立一个。
GitHub 上建立仓库
如图:
提示:详细可以看这里:一步步在GitHub上创建博客主页(2)
使用 Hexo 创建博客框架
Hexo 介绍
A fast, simple & powerful blog framework
Hexo 安装
打开 Git Shell (方法同上)
启动后依次输入以下命令:
$ cd /
$ npm install hexo-cli -g
如图:
提示:cd / 作用是返回根目录,Git Shell 默认装在 C盘,启动时默认路径为 C:\Users\xxx(用户名)\Documents\GitHub,输入 cd / 命令后就返回到了 C盘根目录下,需不需要使用 cd / 看个人习惯(下同)。
Hexo 部署
Hexo 的部署有两种方法
第一种方法 命令 hexo init [文件名]
打开 Git Shell (方法同上)
启动后依次输入以下命令:
$ cd /
$ hexo init Hexo
回车后出现该提示则表示正确:
这时会发现 C盘根目录下(或是 Git Shell 里指定的目录下)会多出一个文件夹,名为 Hexo
再输入以下命令,安装依赖文件:
$ cd Hexo
$ npm install
回车后出现该提示则表示正确:
第二种方法 命令 hexo init
手动在 C盘根目录下(或是自己指定的目录下)创建一个文件夹,名为 Hexo。
如果在 C盘根目录下
依次次输入以下命令:
$ cd /
$ cd Hexo
$ hexo init
如果在自己指定的目录下
依次次输入以下命令:
$ cd your_file_path(你的文件夹路径)
$ hexo init
回车后出现该提示则表示正确:
再输入以下命令,安装依赖文件:
$ npm install
回车后出现该提示则表示正确:
经过以上两个方法的任意一种之后,Hexo 会自动在目标文件夹建立博客网站所需要的所有文件。
此时可以通过输入以下命令在本地进行预览(在刚才创建的文件夹里):
$ hexo generate (可以简写成: hexo g)
$ hexo server
系统可能会出现提示,请点击允许。
如图所示则表示正确:
此时打开浏览器,在浏览器地址栏输入 http://localhost:4000/ (默认端口为4000)便可以看到最原始的博客了(以后发表博文想先预览,也可以通过 hexo server 在本地先跑起来,看看效果)。
如图:
恭喜,到目前为止个人博客的雏形已经有了。
在 Git Shell 中按 Ctrl + C 并输入 y 可以停止该服务。
提示:如果在以上过程中,输入带有 npm 的命令时,报以下错误,则说明 Node.js 没有装好,请重装
将本地文件部署到 GitHub
修改 Hexo 中的 _config.yml 文件
在 Hexo 文件夹下找到 _config.yml 文件
如图:
找到其中的 deploy 标签,改成如图所示,并保存:
其中 branch 选项可以填写 master 或 gh-pages。
如果你是为一个项目制作网站,那么需要把 branch 设置为 gh-pages 。若要绑定自定义域名也可以参考Hexo 或 Github Page 的帮助文档,制作一个 CNAME 文件。
将其 deploy 到仓库中
打开 Git Shell 进入创建的文件夹,依次输入以下命令:
$ hexo clean
$ hexo generate
$ hexo deploy
如果出现如图错误,不要着急:
deploy 的 type 改成 git,然后再在 Git Shell 中运行以下命令
$ npm install hexo-deployer-git --save
再重新来一遍:
$ hexo clean
$ hexo generate
$ hexo deploy
出现以下提示则表示正确:
恭喜,到这一步,个人博客就已经部署到 GitHub 上了,此时通过 your_user_name.github.io(即你那个仓库的名称,形如:"你的 GitHub 用户名".github.io) 就可以看到你的个人博客了。
P.S:如果发现文章中有明显的错误和问题请在下面留言或者联系本人,本人将及时改正,避免给大家带来不必要的误导,谢谢~