了解jekyll与准备开发环境
此篇文章为《使用Jekyll构建个人博客》的第一篇,主要介绍在个人电脑上使用jekyll构建博客所需要的一些基础条件,转载请注明出处。
关于Jekyll
是什么东西
Jekyll 是一个由ruby实现的简单
、开源
的静态
站点生产机器。支持将MarkDown
(纯文本 至 html 的渲染工具)、Liquid
(ruby实现的开源模板引擎)甚至LaTeX
的内容转化成完整的静态网站。你可以将Jekyll构建的网站发布到任何服务器上,包括免费的GitHub Pages
、国内的Gitee Pages
。
为什么选择它
- 使用简单,不需要数据库,支持博客的自定义布局、分类、标签等
GitHub Pages
基于 Jekyll 构建,你可以轻而易举地在 GitHub 上免费发布网站——自定义域名,很多前端同学把自己设计的网站在 Github 仓库共享,你 fork 到本地仓库后很轻松的就能构建出自己的博客。- 生态强大,互联网上很容易检索到各种的文档资料(含中文)、插件、皮肤模板
怎么查阅它的更多资料
- Jekyll官网 最权威、完整的文档与资源。如果英文比较吃力,也可以参考JekyllCN
- 如果碰到了问题,可以在jekyll社区或者github上发起讨论,提问题时请参考提问的智慧
- 网站皮肤可以参考官网上的GitHub.com #jekyll-theme repos、jamstackthemes.dev、jekyllthemes.org、jekyllthemes.io和jekyll-themes.com
搭建本地环境
前期准备
一台能上网的 Ubuntu 或者 macOS 系统的电脑(笔记本、台式机不限,能正常开机运行操作系统即可)
为了提高软件的下载速度,建议将安装包管理器的软件源更换为国内的镜像。使用 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)- 首先使用
sudo brew install ruby
安装最新的 Ruby包(截止目前, Brew 源中的 Ruby 版本是3.0.1) - 然后在
/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
- 重启控制台,再检查
ruby -v
,此时的版本就是最新的了
- 首先使用
macOS 系统默认安装的 Ruby 在
/usr/bin
中,而这个目录是受系统保护的(无法修改与删除),macOS 建议用户创建/usr/local/bin
目录,在其中可以放新版本的软件以替代系统自带的老版本软件。
安装 Jekyll 并使用它
RubyGems 是 Ruby 的一个包管理器,而 Jekyll 是 Ruby 的一个 Gem 包,由于官方的 RubyGems 源在国内难以访问,建议参考Ruby China更换为国内源。
- 安装 Jekyll Gem 包
1
gem install jekyll bundler
- 使用 Jekyll 命令创建一个站点
1
jekyll new myblog
- 进入目录并开启 Jekyll 服务
1
cd my_blog && jekyll s -l
- 使用浏览器访问 http://localhost:4000
好了,你的本地环境完成了,至此你可以用Jekyll构建你的网站了。