美文网首页
搭建个人GitHub Pages站点——入门

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

作者: 山间听雨者 | 来源:发表于2016-06-05 15:00 被阅读355次

搭建前的准备


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上的个人站点。

相关文章

网友评论

      本文标题:搭建个人GitHub Pages站点——入门

      本文链接:https://www.haomeiwen.com/subject/lklrdttx.html