文章

了解jekyll与准备开发环境

此篇文章为《使用Jekyll构建个人博客》的第一篇,主要介绍在个人电脑上使用jekyll构建博客所需要的一些基础条件,转载请注明出处。

关于Jekyll


是什么东西

Jekyll 是一个由ruby实现的简单开源静态站点生产机器。支持将MarkDown(纯文本 至 html 的渲染工具)、Liquid(ruby实现的开源模板引擎)甚至LaTeX的内容转化成完整的静态网站。你可以将Jekyll构建的网站发布到任何服务器上,包括免费的GitHub Pages、国内的Gitee Pages

为什么选择它

  • 使用简单,不需要数据库,支持博客的自定义布局、分类、标签等
  • GitHub Pages 基于 Jekyll 构建,你可以轻而易举地在 GitHub 上免费发布网站——自定义域名,很多前端同学把自己设计的网站在 Github 仓库共享,你 fork 到本地仓库后很轻松的就能构建出自己的博客。
  • 生态强大,互联网上很容易检索到各种的文档资料(含中文)、插件、皮肤模板

怎么查阅它的更多资料



搭建本地环境

前期准备

  1. 一台能上网的 Ubuntu 或者 macOS 系统的电脑(笔记本、台式机不限,能正常开机运行操作系统即可)

  2. 使用 Mac 的同学请安装包管理器homebrew。使用 Ubuntu 的同学可使用系统自带的apt-get

  3. 为了提高软件的下载速度,建议将安装包管理器的软件源更换为国内的镜像。使用 Mac 的同学请参考 Homebrew / Linuxbrew 镜像使用帮助。使用 Ubuntu 的同学请参考 Ubuntu 镜像使用帮助

装 Windows 系统的同学建议下载安装vmware,在 Vmware 平台上安装ubuntu虚拟机,macOS 和 Ubuntu 这种 Unix-like 系统对新手开发更友好,安装软件也更方便。不建议用 Windows Subsystem for Linux,某些软件安装可能会报不适配内核的错误。

安装编译工具

  • macOS 建议直接安装 Xcode Command Line Tools。
1
xcode-select --install 
  • Ubuntu 首先检查本地是否已经安装了 GCC 与 Make。在控制台输入gcc -v/make -v,如果返回了版本信息,即可跳过此步骤,如果未找到命令,请使用包管理器安装对应的编译工具。
1
2
3
4
#安装 GCC
sudo apt install gcc
#安装 Make
sudo apt install make

安装 Ruby

依然先检查本地是否安装了 Ruby ruby -v (很多系统默认安装了),如果此时 Ruby 版本号 $ \geq$ 2.5.0,即可跳过此步骤

  • 如果未安装 Ruby,macOS 使用sudo brew install ruby,Ubuntu 使用sudo apt install ruby-full 安装 Ruby
  • 如果版本号$\lt$ 2.5.0,如果安装一个更高的版本来兼容 Jekyll (针对 macOS,Ubuntu当前源中 ruby-full 包是2.7.0)
    1. 首先使用sudo brew install ruby安装最新的 Ruby包(截止目前, Brew 源中的 Ruby 版本是3.0.1)
    2. 然后在/usr/local/bin 中创建指向新版 Ruby 的软连接
      1
      2
      
      sudo ln -s /opt/homebrew/Cellar/ruby/3.0.1/bin/ruby /usr/local/bin/ruby
      sudo ln -s /opt/homebrew/Cellar/ruby/3.0.1/bin/gem /usr/local/bin/gem
      
    3. 重启控制台,再检查 ruby -v ,此时的版本就是最新的了

macOS 系统默认安装的 Ruby 在/usr/bin中,而这个目录是受系统保护的(无法修改与删除),macOS 建议用户创建 /usr/local/bin 目录,在其中可以放新版本的软件以替代系统自带的老版本软件。

安装 Jekyll 并使用它

RubyGems 是 Ruby 的一个包管理器,而 Jekyll 是 Ruby 的一个 Gem 包,由于官方的 RubyGems 源在国内难以访问,建议参考Ruby China更换为国内源。

  1. 安装 Jekyll Gem 包
    1
    
    gem install jekyll bundler
    
  2. 使用 Jekyll 命令创建一个站点
    1
    
    jekyll new myblog
    
  3. 进入目录并开启 Jekyll 服务
    1
    
    cd my_blog && jekyll s -l
    
  4. 使用浏览器访问 http://localhost:4000

好了,你的本地环境完成了,至此你可以用Jekyll构建你的网站了。

本文由作者按照 CC BY 4.0 进行授权