Github搭建网站教程

github pages是用来搭建免费的,不限流量的个人网站,可以把自己的东西托管在二级域名 *.github.io 下,本教程就是来简单的说明github pages的使用。

友情链接:

github pages 官网,英文网站。

git简易指南,git的使用简单教程。

git bash下载,git bash的下载地址。

在看本教程前,英文水平OK的可以看看github pages的官网,另外教程中不会涉及github的使用说明,可以在上面的git简明指南中查看,所以默认你是会使用git的。

首先,进入github.com,登陆以后进入到自己的个人空间,点击 Repositories ,选择 new ,创建新的git仓库。如下图所示:

之后这一步很重要,创建的仓库的名字一定要是 yourname.github.io 的格式,前面是你自己的github名字。接下来可以选择下面的”initialize this repository with a readme”,创建原始的readme,最后选择 “create repository”,创建仓库即可 。如下图,由于我已经创建过这个 域名了,所以提示我这个仓库名已经存在。

创建成功以后,会进入到自己的仓库的主页,接下来我们选择上边sidebar里面的 “settings” 选项。如下图所示,当然刚创建成功的话,仓库里面只有Readme.md一个文件。(接下来用另外一个github的账号about来说明好了)

我们进入到settings界面以后,滚动到下面的Github Pages栏。点击 “Choose a theme” 按钮。如下图所示:

之后任意选择一个模板,点击“Select theme”按钮,你的个人网站域名就生成了。如下图:

等两三分钟,下面就是我们原始的github pages首页了。如下图:


配置GIT

clone github代码到本地,先配置git,首先在本地创建ssh key;

$ ssh-keygen -t rsa -C "your_email@youremail.com"

后面的your_email@youremail.com改为你的邮箱,之后会要求确认路径和输入密码,我们这使用默认的一路回车就行。

成功的话会在~/下生成.ssh文件夹,目录如下图,进去,打开id_rsa.pub,复制里面的key。

回到github,进入Account Settings,左边选择SSH Keys,Add SSH Key,title随便填,粘贴key。类似于:

ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA63rye64sOsj3wINkbDKcnEC78bG/Bg0DBS5Q6TZaEglIHTAhszWu/meFuUiUHGpKSzVc29DHeqaM7Jvad3zhcaceu5Bl1OFT7devC0Q3s5k+MYwdIwc/OiiF9MBia5iXxS6N2i7NSEoXjFiS2EcpXPmhn/pljxCIzOhJy2OB3i6VBJJBFYb2BL03/ozOqnI3hKk3o8hpop28UkzKr4f+ObPZDAyI9riXhbu5nnZDqQSzlwv3NDoZOOWm9t8NcEUIeMSSB5+FGY64CPGE85GUop1+2QcVpRBMd2CU3R4NtFllFYwnf9f3uGoXG6IBPBP2EO3KBGXaHj0v83rpqbt+2w== cdkd321@126.com

为了验证是否成功,在git bash下输入:

$ ssh -T git@github.com

如果是第一次的会提示是否continue,输入yes就会看到:

You’ve successfully authenticated, but GitHub doesnot provide Shell access 。

这就表示已成功连上github。

接下来我们要做的就是把本地仓库传到github上去,在此之前还需要设置username和email,因为github每次commit都会记录他们。

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

$ git config --global user.email "your_email@youremail.com" 

将github代码clone到本地:

$ git clone https://github.com/galan99/haha.git

提交、上传,接下来在本地仓库里添加一些文件,比如README,

$ git add -A

$ git commit -m "first commit"

上传到github:

$ git push origin master

输入指令成功如下图

如果这一步,产生了一些错误:

To git@github.com:lzjun/test.git ! [rejected] master -> master (non-fast-forward) error: failed to push some refs to 'git@github.com:lzjun/test.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.

可以先pull,同步一下代码:

git pull git@github.com:lzjun/importnewstat.git master

git push命令会将本地仓库推送到远程服务器。

git pull命令则相反。

修改完代码后,使用git status可以查看文件的差别,使用git add 添加要commit的文件,也可以用git add -i来智能添加文件。之后git commit提交本次修改,git push上传到github。

解决github提交代码一直输入用户名密码

在git工具命令行输入命令:"git config --global credential.helper store",这一步会在用户目录下的.gitconfig文件最后添加

git工具粘贴快捷键:"Insert"。

按照这个教程来的

那么问题来了!。。华丽的分割线

我们当然不止只有一个仓库,如果我们有其他的项目仓库也希望能挂在github pages上面呢。比如下面这个:

其实和创建前面的步骤差不多,但是如上图所示,这个时候我们可以任意定义我们的仓库名字了,创建成功之后还是进入到 “settings部分”,选择上面提到的 Automatic page generator 按钮 。在网站成功创建以后,这里有个问题就需要特别注意了:分支。 在上面创建的网站,生成以后的文件默认是放在 master 分支里面的,而在以后的仓库的网站生成以后,放的地方是在 gh-pages 里面的,所以我们需要到 “setting” 里面设置我们的默认仓库是 gh-pages。如图:

回到仓库首页以后,可以看到 commit ‘ create gh-pages branch via github’,这个就是原始的分支文件。接下来的事情就是把我们这个仓库 git clone 到本地了。(这一步就不赘述了,相信看了前面友情提示下的git简易教程,你是会的)

然后我们进入到我们的目录中,比较暴力的我就把原本的文件全部删掉,然后放进了我自己的文件。当然不能删掉里面的.git文件夹了。

之后在git bash中提交就完成了。上图涉及到的文件是我的项目fullpage的文件,可以点击这里查看。这样就大功告成了!如今访问,例如 http://cody1991.github.io/fullpage 或者 http://cody1991.github.io/ 都可以了。另外想要搭建像我这样的一个github pages jekyll博客的话,可以访问它的主页jekyll 主页或者jekyll 中文网站。我自己这个jekyll网页还很丑。。基本没有美化 ╮(╯_╰)╭ 是它原本的样式。