【搭建个人简历的开发日志】Github Page + Jekyll

1,268 阅读3分钟

写在前面

搭建个人简历的开发日志系列仅为个人记录过程所用,可能比较缺少参考和学习的价值。同时,因为伴随着毕业设计和诸多事项,记录更新会比较弧长。第一次写这类开发日志,希望以此作为积累,不断前进。

创建Github仓库

Github Page是Github旗下的一项服务,它能够帮助你托管静态网页。其中Github Page的官网指路➡️Github Page Offical Website

在个人的Github仓库页中,点击New按钮,创建新的Github仓库。

创建新的仓库

之后,设置仓库的名称、描述,以及添加README.md和其它必要文件等。注意,此处的仓库名必须为{userName}.github.io的形式。例如,我的Github用户名为AlchemyZJK,那么我的仓库名必须为AlchemyZJK.github.io。此处由于二次演示记录的原因,导致AlchemyZJK.github.io这个仓库名已经被注册。

配置仓库

创建完之后就是熟悉的步骤,比如clone到本地之类的,此处不再赘述。克隆到本地后,我们打开Terminal,按照Github Page官网的操作测试Hello World静态网页。

$ cd username.github.io
$ echo "Hello World" > index.html

之后,你会发现多了_config.yml和index.html文件。然后在Github仓库的Setting中,可以发现这个index.html的静态页面在https://{userName}.github.io上。打开这个网页,就能看到测试的Hello World朴实地展示在那里。

Setting按钮

查看Github Page网址

在这里的Theme中,我看到了Jekyll,从此踏上了Jekyll环境配置的道路。

Jekyll环境配置

其实在Github Page官网的最下方,有如果使用Jekyll搭建静态网页的连接,点击进入后有详细的文档。Link召唤

Blogging with Jekyll

Jekyll也有自己的官网,连接请走这里。Link召唤

以下的环境搭建主要参考自以上两个官方网站。自己在环境搭建上耗费了很久的时候,可能主要是因为对于环境的某些东西的功能作用不熟悉和环境配置PATH的问题。

安装Homebrew

一开始我没打算装,然后就很难受。在Homebrew官网上可以找到下载方式,简单的Terminal语句。

Homebrew官网下载方式

但是好像因为资源更新和包大小的原因,国内下载会导致各种幺蛾子,翻墙也不能解决。所以,我只能寻找国内的镜像资源下载安装。国内的镜像资源安装下载:此处为中科大镜像。

$ /usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"

安装Ruby

Mac系统自带有Rudy,不过可能会版本比较低,需要自行安装或升级。按照Ruby官网的操作进行安装。

$ brew install ruby

之后重启Terminal,查看Ruby版本,看版本是否匹配以及环境PATH是否已经添加。

$ ruby -v

安装RubyGerms

RubyGems is a package management framework for Ruby. 一般安装完Ruby之后,已经安装完了RubyGerms。不过,可能有版本更新的问题,用以下命令进行更新。

gem update --system

但是,RubyGerms由于其源在国外,存在有被墙的情况,需要替换国内的源。

# 添加国内源,删除国外源
$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/ 

# 查看所有源
$ gem source -l

# 所有源中只有国内源即可

# 更新
$ gem sources -u 

安装bundler

更新RubyGerms的源之后,bundler安装就比较顺利了。

$ gem install bundler

安装Jekyll

$ gem install jekyll

在安装Jekyll的过程中,我遇到了似乎是环境配置的问题,在查询了一些其他人的博客之后,添加了环境变量。

一定要注意环境变量的添加格式!!!我一开始格式写错了,导致Terminal的所有命令都使用不了,吓了我一跳,然后半夜一项项排查,才发现是我环境变量写错了ORZ

# 打开.bash_profile
$ open -e ~/.bash_profile

在记事本中添加或者修改环境变量,之后保存,并刷新。也可以使用vim修改,完成上述步骤。

# 刷新
$ source ~/.bash_profile

环境变量配置

创建文件等

之后,按照Jekyll官网的相关过程,创建一个新的文件夹,开始之后的初始化操作。

初始化

在http://localhost:4000本地能够看到你的初始化静态网页了。

初始化网页
其实,将这些更新提交到你的Github仓库中,就可以在https://{userName}.github.io看到它了。