Jekyll安装使用

Windows本地安装jekyll环境的过程

发布:2023-11-12     分类:闲者编程     标签:JekyllWindows
2023 - 11 - 11
Jekyll安装使用

最近想试试用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"命令查看

更新:2023-11-12
点击评论
评论区