拓展阅读

前言

由于个人一直喜欢使用 markdown 来写个人博客，最近就整理了一下有哪些博客引擎。

感兴趣的小伙伴也可以选择自己合适的。

Jekyll 是什么？

Jekyll 是一个静态网站生成器，用 Ruby 语言编写。它可以把文本文件（通常是 Markdown 或 HTML）转换成一个完整的网站。你可以把它想象成一个厨师，把一堆原材料（文本文件）做成一桌丰盛的大餐（网站）。
为什么用 Jekyll？
- 简单：你只需要专注于写作，Jekyll 帮你搞定网站的布局和样式。
- 快速：生成的是静态网页，加载速度飞快。
- 灵活：你可以自由定制网站的样式和结构。
- 免费：Jekyll 本身是开源的，免费使用。
怎么用 Jekyll？
- 安装：在你的电脑上安装 Ruby，然后安装 Jekyll。
- 写文章：用 Markdown 格式写文章，Jekyll 会帮你转换成网页。
- 定制样式：修改 Jekyll 的模板文件，可以让网站看起来更酷。
- 发布：把生成的网站文件上传到服务器，你的网站就上线了。
Jekyll 的缺点
- 对新手来说，安装和配置可能会有点复杂。
- 因为是静态网站，不能实现动态功能，比如用户注册、登录。
Jekyll 适合谁？

如果你是一个喜欢写作，但又不想花太多时间折腾网站技术的人，Jekyll 就非常适合你。

总结一下，Jekyll 就像一个贴心的小助手，帮你把写作的内容变成一个漂亮的网站。

安装Ruby
Jekyll是用Ruby写的，所以首先得安装Ruby。Ruby是一个编程语言，安装它，就相当于请来了一个会做网站的大厨。
安装Jekyll
打开终端（在Windows上是命令提示符或PowerShell），输入以下命令安装Jekyll：
```
gem install jekyll bundler jekyll-feed
```
这就像是告诉厨房：“我们需要Jekyll这个工具来做饭。”
创建一个新网站
使用下面的命令创建一个新的Jekyll网站：
```
jekyll new my-awesome-site
```
这里的my-awesome-site是你的网站名，你可以换成任何你喜欢的名字。
进入你的网站目录
创建完毕后，用下面的命令进入你的网站目录：
```
cd my-awesome-site
```
这就像是走进了你的厨房。
启动本地服务器
要预览你的网站，输入以下命令：
```
bundle exec jekyll serve
```
这会启动一个本地服务器，让你可以实时查看网站的样子。
打开浏览器
在浏览器中输入http://localhost:4000，就能看到你的网站了。

写文章
Jekyll的文章都是Markdown格式的，你可以在_posts目录下创建新的文本文件，比如：
```
touch _posts/2024-04-27-hello-world.md
```
然后打开这个文件，写上你的文章。
定制样式
如果你想要让网站看起来更个性化，可以编辑_sass目录下的样式文件，或者修改_includes目录下的模板文件。
发布网站
当你准备好将网站发布到互联网上时，可以使用GitHub Pages等服务，将你的网站文件推送到GitHub仓库，然后自动部署。
更新Jekyll
如果你需要更新Jekyll，可以使用以下命令：
```
gem update jekyll
```

Jekyll 是一个简单、轻量级的静态网站生成工具，被广泛用于搭建个人博客、项目文档和小型网站。

它使用 Ruby 编程语言，是由 GitHub 的创始人之一 Tom Preston-Werner 创建的。

Jekyll 的设计理念是将文本内容与样式分离，以便更好地管理和维护网站。

以下是 Jekyll 博客引擎的一些主要特点和组成部分：

静态网站生成： Jekyll 不同于传统的动态网站，它是一个静态网站生成器。它通过解析文本文件（通常是 Markdown 或 Textile 格式）和 Liquid 模板引擎，生成静态 HTML 页面。
Markdown 支持： Jekyll 使用 Markdown 作为默认的文本格式，这使得写作更加简单，同时生成的网页也具有良好的可读性。
Liquid 模板引擎： Liquid 是一个轻量级的模板语言，用于在 Jekyll 中构建动态内容。它允许你插入变量、条件语句、循环等，以便更灵活地定制页面布局和内容展示。
布局和模板： Jekyll 支持使用布局和模板来定义网站的整体结构和样式。这样可以使网站保持一致的外观，同时方便进行更改。
插件系统： Jekyll 具有强大的插件系统，可以通过插件扩展其功能。这使得用户可以根据自己的需求添加各种功能，如社交分享、评论系统等。
GitHub Pages 集成： Jekyll 与 GitHub Pages 高度集成，允许用户在 GitHub 上托管他们的博客。GitHub Pages 支持 Jekyll，并自动构建并托管用户的 Jekyll 网站。
易于部署： 由于 Jekyll 生成的是静态文件，部署非常简单。你只需将生成的文件上传到任何支持静态文件托管的地方，如 GitHub Pages、Netlify、或自己的服务器。

使用 Jekyll 构建博客的一般步骤包括安装 Jekyll、创建博客项目、编写文章、配置样式和布局，最后生成并部署静态网站。

Jekyll 提供了详细的文档，可以在官方网站（https://jekyllrb.com/）上找到。

Jekyll是一个静态网站生成器。

它接受您喜欢的标记语言编写的文本，并使用布局来创建静态网站。

您可以调整网站的外观和感觉、URL、页面上显示的数据等等。

如果您使用的是 Ruby 版本 3.0.0 或更高版本，则第 5 步可能会失败。

您可以通过将 webrick 添加到您的依赖项来解决此问题：

bundle add webrick

通过将 –livereload 选项传递给 serve，以便在对源文件进行更改时自动刷新页面：

bundle exec jekyll serve --livereload

如果在此过程中遇到任何错误，请检查是否已安装了所有先决条件。

如果仍然有问题，请参见Troubleshooting。

根据您的操作系统不同，安装方式有所不同。请查看我们的指南以获取特定于操作系统的说明。