github pages本地环境配置

发表于 分类于 阅读次数： 本文字数： 615 阅读时长 ≈ 1 分钟

在win10下搭建github pages的本地环境真是坎坷多舛，各种错误，而且可用的文档也相对较少，中文的更是寥寥无几。。

主要问题有以下几点：

  • jekyll以及其包管理、开发环境的搭建
  • github pages环境的配置

要做到第一点，让所有的依赖符合要求，要么vpn，要么换国内源。

1. 下载安装ruby

下载 rubyinstaller forwindows，注意版本号，比如我在2019.11.06操作时发现，最新的 ruby 2.6和我的Gemfile.lock中的部分组件冲突，不得已下载了2.5的旧版才成功。

安装完成后输入’ridk install’来安装MSYS2, gems等必须组件。问选项的时候一路回车即可。

2. 解决网络速度慢

2.1 更换ruby国内源

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

用gem sources -l检测是否替换成功

2.2 给cmd加上代理

以下命令设置环境变量，只会持续到cmd窗口关闭。

1
2
set http_proxy=http://127.0.0.1:1080
set https_proxy=http://127.0.0.1:1080

2. 安装bundler

gem install bundler

3. 进入博客的repository目录

1
2
bundle install
bundle exec jekyll server

4. 解决“No GitHub API authentication”

  • github: [metadata]

  • 填写 _config.yml 中的站点description

Changelog

2020.8.12 增加切换国内源及加代理

2019.11.06 重写