在建立github个人主页注意事项

1 ，基础

在进行所有的工作之前，先确保你已经理解一下内容：

git的分支；git add命令的含义；git commit命令的含义；git remote 与 git push的关系；

可以参考该视频作者的教程：http://i.youku.com/u/UMTc0ODYxNDcy

另外，也可以进行一些特别的设置，例如：

$ git config --global alias.ci "commit -a -v"

$ git config --global core.editor vim （设置git编辑器为vim）

这时候，

$ git ci

就等同于

$ git commit -a -v

2，git密钥

git的所有操作都需要密钥来验证操作用户是否合法，所以你必须为自己的帐号配置至少一个密钥

$ cd ~/.ssh

$ ssh-keygen

创建新的密钥对，然后将id_rsa（私钥）拷贝一份保存起来，将公钥复制到git上面的公钥栏即可

3， push本地数据

在push时出现以下问题：

$ git push -u origin master

To git@github.com:xxx/Hello-World.git 

 ! [rejected]        master -> master (non-fast-forward)  

error: failed to push some refs to 'git@github.com:xxx/Hello-World.git'  

To prevent you from losing history, non-fast-forward updates were rejected  

Merge the remote changes (e.g. 'git pull') before pushing again.  See the  

'Note about fast-forwards' section of 'git push --help' for details.  

解决方法

先执行一下命令：

$ git pull origin master (接收数据)

然后再

$ git push -u origin master

就可成功。

4 （使用官方博客模板）

建立起个人主页后，可以使用git官方的博客模板建立自己的博客主页。

进入以下网址：

https://help.github.com/articles/creating-pages-with-the-automatic-generator

按步骤执行即可

5，切换分支

以上命令是在master分支建立的，那么如何将该项目切换到自己定义的分支---例如gh-pages分支进行呢？

$ git checkout gh-pages（切换到自己定义的分支）

$ git pull origin master （把master上的内容拉到当前分支上（保存在本地））

$ git push origin gh-pages （把本地的gh-pages分支内容推送到github上）

完成。

或者直接建立一个新的分支，

$ git push -u origin 你建立的分支  （把master里的内容推送到你建立的分支）

完成。

如果要删除一个分支应该怎么办呢？

$ git branch -D "your-branch" （注意这是强制删除分支）

$ git push origin :"your-branch"

即可。

6，修改、提交博客内容

之后如果要修改你的博客内容的话，就可已在本地修改，然后

$ git add .

$ git commit -m 'XXX'

$ git push

即可。

7，html格式的文档

在html页面中添加链接的固定格式：

<a href="链接地址" class="user-mention">@链接名称</a>

写一个段落：

<p>你要写的内容</p>

8，异地提交

如果要在多台机器上面对github项目进行修改，应该怎么办呢？比如说你公司的机器不能使用，临时要在网吧继续github的项目，这是应该怎样操作：

首先，在目标机器上面建立工作的环境。

拷贝本机公钥

$ cd ~/.ssh/

$ gedit id_rsa.pub

将里面的内容粘贴到 github sshkey里面

建立项目文件夹，初始化并且将项目拉到本地来方便修改

$ mkdir proj.github.com

$ cd proj.github.com

$ git init

$ git config --global user.name "qiaoqiangv"

$ git config --global user.email qiaoqiangv@126.com

$ cat ~/.gitconfig

将项目拉到本地

$ git remote add origin git@github.com:qiaoqiangv/qiaoqiangv.github.com.git （把远端项目添加到本地）

$ git pull origin master （把master的内容拉到本地来）

*以上两条等同于

$ git clone git@github.com:qiaoqiangv/qiaoqiangv.github.com.git 

添加你的修改

$ git add .

$ git commit -m 'anything'

$ git push

即可修改成功

如果git commit之后出现如下字样：

# On branch master
# Your branch is ahead of 'origin/master' by 1 commit.
#
nothing to commit (working directory clean)

说明commit没有成功，这时使用

$git push origin master

Everything up-to-date

即可以推送成功

9， clone别人的博客

如果想使用使用别人的博客作为模板，来创造自己的博客，按照以下步骤进行

$ git clone git@github.com:"user_name"/"user_name".github.com.git （将该博客内容复制到本地）

$ cd user_name.github.com

$ cp -r * your_name.github.com

$ cd your_name.github.com

$ git add .

$ git commit -m 'msg'

$ git push

再登录你的主页就可看见更改内容

10，另外（使用jekyll建立博客）

到这个网页，找到【Install the gem】这一行，跳过它，往下按照步骤操作（因为不是配置服务器，所以没必要安装）

https://github.com/mojombo/jekyll/wiki

http://www.pizn.net/24-09-2011/use-github-pages-to-build-a-blog/

http://www.worldhello.net/gotgithub/03-project-hosting/050-homepage.html

http://www.kuqin.com/managetool/20110724/92666.html

11，在用markdown语法写作的博客中添加代码

在 每行 代码之前要有一个TAB或者是四个空格的缩进，要不然会被当成html语言而无正常打印

git详细讲解看这里：

Git 版本管理工具（一）

Git 常用命令详解（二）

Git 常用命令速查表（三） 

Git 操作实战示例（四）