搭建Github-pages的环境准备

在GitHub上搭建个人博客

换源：

$ bundle config mirror.https://rubygems.org https://gems.ruby-china.com

参考文档

• github-pages： https://docs.github.com/zh/pages/quickstart
• Ruby & jekyll on wsl：https://stackoverflow.com/questions/37405528/installing-ruby-2-3-on-wsl-windows-subsystem-for-linux

Ruby安装

在Windows上安装Ruby

1. 在Windows上安装jekyll，前往https://jekyllrb.com/docs/installation/windows/找到安装包，下载Ruby和Devkit作为Windows上的依托，下载地址：https://rubyinstaller.org/downloads/。
2. 根据可视化界面的提示一步一步安装，除了路径以外官网推荐默认选项，需要将路径添加到PATH路径下（理论上是自动的）。
3. 在弹出的命令行中运行risk install，但实际上并不一定需要你手动输入，可能直接就装起来了。然后选择安装选项，我的显示的是3. MSYS2 and MINGW development tool chain，会经历一个相对漫长的等待过程。

在WSL2上安装Ruby

1. 安装Ruby，首先安装一些必要的包：

    $ sudo apt-get update
    $ sudo apt-get install git-core curl zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev
   

2. windows环境下用了RubyInstaller，这次用一下三方的安装工具和包管理器rbenv：

    $ cd
    $ git clone https://github.com/rbenv/rbenv.git ~/.rbenv
    $ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
    $ echo 'eval "$(rbenv init -)"' >> ~/.bashrc
    $ exec $SHELL
   
    $ git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
    $ echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
    $ exec $SHELL
   
    $ rbenv install 3.2.2
    $ rbenv global 3.2.2
    $ ruby -v
   

   经过一定时间的等待：

    $ ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-linux]
   

安装jekyll

1. 打开新的命令行，为了让PATH的改变生效，不然找不到相关命令。运行gem install jekyll bundler，然后又是漫长的等待。

2. 最后装没装好，运行jekyll -v看一下版本就好。

配置jekyll

1. 在拉取的github.io文件路径下运行， 由于当前路径下可能有文件，比如我的README.md，因此要强制执行一下。

    $ jekyll new --skip-bundle --force .
   

2. 打开Gemfile文件，修改配置，将 GITHUB-PAGES-VERSION 替换为 github-pages gem 的最新支持版本。 可以在以下位置找到这个版本：https://pages.github.com/versions/。

   • 注释掉gem "jekyll" 开头的行；

   • 编辑以 # gem "github-pages" 开头的行，以添加 github-pages gem。 将此行更改为：

      $ gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
     

3. 保存并关闭 Gemfile，从命令行中，运行 bundle install。

本地测试

1. 运行bundle install

2. 安装webrick，新版本Ruby不再默认安装（踩坑了）：

    $ bundle add webrick
   

3. 在本地运行站点：

    $ bundle exec jekyll serve
   

4. 在 http://localhost:4000 访问并查看。