写给大家看的教程：从零开始在GitHub上部署个人博客
本文适合的读者：希望搭建个人博客的朋友，无需了解Git、Ruby等技术。
GitHub是什么？
GitHub是一个利用Git进行版本控制、专门用于存放软件代码与内容的共享虚拟主机服务（来自维基百科），我更愿意把它称作程序员的社交网站。GitHub的中心是代码，程序员们加入到不同的项目中，围绕着代码进行相互交流。
GitHub Pages是什么？
GitHub Pages最早是为托管在GitHub上的项目提供介绍页面而诞生的，开发者们可以通过GitHub Pages为他们的每一个项目创建一个用于介绍该项目的静态网站。
Jekyll是什么？
后来有人利用GitHub Pages建立了个人博客，但是由于GitHub Pages的网站是静态的，每次更新博客都需要手动更改HTML、接着GitHub联合创始人Tom Preston-Werner利用Ruby编写了静态网站生成工具Jekyll。Jekyll可以根据提供的模板以及文章内容自动生成静态网站，它的出现将网站的外观（模板）与网站的内容（博文）分开，简化的静态网站的维护。GitHub Pages也部署了Jekyll，上传到GitHub Pages的模板和博文可以被自动地通过Jekyll生成为一个静态网站。
部署Git及Jekyll
等等！说好的无需了解Git、Ruby等技术呢？啊，差点忘了，那这段跳过吧，正在阅读文章的你无需关注这些内容。Windows用户别怕，安装Ruby时的各种诡异问题都和你没啥关系了，咱压根就不碰它。
利用Jekyll Writer在GitHub部署Jekyll网站
Jekyll Writer是一款可视化的Jekyll网站管理程序，使用它可以避免接触Git和Jekyll来部署和管理Jekyll网站。
对于从没有接触过GitHub的用户，需要先到GitHub网站上注册一个用户，注册的过程我就不详细讲了。
登录GitHub之后，进入个人设置页面点击右上角的&Generate new token&生成一个token，Token description填写Jekyll Writer，Select scopes勾选repo。
生成完毕之后记录下这个token准备后面使用。
运行Jekyll Writer，选择Account标签，点击GitHub，在弹出的窗口中点击Add Account，将生成的Token填入文本框中，最后点击OK。如果一切顺利，就可以看到询问是否要立即扫描该账户下Jekyll仓库的提示了，点击OK继续。
扫描结束后，点击账户名就可以看到所有被搜索到的Jekyll网站了，如果没有，列表就是空的。点击下面的Create new site来创建一个新的Jekyll网站。
如果这是你的第一个网站，那么路径后面可以空着什么都不写，否则填写一个合适的路径。比如此处我填写一个blog的路径。
然后点击后面的对号确认创建，稍等片刻后提示创建成功。
这样一个Jekyll网站就创建完毕了。网站创建完毕后的URL是.http://github.io/，比如我在GitHub的用户名是Sneezry，我刚刚创建的网站路径是blog，那么这个网站的访问地址就是http://sneezry.github.io/blog。
注：相关网站建设技巧阅读请移步到频道。
看过本文的人还看过
最新图文推荐
最新专栏文章
大家感兴趣的内容
网友热评的文章如何搭建一个独立博客——简明Github Pages与Hexo教程 - 简书
<div class="fixed-btn note-fixed-download" data-toggle="popover" data-placement="left" data-html="true" data-trigger="hover" data-content=''>
写了540057字，被4509人关注，获得了12351个喜欢
如何搭建一个独立博客——简明Github Pages与Hexo教程
摘要：这是一篇很详尽的独立博客搭建教程，里面介绍了域名注册、DNS设置、github和Hexo设置等过程，这是我写得最长的一篇教程。我想将我搭建独立博客的过程在一篇文章中尽可能详细地写出来，希望能给后来者一个明确的指引，同时用这篇教程开篇，正式开始我的第八大洲之旅。
作为一个技术小白，没有技术基础，看网上的教程也云里雾里，看程序员的教程相当不容易，稍微有些细节描述得不清楚自己就要绕弯路去找答案（善用搜索引擎），所以，在自己的博客搭建完成之后，我决定要将我搭建博客的过程全记录下来，以供后期和我一样的小白参考（是的，我坚信还有很多一样和我一样的人），我会尽可能详细的整理这个教程，其中的资料可能会摘录到其他人的教程，我会在后面列出了参考资料，感谢这些作者们。
为什么要开博客？可以看看我的这篇
也可以看看这篇
以下以我的博客:为例，教大家如何搭建一个独立博客。
为什么要搭建一个独立博客?
独立的才是自己的。
小白进入门槛
1、非常折腾，需要耐心；
2、也需要一定的学习能力和钻研精神；
3、懂一些网页基础知识，不懂也重要，参看第二和第三条；
小白白请看
日更新：发现一个更简单的方法： byisnowfy
按此教程操作即可。
为什么选择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上的静态网页。
只推荐上godaddy购买，安全，而且可以使用支付宝。
教程（截止至日）如下
1、查你想要的域名；
2、查到适合的域名之后选择「continue to Cart」；
3、godaddy附加收费服务，不要管，继续「continue to Cart」；
4、确认购买。修改购买年限，默认是两年，可以修改成1/2/3/5/10年，随自己喜欢。现在godaddy上com每年的默认费用是12.99美元，附加上ICANN的管理费用就是13.17美元。
如果你不是土豪，可以上网搜godaddy的优惠码，一大堆，找一个填进这里，填完之后，一年的费用会变成8.99美元。
说明一下：一般来讲，使用网上的优惠码第一年收费8.99美元，以后每年的收费是10.99美元，不过在网上可以搜到合适的优惠码，可以每年的收费都是8.99美元，记得多测试自行鉴别。
如图，我买了五年的费用就是45.85美元，随后点击「Proceed to Checkout」
5、结算。登录或注册界面，填完必要的信息之后，选择用支付宝结算。
如果以上的教程如果不够清晰，可以参照这一份。
6、检查。结算后，重新登录，去「My Account」，域名已经显示在你的账户了。
7、补充一些注意事项：
输入优惠码没有优惠或者优惠幅度较低，请清除浏览器cookies再尝试；
如果没有支付宝支付选项，有可能是使用的优惠码不支持支付宝，请重新清除浏览器cookies再尝试；
注册时用户填写信息时一定要输入正确的邮箱名字，否则修改十分麻烦。
买完域名之后一定要记得去自己的邮箱查看激活邮件，否则域名激活不了。
安装准备软件
依次下载安装。
怎么打开Git？
1、开始菜单Git Bash。
2、鼠标右键打开Git Bash。
注册GitHub
注册你的username和邮箱，邮箱十分重要，GitHub上很多通知都是通过邮箱的。
注册过程比较简单，详细也可以看：
by pchou（推荐）
配置和使用Github
以下教程主要参考beiyuu的写成。
配置SSH keys
我们如何让本地git项目与远程的github建立联系呢？用SSH keys。
检查SSH keys的设置
首先我们需要检查你电脑上现有的ssh key：
$ cd ~/. ssh 检查本机的ssh密钥
如果提示：No such file or directory 说明你是第一次使用git。
生成新的SSH Key：
$ ssh-keygen -t rsa -C "邮件地址@"
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):&回车就好&
注意1: 此处的邮箱地址，你可以输入自己的邮箱地址；注意2: 此处的「-C」的是大写的「C」
然后系统会要你输入密码：
Enter passphrase (empty for no passphrase):&输入加密串&
Enter same passphrase again:&再次输入加密串&
在回车中会提示你输入一个密码，这个密码会在你提交项目时使用，如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。
注意：输入密码的时候没有*字样的，你直接输入就可以了。
最后看到这样的界面，就成功设置ssh key了：
添加SSH Key到GitHub
在本机设置SSH Key之后，需要添加到GitHub上，以完成SSH链接的设置。
1、打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件，你需要设置显示隐藏文件。准确的复制这个文件的内容，才能保证设置的成功。
2、登陆github系统。点击右上角的 Account Settings---&SSH Public keys ---& add another public keys
3、把你本地生成的密钥复制到里面（key文本框中）， 点击 add key 就ok了
可以输入下面的命令，看看设置是否成功，的部分不要修改：
如果是下面的反馈：
The authenticity of host ' (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 cnfeat! You've successfully authenticated, but GitHub does not provide shell access.
设置用户信息
现在你已经可以通过SSH链接到GitHub了，还有一些个人信息需要完善的。
Git会根据用户的名字和邮箱来记录提交。GitHub也是用这些信息来做权限的处理，输入下面的代码进行个人信息的设置，把名称和邮箱替换成你自己的，名字必须是你的真名，而不是GitHub的昵称。
$ git config --global user.name "cnfeat"//用户名
$ git config --global user.email
""//填写自己的邮箱
SSH Key配置成功
本机已成功连接到github。
若有问题，请重新设置。常见错误请参考：
使用GitHub Pages建立博客
与GitHub建立好链接之后，就可以方便的使用它提供的Pages服务，GitHub Pages分两种，一种是你的GitHub用户名建立的username.github.io这样的用户&组织页（站），另一种是依附项目的pages。
想建立个人博客是用的第一种，形如cnfeat.github.io这样的可访问的站，每个用户名下面只能建立一个。
github上建立仓库
登录后系统，在github首页，点击页面右下角「New Repository」
填写项目信息：
project name：cnfeat.github.io
description： Writing 1000 Words a Day Changed My Life
注：Github Pages的Repository名字是特定的，比如我Github账号是cnfeat，那么我Github Pages Repository名字就是cnfeat.github.io。
点击「Create Repository」 完成创建。
详细可以看这里：
用Hexo克隆主题
Hexo的作者是，根据，Hexo是一个简单、快速、强大的博客发布工具，支持Markdown格式。
$ npm install -g hexo
在我的电脑中建立一个名字叫「Hexo」的文件夹，然后在此文件夹中右键打开Git Bash。
$ hexo init
Hexo随后会自动在目标文件夹建立网站所需要的所有文件。
现在我们已经搭建起本地的hexo博客了，执行以下命令(在H:\hexo)，然后到浏览器输入localhost:4000看看。
复制cnfeat的主题
以下进入复制主题环节，如果那一步出现问题，或者修改后没有显示修改的结果，建议来来一个，再看看，可以解决很多问题。
$ hexo clean
建立了Hexo文件之后就可以复制我的主题了
$ git clone /cnfeat/cnfeat.git themes/jacman
如果不行，可以复制wuchong的修改的主题，我的就是复制他的修改的。
$ git clone /wuchong/jacman.git themes/jacman
或者复制yangjian的
$ git clone /A-limon/pacman.git themes/pacman
启用cnfeat的主题
修改Hexo目录下的config.yml配置文件中的theme属性，将其设置为jacman。同时请设置stylus属性中的compress值为true。
theme: jacman
注意：Hexo有两个config.yml文件，一个在根目录，一个在theme下，此时修改的是在根目录下的。
$ cd themes/jacman
$ git pull
注意：为避免出错，请先备份你的_config.yml 文件后再升级
本地查看调试
$ hexo g #生成
$ hexo s #启动本地服务，进行文章预览调试
或者直接作用组合命令
$ hexo d -g
浏览器输入 文件或者上传文件都可以先用此命令调试，非常好用，尤其是当你想调试出自己想要的主题时。
将独立域名与GitHub Pages的空间绑定
GitHub Pages的设置
方法一：在Repository的根目录下面，新建一个名为CNAME的文本文件，里面写入你要绑定的域名，比如。
方法二：到我的github仓库，点击右下角的「Download ZIP」，下载源文件，解压，找到CNAME文件，用记事本打开，将修改成你的域名，放进Hexo\source目录下，用hexo命令提交上去。
$ hexo d -g
用DNSpod，快，免费，稳定。
注册，添加域名，如下图设置。
其中A的两条记录指向的ip地址是github Pages的提供的ip
192.30.252.153
192.30.252.154
如博客不能登录，有可能是github更改了空间服务的ip地址，记得及时到在查看最新的ip即可
www指定的记录是你在github注册的仓库。
去Godaddy修改DNS地址
更改godaddy的Nameservers为DNSpod的NameServers。
1、点击「My Account」，管理我的域名。
2、点击域名。
3、将godaddy的Nameservers更改成f1g1ns1.dnspod.net和f1g1ns2.dnspod.net
如有不详看可以看
详细也可以看这里：
至此，独立博客就算搭建完成，如需进步一完善请在参看以下文章或博客下留言。
by yangjian
by yangjian
by zippera（推荐）
by zippera（推荐）
进阶篇：Hexo设置
网站搭建完成后，就可以根据自己爱好来对Hexo生成的网站进行设置了，对整站的设置，只要修改项目目录的_config.yml就可以了，这是我的设置，可供参考。
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: /tommy351/hexo/
# Site #整站的基本信息
title: 1000 words a Day #网站标题
subtitle: Writing 1000 Words a Day Changes My Life #网站副标题
description: 学习总结 思考感悟 知识管理 #网站描述
cnFeat #网站作者，在下方显示
language: zh-CN
## If your site is put in a subdirectory
permalink: :year/:month/:day/:title/
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
# Directory
source_dir: source
public_dir: public
new_post_name: :title.md # File name of new posts
default_layout: post
auto_spacing: false # Add spaces between asian characters and western characters
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
max_open_file: 100
multi_thread: true
filename_case: 0
render_drafts: false
post_asset_folder: false
highlight:
enable: true
line_number: true
tab_replace:
# Category & Tag
default_category: uncategorized
category_map:
# Archives
## 2: Enable pagination
## 1: Disable pagination
## 0: Fully Disable
archive: 2
category: 2
## Hexo uses Connect as a server
## You can customize the logger format as defined in
## http://www.senchalabs.org/connect/logger.html
port: 4000
server_ip: 0.0.0.0
logger: false
logger_format:
# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## /docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: H:mm:ss
# Pagination
## Set per_page to 0 to disable pagination
per_page: 15 #每页15篇文章
pagination_dir: page
# Disqus #社会化评论disqus，我使用多说，在主题中配置
disqus_shortname:
# Extensions
## Plugins: /tommy351/hexo/wiki/Plugins
## Themes: /tommy351/hexo/wiki/Themes
theme: jacman
exclude_generator:
- hexo-generator-feed
- hexo-generator-sitemap
path: sitemap.xml
#Feed Atom
type: atom
path: atom.xml
# Markdown
## /chjj/marked
pedantic: false
sanitize: false
tables: true
breaks: true
smartLists: true
smartypants: true
compress: false
# Deployment
## Docs: http://hexo.io/docs/deployment.html
type: github
repository: /cnfeat/cnfeat.github.io.git
branch: master
修改局部页面
页面展现的全部逻辑都在每个主题中控制，源代码在hexo\themes\jacman\中：
├── languages
├── default.yml#默认语言
└── zh-CN.yml
├── layout #布局，根目录下的*.ejs文件是对主页，分页，存档等的控制
├── _partial
#局部的布局，此目录下的*.ejs是对头尾等局部的控制
└── _widget#小挂件的布局，页面下方小挂件的控制
├── source #源码
├── css#css源码
├── _base
#*.styl基础css
├── _partial
#*.styl局部css
├── fonts
├── images #图片
└── style.styl #*.styl引入需要的css源码
├── fancybox
#fancybox效果源码
└── js #javascript源代码
├── _config.yml#主题配置文件
└── README.md
#用GitHub的都知道
发表新文章
用hexo发表新文章
$ hexo n #写文章
其中my new post为文章标题，执行命令后，会在项目\source_posts中生成my new post.md文件，用编辑器打开编写即可。
当然，也可以直接在\source_posts中新建一个md文件，我就是这么做的。
写完后，推送到服务器上，执行
$ hexo g #生成
$ hexo d #部署 # 可与hexo g合并为 hexo d -g
用Hexo发表文章的Markdown语法
使用jacman或pacman主题，建议按此标准语法写：
title: postName #文章页面上的显示名称，可以任意修改，不会出现在URL中
15:30:16 #文章生成时间，一般不改，当然也可以任意修改
categories: example #分类
tags: [tag1,tag2,tag3] #文章标签，可空，多标签请用格式，注意:后面有个空格
description: 附加一段文章摘要，字数最好在140字以内。
为什么我的博客有目录？
我用的是Markdown语法，Markdown语法怎么用？
请看这里：
或者看这里：
常用命令：
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将.deploy目录部署到GitHub
常用复合命令：
hexo d -g #生成加部署
hexo s -g #预览加部署
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
添加sitemap和feed插件
$ npm install hexo-generator-sitemap
$ npm install hexo-generator-feed
修改_config.yml，增加以下内容
# Extensions
- hexo-generator-feed
- hexo-generator-sitemap
#Feed Atom
type: atom
path: atom.xml
path: sitemap.xml
Hexo上传README文件
Github的版本库通常建议同时附上README.md说明文件，但是hexo默认情况下会把所有md文件解析成html文件，所以即使你在线生成了README.md，它也会在你下一次部署时被删去。怎么解决呢？
在执行hexo deploy前把在本地写好的README.md文件复制到.deploy文件夹中，再去执行hexo deploy。
GitHub Pages有提供制作404页面的指引：。
直接在根目录下创建自己的404.html或者404.md就可以。但是自定义404页面仅对绑定顶级域名的项目才起作用，GitHub默认分配的二级域名是不起作用的，使用hexo server在本机调试也是不起作用的。
推荐使用。
推荐使用七牛（10G空间，免费），还可以使用Yupoo（100m免费空间）
参考资料：
[1] by pchou（推荐）
[2]网站优化： by pchou （推荐）
[3] by 阮一峰（推荐）
[4] by zippera（推荐）
[5]by zippera（推荐）
[6] by zippera（推荐）
[7] by ibruce（推荐）
[8] by yangjian（推荐）
[9] by yangjian（推荐）
[10] by wuchong（推荐）
[11]hexo官方写作教程
[12]知乎上的教程：
[13]在GitHub Pages设置独立域名的官方教程：
[14] by beiyuu
[15] by 虫师
[16] by Joanna Wu
[17] by c4fun
[18] by Kesco
[19] by zippera
[20] by kevin chen
[5]（推荐）
[6]本地测试页
这里有我的个人简介：
如果你想看到我最新的文章，可以关注我的微信公众号「cnfeat」。
思想也是生产力。
打开微信“扫一扫”，打开网页后点击屏幕右上角分享按钮
被以下专题收入，发现更多相似内容：
本专题暂时关闭投稿。
请移步投稿语言·翻译专题 /collection/ef51d47f...
· 219501人关注
年轻的你，在这里遇见更好的她/他和自己
加入《大学生世界》读者交流群请私信管理员，管理员会审核通过后邀请！
· 25641人关注
欢迎投稿 将实用的知识共享
· 23363人关注
思想也是生产力。
选择支付方式：