在github上搭建属于自己的博客

今天试着在github上搭建自己的博客，由于不怎么动前端，所以搭建的博客很丑。我也是在网上找的资料，然后按照顺序，一步一步的来，经过了多次失败，终于成功了（虽然很丑，但仍然很高兴）。

原文地址：http://www.cnblogs.com/EX32/p/4479712.html

废话不多说，直接开始。

工具：自己的github，git工具

一、在github上创建一个项目

直接上图，简单明了







项目创建完成

二、安装git

git是一个免费的、分布式的版本控制工具，或是一个强调了速度快的源代码管理工具。

git的安装地址(http://msysgit.github.io/)

关于git的具体安装步骤可参考http://jingyan.baidu.com/article/90895e0fb3495f64ed6b0b50.html

关于git的常用命令可参考http://www.bootcss.com/p/git-guide/

三、clone项目

git安装好后，创建个目录（地方自己选），在桌面右键，选择Git Bash，出来了命令行界面，如图



切到你创建的目录下（不会的请自行百度，或者直接在你创建的目录下右键，选择Git Bash）
然后使用git命令将项目clone下来

git  clone  你的项目地址

四、创建配置文件

项目clone下来后，用git命令行切到你的项目目录下，或者打开你的项目，右键选择Git Bash

接着在git命令行输入命令

>>  config.yml

执行后，你会发现你的项目根目录下 出现了一个文件  config.yml (这是你刚才执行的命令创建的文件)
然后右键这个文件，打开它（千万不要用window自带的记事本打开，会坑死你的，会报一个编码问题），用NotePad++ 或EditPlus软件打开这个文件
在这个文件里输入一行话

baseurl: /项目名称

输入完成后，保存，关闭

这时你的项目目录下应该只有这一个文件，如果还有 .git  这个文件夹，请不要理它

五、创建主页

在项目的根目录下，创建一个index.html文件，打开（也推荐你用NotePad++ 或EditPlus打开）
然后输入一下内容

---
title: Hello, My Blog
---

{{ page.title }}

然后保存关闭

六、在_posts内撰写文章，并在首页加入文章列表

在项目的根目录下，创建_posts文件夹，在_posts文件夹里创建格式为 year-month-day-postTitle  这样的，例：2015-05-05-my_first_article.md，后缀为 .md 的
然后打开它（notepad或editplus），输入如下内容

---
title: 我的第一篇文章
---

# {{ page.title }}

## 目录
+ [第一部分](#partI)
+ [第二部分](#partII)
+ [第三部分](#partIII)

----------------------------------

## 第一部分

这里是第一部分的内容

----------------------------------

## 第二部分

这里是第二部分的内容

----------------------------------

## 第三部分

这里是第三部分的内容

{{ page.date|date_to_string }}

然后保存，关闭
再打开刚才创建的index.html文件

将里面的内容改成如下内容（就是添加了点东西）

---
title: My Blog
---

{{ page.title }}

{% for post in site.posts %}

{{ post.date|date_to_string }} <a href='{{ site.baseurl }}{{ post.url }}'>{{ post.title }}</a>

{% endfor %}

然后保存，关闭

七、配置SSH

因为github和本地代码做推送和拉取时，需要用到ssh的密钥对进行数据加解密，由于github上新建的项目没有添加密钥，所以本地仓库连接不到远程仓库。
检查本地的ssh key

cd ~/.ssh

如果提示：No such file or directory 说明你是第一次使用git。
那就只能配置ssh key 了

生成新的ssh key

ssh-keygen -t rsa -C "邮件地址@youremail.com"

注意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个人主页。点击右上角的 Settings进入设置页面，然后点击SSH Keys页面中的Add SSH key按钮



3、把你本地生成的密钥复制到里面（key文本框中）， 点击 add key 就ok了

八、发布到github

 这个时候我们就可以把页面提交到github上了，到根目录打开git命令行界面

8.1 把刚创建的所有文件添加到本地git库

git add -A

8.2 保持良好的习惯，每次提交都提交添加描述

git commit -m "create my blog"

8.3 推送到GitHub，这里注意，因为我们使用的是GitHub Pages中的 Project Pages，GitHub规定，只有该分支中的页面，才会生成网页文件。即GitHub仅会将分支 gh-pages 下的内容进行自动生成操作， 所以本地的 master 分支应推送到远端的 gh-pages 分支

git push origin master:gh-pages

输入账号和密码，账号即你的GitHub账号(不是昵称，是账号名！)

 然后打开自己的github，步骤如下图





点击setting



点击红线部分，就可以打开你刚才创建的blog了



到此，属于你自己的（丑）blog就创建好了（

），如果有什么疑问，可以去原地址查看，那里有模板等介绍

原文博客地址：http://www.cnblogs.com/EX32/p/4479712.html