Github Pages+Jekyll快速搭建个人博客

1. 创建Github Repository

登录Github,新建一个代码库(repository)。假设账户名为user,代码库名为repository。

Tip:大多网络文章都强调并标明,该代码库的名称必须与账户名相同。其实不然,可以随意取名(例如,笔者将其取名为personal)。但是,如果名称是用户名时,后续生成网址正好为最简短的形式,即 https://username.github.io;如果采用其他名称,则会在网址后额外添加一个项目名,例如 https://username.github.io/personal

a. 将代码库拷贝到本地

$ git clone github.com/user/repository.git

b. 推送更新

$ git add index.html
$ git commit -a -m "first pages commit"
$ git push

Tip:Github官方要求“User pages must be build from the master branch”,因此以上操作均在master分支上。其他种类的Github pages可能只有gh-pages分支的代码才会被自动生成网站链接。

c. 加载网站

推送更新之后,很快Github就会帮你自动完成网站构建。链接如下:

https://<username>.github.io/<repository>

2. Jekyll 安装

1.检查 Ruby 版本号(必须高于ver-2.0.0,如果没有得先安装)

$ ruby --version

2.安装 Bundler(管理 Gem 相依性的工具,例如jekyll)

$ gem install bundler

3.安装 Jekyll

首先需要在 repository 的根目录下生成 Gemfile 文件,内容为:

source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins

使用 Bundler 安装 Jekyll

$ bundle install

至此,所需的工具均已构建完毕。

3. 使用 Jekyll 模版快速丰富网站

网络上提供了大量适用于 GitHub Pages 的 Jekyll 模版,推荐一个网站:

各种风格任你选,下载一个并将解压后的文件放到你的 repository 根目录下。

本地服务器预览:

$ bundle exec jekyll serve
Configuration file: /Users/octocat/my-site/\_config.yml
            Source: /Users/octocat/my-site
       Destination: /Users/octocat/my-site/\_site
 Incremental build: disabled. Enable with --incremental
    Generating...
                done in 0.309 seconds.
 Auto-regeneration: enabled for '/Users/octocat/my-site'
Configuration file: /Users/octocat/my-site/\_config.yml
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

在本地浏览器访问 http://127.0.0.1:4000/,就可以预览网站效果啦。当然,网页信息都还是模版自带,以后的工作就变成了修改本地文件并使用 GitHub 进行代码托管了。

Tips: 模版目录中 _site 是由 Jekyll 转换生成,用于保存本地预览页面,因此建议将 _site 目录放进你的 .gitignore 文件中。

4. 绑定域名

可参考 GitHub Pages 绑定来自阿里云的域名

相关资料

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

推荐阅读更多精彩内容