Jekyll安装使用
Windows本地安装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位版本的区分。
在这里直接选择下载 Ruby+Devkit 3.1.4-1 (x64) 版本即可,就不用Ruby和Devkit分开安装了。
注意:这里建议先选好Jekyll网站模板,在根据网站模板所需要的Ruby版本进行安装。否则在启动的时候可能会出现版本不兼容问题,处理起来比较麻烦。
安装后选择安装msys2 ->3,可能会安装失败,此处我没有管,也没有另行操作。
2. 安装Jekyll
安装这个比较费时,在cmd中输入:
gem install jekyll
安装完后查看:
jekyll -v
三. 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"命令查看
评论区