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首页了。如下图:
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。
在git工具命令行输入命令:"git config --global credential.helper store",这一步会在用户目录下的.gitconfig文件最后添加
git工具粘贴快捷键:"Insert"。