Jekyll 相关资源整理

  • Jekyll 主题 / Jekyll 插件 /

  • Windows 需要先安装 RubyInstaller,给电脑装上 Ruby
  • 备用方案(未测试过):使用 Scoop 安装 Ruby

Windows 安装 Ruby 和 RubyGems

安装包下载和安装

打开 https://rubyinstaller.org/downloads/ 选择WITH DEVKIT下面的安装包

  • 推荐使用最新版本
  • 如果电脑是 32位系统选择 x86 的包,64位系统选择 x64
  • Ruby + Devkit 是集成了 gem 的安装

现在完后打开安装包,除了第一个界面选择同意条款外,后面都直接都是用默认选项,点下一步。

安装完后会引导运行 ridk install,默认是勾选上的,点击完成自动运行 CMD终端

在 CMD 终端界面输入3 并按 Enter 回车键,选择安装 ` 3 - MSYS2 and MINGW development toolchain`

执行完后会再次提示,为保证万无一失,再次输入3 并按 Enter 回车键。再次提示按 Enter 回车键会自动关闭 cmd终端。

在开始菜单点击Start Command Prompt with Ruby 打开并使用Ruby。 这一步不能少。

  • 检查安装是否成功,使用查看版本命令如果有返回版本号就是安装好了
    • 查看 Ruby 版本:ruby -v
    • 查看 gem 版本:gem -v

然后 替换源镜像,再更新 Ruby gem

修改 gem 源为国内镜像

默认的 gem 源安装可能会特别慢,几个小时都没反应,所以先替换 gem 源

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

替换 gem 源后把 bundle 源也换一下

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

替换后检查是否替换成功,如果返回的只有 gems.ruby-china.com 表示替换成功

gem sources -l

更新 Ruby gem

gem update

安装 Jekyll 组件

gem install jekyll bundler

查看 jekyll 当前版本

jekyll -v

推荐环境安装后执行下面命令避免一些报错

安装 webrick

bundle add webrick

全新安装

  1. 新建项目:jekyll new site1px
    1. site1px 是项目名可随意修改
  2. 进入项目文件夹:cd site1px
    1. site1px 是项目名称,要和之前保持一致
  3. 运行服务:bundle exec jekyll serve
  4. 如果提示Run bundle install to install missing gems.,执行下bundle install

git 旧项目直接使用

先安装缺失的 gems

bundle install

如果执行 bundle install 太慢了,可能是bundle源没有改成国内的,可以先终止,再执行下面命令后重新执行bundle install

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

如果只使用 gem source --add --remove修改 gem 镜像,对 bundle install 并不起作用

安装完后,运行服务

bundle exec jekyll serve

常用命令

运行服务

bundle exec jekyll serve

生成静态文件

文件会生成到项目目录下的 _site 文件夹中

bundle exec jekyll build -d _site

常见报错解决方案

`require’: cannot load such file – webrick (LoadError)

运行服务时,出现以下类似报错:

<internal:C:/Ruby32-x64/lib/ruby/3.2.0/rubygems/core_ext/kernel_require.rb>:37:in `require': cannot load such file -- webrick (LoadError)
        from <internal:C:/Ruby32-x64/lib/ruby/3.2.0/rubygems/core_ext/kernel_require.rb>:37:in `require'
        from C:/Users/ll/.local/share/gem/ruby/3.2.0/gems/jekyll-4.2.2/lib/jekyll/commands/serve/servlet.rb:3:in `<top (required)>'
        from C:/Users/ll/.local/share/gem/ruby/3.2.0/gems/jekyll-4.2.2/lib/jekyll/commands/serve.rb:179:in `require_relative'

因为未安装 webrick,执行以下命令安装

bundle add webrick

回到顶部

Copyright © 2017-2024 1px.run (像素教程) Distributed by an MIT license.

Site updated at 2024-10-26 09:00