jekyll+github pages

2023-03-10,,

写在前面

这篇文章记录了我折腾jekyll,github pages的过程,看到别人的 xxxx.github.io,于是我也想搞一个,了解到大都使用的jekyll来生成的。最开始我还不知道可以直接fork别人在github上面搞好的jekyll blog,然后删除他的文章、图片,修改一些配置比如_config.yml,就可以快速的折腾出自己的网站了。如果知道以上知识,那么其实花不了几分钟,就可以搞完了。于是我是从最麻烦的步骤搞起,首先在我的win10上安装jekyll,然后new出一个blog,然后jekyll build出静态网页,把静态网页push到我的github仓库。这里,我又傻了一次,其实直接把jekyll的这些源文件push上去,github会自己给你jekyll build出静态页面的,不需要你自己电脑build后再push静态网页上去。当然,自己build再push也是可以work的:)

ok,下面的重点也就是了解一下windows下怎么安装使用jekyll,由于墙的存在以及国际网络出口的问题,必须把gem的源修改为国内,主要也就是这些小麻烦了:)

不过,搭完后我就觉得没意思了,github整天被墙,git pages也没啥访问流量,还不如在国内的几个技术博客网站写。所以我乖乖回到博客园:)顺便鄙视一下csdn

windows下安装并运行jekyll

安装 ruby + gem

说明,我的环境是 win10
安装ruby https://rubyinstaller.org/ ,找个最新的下载就行
安装gem(这是ruby的包管理工具) https://rubygems.org/pages/download ,找个zip包安装,解压出来进入目录,执行 ruby setup.rb
gem 修改源(国外的源通常下载失败,换个国内源)

查看当前有哪些源: gem sources 删除掉,通常官方是这个: gem sources --remove https://rubygems.org/

删除缓存: gem sources -c

更新缓存: gem sources -u

添加中科大的源(如果中科大的加不了,搜索一下 gem 国内源): gem sources -a https://mirrors.ustc.edu.cn/rubygems/

安装 jekyll

gem install jekyll
gem install bundler
gem install minima
gem install jekyll-feed

jekyll 创建新的博客出来

cd d:
jekyll new myblog

可能会卡到 Running bundle install in 这一步

这时候 ctrl+c 终止掉,进入新建的项目

将 gemfile 的 source "https://rubygems.org" 改为 source "https://mirrors.ustc.edu.cn/rubygems"

然后运行 bundle install

运行

cd blog目录

jekyll server 或者 bundle exec jekyll serve

浏览器访问 http://127.0.0.1:4000

jekyll+github pages的相关教程结束。

《jekyll+github pages.doc》

下载本文的Word格式文档,以方便收藏与打印。