Jekyll安装使用

编程开发 2023-11-12 闲者

123 0 0

最近想试试用Jekyll在Github搭建blog。选取网站模板，修改域名等等这些网上都有很详细的教程了，文末会附上链接，这里就不再赘述了。本文主要记录在Windows本地安装jekyll环境的过程，遇到的问题及如何解决的。参考Jekyll官网

一. Jekyll 简介：从静态到动态的网站生成工具

在当今互联网的潮流中，网站已经成为人们传递信息、展示作品和表达想法的重要方式。然而，随着网站数量的增加，传统的动态网站开发方式逐渐显露出一些问题，比如复杂的后端管理、性能瓶颈以及安全隐患。在这样的背景下，静态网站生成工具逐渐崭露头角，而其中的佼佼者，非 Jekyll 莫属。

1. 什么是 Jekyll？

Jekyll 是一个简单而强大的静态网站生成工具，它能够将你编写的纯文本、Markdown 或 HTML 文件转化为具有完整网站功能的静态文件。这意味着你可以摆脱传统动态网站的数据库和服务器，而只需将生成的静态文件部署到服务器上。Jekyll 的核心理念是“转换纯文本为静态网站”，它是基于 Ruby 编程语言构建的，具有丰富的社区支持和广泛的应用。

2. Jekyll 的优势和用途

速度和性能优越： 由于 Jekyll 生成的是纯静态文件，无需数据库查询或服务器处理，网站加载速度极快，有助于提供更出色的用户体验。

安全性增强： 没有动态后端，Jekyll 网站减少了许多潜在的攻击面，使其在安全性方面更为可靠。

简化的部署： 由于只需要将生成的静态文件上传到服务器，部署过程非常简单，无需担心数据库连接、服务器配置等问题。

易于维护： Jekyll 使用纯文本或 Markdown 编写内容，易于维护和修改。此外，你可以将内容与格式分离，有利于内容创作和网站样式的独立调整。

适合博客和小型网站： Jekyll 最初被设计用于博客，因此对于需要频繁更新内容的个人博客、项目文档、简历等小型网站特别适用。

版本控制和合作： 由于内容以纯文本形式存储，可以轻松使用版本控制工具（如 Git）来管理和跟踪内容的变更，方便团队协作。

灵活的主题和插件： Jekyll 提供了丰富的主题和插件，可以轻松地改变网站外观和功能，使其更符合个人品味和需求。

结论

Jekyll 的出现标志着网站生成工具的一次革命，它以其出色的性能、简单的部署以及适应博客、个人项目等的特点，为网站开发者提供了一种全新的选择。无论是寻求更高性能的网站，还是寻找更便捷的网站管理方式，Jekyll 都是一个值得深入了解和尝试的工具。

二. 环境安装

1. 安装Ruby

在Windows上使用RubyInstaller安装比较方便，去Ruby官网下载最新版本的RubyInstaller。注意32位和64位版本的区分。

rubyinstaller

在这里直接选择下载 Ruby+Devkit 3.1.4-1 (x64) 版本即可，就不用Ruby和Devkit分开安装了。

注意：这里建议先选好Jekyll网站模板，在根据网站模板所需要的Ruby版本进行安装。否则在启动的时候可能会出现版本不兼容问题，处理起来比较麻烦。

安装后选择安装msys2 ->3，可能会安装失败,此处我没有管，也没有另行操作。

2. 安装Jekyll

安装这个比较费时，在cmd中输入:

gem install jekyll

安装完后查看：

jekyll -v

Jekyll

三. jekyll启动

1. 下载Jekyll主题

可通过如下Jekyll主题商店自行选取喜欢的主题库：

https://jamstackthemes.dev/ssg/jekyll/

http://jekyllthemes.org/

下载jekyll主题（根据喜好自行选择）

git clone https://github.com/rundocs/jekyll-rtd-theme.git

2. 启动

#进入下载好的目录
cd jekyll-rtd-theme
# 配置bundle国内镜像仓库
bundle config mirror.https://rubygems.org https://gems.ruby-china.com
# 安装依赖
bundle install
# 启动本地主题
jekyll serve 或 bundle exec jekyll serve

因为本身Jekyll是个代码生成器，修改MD并不是立刻映射到html文件上。可以用这条命令启动服务，这样文件被改变之后，会即刻刷新网页

bundle exec jekyll serve --livereload

3. 访问地址：

http://127.0.0.1:4000/

四. jekyll配置本地启动手机访问

1. 查询的本地 IP 地址。

如果你使用的是 macOS 或 Linux 操作系统，可以打开终端（Terminal）应用，并输入以下命令：

ifconfig

如果你使用的是 Windows 操作系统，可以打开命令提示符（Command Prompt）应用，并输入以下命令：

ifconfig

在终端或命令提示符中，你应该可以看到一个名为 "inet" 或 "IPv4 Address" 的 IP 地址。这就是你的本地 IP 地址。

2. 配置 Jekyll 以使用本地 IP 地址。

在终端或命令提示符中，进入你的 Jekyll 站点所在的目录，并运行以下命令：

jekyll serve --host=0.0.0.0
或
bundle exec jekyll serve --host=0.0.0.0

这个命令会让 Jekyll 使用 0.0.0.0 这个特殊的 IP 地址，表示允许任何设备访问该站点。

3. 访问

在手机浏览器中输入你的本地 IP 地址，加上 Jekyll 默认的端口号 4000。在手机浏览器中输入以下网址：

http://你的本地IP地址:4000

例如，如果你的本地 IP 地址是 192.168.0.100，那么你应该输入以下网址：

http://192.168.0.100:4000

现在你应该可以在手机上访问你的 Jekyll 站点了。

五. jekyll其他常见问题

1. 重新安装gem

如果在启动过程中出现报错，大概率是版本问题，如果是版本问题，则按照以下方式处理，如果是其他问题，则查看具体问题进行处理

查看版本

bundle exec jekyll --version

更新Gemfile.lock 文件里的依赖 # 重新安装一遍 gem install bundler jekyll

# 更新所有的 gems
bundle update

# 测试
jekyll --version

重新使用启动命令进行启动：

jekyll serve 或 bundle exec jekyll serve

如果仍未解决，可以查看主题模板所需要的版本，重新安装。

2. 后台启动

"jekyll serve"命令启动如果终端关闭，进程就停止了，如果想要在后台启动，则需要更换其他命令。

控制台启动命令

Auto-regeneration（自动再生成文件）: 开启。使用 --no-watch 来关闭。

jekyll serve
bundle exec jekyll serve

后台启动命令

功能和jekyll serve命令相同，但是会脱离终端在后台运行

jekyll serve --detach

如果你想关闭服务器，可以使用kill -9 1234命令，"1234" 是进程号（PID）。如果你找不到进程号，那么就用ps aux | grep jekyll命令来查看，然后关闭服务器

3. 创建新主题博客

如果不想使用模板，可以自己创建一个jekyll主题。进入进文件夹，创建一个名为myblog的主题

$ jekyll new myblog
or
$ jekyll new . --force

创建好之后，可以进行自行开发完善

4. 其他命令

# gem清单
gem list
# 删除Bundle的一个镜像源
$ bundle config --delete 'mirror.https://rubygems.org'

其他更多命令，可以使用"gem help"命令查看