搭建个人GitHub Pages站点——入门

搭建前的准备


1. 注册个人的GitHub账号。

2. 安装GitHub的本地客户端。

简单介绍GitHub:提到GitHub首先应该想到的是Git,Git是一款优秀的版本库管理工具。GitHub就类似于存放Git库的服务器。

创建GitHub Pages

简单介绍GitHub Pages:免费的静态站点,三个特点:免费托管、自带主题、支持自制页面和Jekyll


建立git仓库

1. 登陆GitHub WEB客户端,进入个人的GitHub首页

2. 新建一个个人站点的托管库,托管库的名字为your-GitHub-name.github.com。例如我的GitHub账户名是danielfengyu,所以我的托管库的名字就叫danielfengyu.github.com


GitHub Web端创建库的入口


创建yourgithubusername/github.com的库


创建成功站点代码托管库

3. 在本地建立一个目录,该目录是你个人站点的本地仓库,你要提交到GitHub服务器上的关于个人站点的一些内容就是放在该目录下,然后通过Git提交到GitHub服务器的托管站点的。

4. 打开Git Shell,进入第3步创建的目录,把该目录初始化为一个本地新仓库,命令:git init


5. 建立本地仓库与远程仓库的联系

命令:git remote add origin https://github.com/username/username.github.com.git。注意把username替换为你自己的GitHub账户名。


安装Ruby

1. 下载Ruby最新版本。

2. 根据Ruby官方网站的指导下载相应的Ruby版本,我使用的是Windows系统,所以直接下载Windows平台的安装包:RubyInstaller。

Ruby的安装说明


各个系统的Ruby包


3. 安装完成后,在“开始”菜单下有一个Terminal名字是“Start Command Prompt with Ruby”


安装一些依赖于Ruby的插件

这步说明了为什么需要先安装Ruby,因为有几个插件(工具)需要依赖于Ruby。

安装Bundler

1. gem install bundler

注意:1、gem是一种安装工具,类似于Linux系统的安装工具apt yum等。2、运行这个命令会出错,是因为运行这个安装命令的时候,下载bundler的路径在国外Amazon的服务器上,被墙了。这里提供一种解决方法,就是把国外的gem服务器换为国内的镜像站点,我是使用的淘宝建立的一个国内镜像站点

安装期间出现一个错误:

ERROR: Could not find a valid gem‘bundle’ (>= 0), here is why:

Unable to download data fromhttps://rubygems.org/- Errno::ECONNRESET: Connection reset by peer - SSL_connect (https://rubygems.org/latest_specs.4.8.gz)

解决错误的办法

1. # gem sources --remove https://rubygems.org/

2. #gem sources -ahttps://ruby.taobao.org/(运行这个命令必须先安装证书,不然淘宝的镜像站点不允许链接)。

3. # gem sources -l

安装SSL证书

1. 下载cacert.pem

2. 设置环境变量SSL_CERT_FILE,其值为下载到本地的cacert.pem的路径。我的为F:/Ruby/cacert.pem。

3. 重启Ruby终端,再次输入bundler安装命令gem install bundler,这次安装成功

安装Jekyll

1. geminstalljekyll


使用Jekyll建立一个本地的静态网站

1. 新建一个存放本地站点的目录,如G:/jetyll sites

2. 进入该目录,执行命令:jekyll new <your-site-name>

新建本地站点

3. 进入新建的本地站点根目录:cd <your-site-name>

4. 启动本地Jekyll服务:jekyll s

启动Jekyll服务,调试本地站点

5. 经过以上几步,就可以在本地调试你的网站了。在浏览器中输入http://localhost:4000/。可以看到Jekyll生成的站点的首页。

Jekyll生成的站点首页

6. 使用jekyll创建运行环境下使用的静态网站。jekyll build --destination  <destination> #=>当前文件夹中的内容将会生成到目标文件夹<destination>中。这里的目标目录就是前面穿件的本地的Git库目录:G:/MySite

Jekyll生成站点到指定的目录

7. 1、目标目录下的静态站点的目录结构

生成的目标目录下的站点


把静态站点提交到远程仓库

1. 打开Git shell,进入个人站点的本地仓库目录。依次运行如下命令,把本地静态网站的页面提交到远程的GitHub仓库中。

2. 依次运行:

git add .

git commit -m "Initial commit"

git push -u origin master

提交本地站点到远程repository

2. 在自己的GitHub WEB客户端页面,打开yourname.github.com库,可以看到如下内容。

远程仓库中看到的代码结构

3. 在浏览器中输入地址:https://yourname.github.io/(yourname指的是你的GitHub账户名),就可以访问你的个人站点了。首页如图:

访问自己GitHub Pages站点,看到的首页

添加自己的域名

如果你想添加自己拥有的域名,可以参考:域名添加。由于我自己也没有域名,这里就不介绍如何添加自己的域名。

总结

到此就搭建完成了一个基于GitHub Pages的个人站点。后续会学习怎么美化GitHub Pages上的个人站点。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,716评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,558评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,431评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,127评论 0 209
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,511评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,692评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,915评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,664评论 0 202
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,412评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,616评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,105评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,424评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,098评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,096评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,869评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,748评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,641评论 2 271

推荐阅读更多精彩内容