Jekyll installation and local build

Disclaimer: This article was originally written in a personal blog , and here is the author's own reprint.


We can easily build a personal blog through Github-Pages provided by Github, and the default build tool for Github-Pages is Jekyll.

This article mainly introduces how to install and configure Jekyll environment on Ubuntu system for building and debugging your Github-Pages project locally.

Pre-installed

Jekyll relies on the Ruby environment. Ruby and RubyGems must be installed before Jekyll is installed.

# 1.安装ruby
$ sudo apt install ruby-full ruby-bundler

# 2.验证ruby安装版本
$ ruby -v
ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-linux-gnu]

# 3.验证gem安装版本
$ gem -v
3.1.2

# 4.配置国内gem source(https://rubygems.org太慢)
$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

# 5.验证gem source配置,确保只有 https://gems.ruby-china.com
$ gem sources -l
https://gems.ruby-china.com

At this point, the preparations for installing Jekyll are complete, and then start to install Jekyll.

Install Jekyll

The steps to install Jekyll are simple:

# 使用gem安装jekyll
$ sudo gem install jekyll

# 验证jekyll安装版本
$ jekyll -v
jekyll 4.2.0

At this point, Jekyll has been installed.

Build Github-Pages project locally

  1. Move your Github-Pages project cloneto the local and switch to the correct branch

  2. Start building

    # 修改bundle镜像配置,这样就不用修改Gemfile中的source配置
    $ bundle config mirror.https://rubygems.org https://gems.ruby-china.com
    
    # 先使用bundle安装Gemfile配置中的插件
    $ bundle install
    
    # 启动项目
    $ jekyll serve
    
  3. Local default access address:http://127.0.0.1:4000

Guess you like

Origin blog.csdn.net/m0_55236025/article/details/113749407