-此教程不仅面向计算机专业的同学，任何想搭建个人独立博客的同学，都可以来看看-
--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 上的静态网页。

注册 GitHub

访问：https://www.github.com
注册十分简单，一定要记住注册时使用的邮箱，因为 GitHub 上很多通知都是通过邮箱的。
如图：


申请成功后，在 GitHub 官网上登录，并验证邮箱。

如果还是不明白，详细也可以看：
一步步在GitHub上创建博客主页 全系列 by pchou（推荐）

环境安装

依次下载安装以下软件（直接一直点下一步即可）

提示：若因种种原因 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） 就可以看到你的个人博客了。



文／Coder_Y（简书作者）
原文链接：http://www.jianshu.com/p/985d07d88ef4
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。