Welcome to LawooTrip

"Hello World, Hello Blog"

“Yeah It’s on. ”

历时大半个月,断断续续的,终于把个人博客站搭建起来。


目录

1.创建属于你的GitPages

2.配置和使用你的GitPages

3.使用Jekyll搭建博客系统


1.创建属于你的GitPages

既然是在GitHub上搭建博客,当然要先去人家平台上注册自己的账号。

注册流程很简单,基本就是根据官方引导往下走就可以了。

注册号账号后,创建一个属于自己的repository,如下图所示:

注意:repository名称的格式必须是:"ID.github.io"

细节流程参考这个教程

推荐勾选自带README的选项,免去日后还得添加README的麻烦。


2.配置和使用你的GitPages

配置和使用GitHub

本块教程主要参考wayne23的Github的基本配置与使用

配置SSH keys

首先我们需要检查你电脑上现有的ssh key:

cd ~/. ssh //检查本机的ssh密钥

如果提示:No such file or directory 说明你是第一次使用git。

生成新的SSH keys
ssh-keygen -t rsa -C "你用来注册的邮件地址@xxx.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):
<回车就好>

注意: 此处的「-C」的是大写的「C」

然后系统会要你输入密码:

Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>

在回车中会提示你输入一个密码,这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。

注意:输入密码的时候没有*字样的,你直接输入就可以了。

添加SSH Key到GitHub

在本机设置SSH Key之后,需要添加到GitHub上,以完成SSH链接的设置。

MAC下路径

/Users/lizhimin/.ssh/id_rsa.pub.

WINDOWS下路径

C:\Documents and Settings\Administrator.ssh\id_rsa.pub

此文件里面内容为刚才生成的密钥。如果看不到这个文件,你需要设置显示隐藏文件。准确的复制这个文件的内容,才能保证设置的成功。

登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys

把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了

测试

可以输入下面的命令,看看设置是否成功,git@github.com的部分不要修改:

ssh -T git@github.com

如果是下面的反馈:

The authenticity of host 'github.com (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 你的名字! 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  "cnfeat@gmail.com"//填写自己的邮箱
SSH Key配置成功

本机已成功连接到github。

若有问题,请重新设置

常见错误请参考:

GitHub Help - Generating SSH Keys

GitHub Help - Error Permission denied (publickey)


3.使用Jekyll搭建博客系统

这里仅以MAC下的OSX系统为例,Jekyll是用ruby开发的,所以安装Jekyll之前需要执行下面的命令安装一些依赖。

sudo apt-get install ruby ruby1.9.1-dev nodejs

sudo gem install jekyll

至此,你的MAC电脑上已经安装并配置了搭建博客需要的所有的依赖环境。

jekyllthemes 或者知乎挑选一个Jekyll主题,并按照主题的README进行CLONE安装即可。

以本站为例,我选用了Huang Xuan原创的Jekyll主题,主题文档里有中英文的README,十分清晰可靠,强烈推荐。

其他常见问题和基础知识可参见Jekyll官网 ,有中文文档,也十分清晰可靠,强烈推荐。


后记

配置的过程中遇到了不少坑,毕竟不是码农,git从零入手,遇到了merge、fetch各种branch傻傻分不清楚。几度几乎放弃,缺总是被一丝丝的曙光召唤着继续坑自己。

此处强烈推荐geeeeeeeeek-童仲毅关于GitHub的“Git 中文教程”,悉心细读,获益匪浅。**

还有本地调试环境需要 gem install jekyll,结果 rubygem 的源居然被墙了……后来手动改成了我大淘宝的镜像源才成功

Theme 的 CSS 是基于 Bootstrap 定制的,看得不爽的地方直接在 Less 里改就好了。

回顾这个博客的诞生,纯粹是出于个人兴趣。

我不是程序猿,也不是Github的重度用户,只是在找一些产品源码的时候偶遇了GitPages,前几次的碰壁愈发激起了我要攻克他的信念。

今日终于

跑起来了

—— 龟龟 后记于 2017.02



不收钱 加好友

龟龟 / -  阅读量
Published under(CC) BY-NC-SA 3.0 CN.


1