Jekyll 是一个静态站点生成器，内置 GitHub Pages 支持和简化的构建过程。 Jekyll 使用 Markdown 和 HTML 文件，并根据您选择的布局创建完整静态网站。 Jekyll 支持 Markdown 和 Lick，这是一种可在网站上加载动态内容的模板语言。所以在Github Pages上使用Jekyll很合适，其他有关介绍请参考Github Docs关于Jekyll，以及jekyll中文指南站点（翻译），jekyll英文指南站点，本篇部分内容参考了以上文档。 在Linux，MacOS上使用Jekyll，安装过程较为简单，下面为在Windows上的安装过程。
通过 RubyInstaller 安装Ruby环境
安装 Ruby 和 Jekyll 的最简单方法是使用RubyInstaller for Windows。
RubyInstaller是一个独立的基于Windows的安装程序，包括Ruby语言，执行环境， 重要文档等。
从RubyInstaller Downloads 下载并安装Ruby+Devkit版本。
使用默认安装选项。 在安装向导的最后一个阶段运行ridk install MSYS2 and MINGW development tool chain步骤。这是使用本机安装 gem 所必需的 扩展。您可以在RubyInstaller 文档中找到有关此内容的其他信息。 从开始菜单打开一个新的命令提示符窗口，以便对环境变量的更改生效。 打开命令提示符窗口测试是否安装完成： 输入命令：ruby -v
安装RubyGems
在Windows中下载RubyGems，直接ZIP格式的比较简单，下载链接，下载后解压并打开该目录，在打开的Windows目录进入命令提示符界面。 1.输入命令：ruby setup.rb,即安装。 2.输入命令：gem -v,查看版本信息验证 3.输入命令：gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/ 配置国内gem source源（原https://rubygems.org有些慢） 4.输入命令：gem sources -l 查看验证gem source配置
安装Jekyll
1.输入命令：gem install jekyll 安装jekyll 2.输入命令：jekyll -v 安装完验证版本
安装jekyll-paginate
1.输入命令：gem install jekyll-paginate 安装jekyll-paginate
安装bundle
1.此时可以创建新的Jekyll项目，输入命令：jekyll new myblog，进入到该目录cd myblog,运行项目jekyll serve，可能会由于依赖不完整报错，可以先安装bundle 2.输入命令：gem install bundle 3.输入命令：bundle install,添加缺失的依赖,会自动安装 Gemfile 内声明的依赖插件. 4.输入命令：bundle exec jekyll serve，运行项目，如有缺失依赖，再根据打印的信息使用gem进行安装。 5.至此Jekyll项目可以运行，打开浏览器输入地址:端口号可以看见界面
找到适合自己的Jekyll主题
几个比较热门的Jekyll主题网站：
- GitHub.com #jekyll-theme repos
- jamstackthemes.dev
- jekyllthemes.org
插件库
- jekyll-plugin topic on GitHub
- Planet Jekyll
例如此博客使用的主题地址。
## 应用找到的主题 1.使用Github Pages生成站点，需要创建仓库名为<username>.github.io的仓库，可以直接将主题项目fork到自己的<username>.github.io仓库中，之后可以clone到本地进行进行编辑。clone到本地后进入目录，将原文件.travis.yml .github删除，配置自己的_config.yml内容以及git仓库。目录结构大致如下
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
jekyll-theme-chirpy/
├── _data # 存放网站数据，使用.yml，.yaml，.json或.csv格式和扩展名可以通过site.data访问它们
├── _includes # 存放html模块，可以在多个html页面进行引用
├── _layouts # 布局文件
├── _posts # 用于存放博客文章
├── _scripts
├── _site # 项目构建完成之后所生成的静态文件存放于此，可将其到.gitignore文件中
│ └── assets # 生成的静态网页的CSS 文件、JS 文件以及图片文件
├── _plugins # 插件
├── assets #静态资源文件
├── tabs
├── .travis.yml # 删除
├── .github # 删除
├── .gitignore
├── 404.html
├── Gemfile # 存放项目所依赖的 Ruby gems
├── LICENSE
├── README.md
├── _config.yml # 项目的配置文件，项目的全局配置在此
├── tools
├── docs
├── feed.xml
├── index.html
├── robots.txt
└── sitemap.xml
2.根据注解大致修改-config.yml文件内容后，可以执行bundle exec jekyll serve命令或者直接jekyll serve打开内置的开发服务器，该命令可以构建并运行项目，启动Jekyll自带的 web server，在浏览器中直接访问项目地址http://127.0.0.1:4000.。
## 一些常用命令
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
jekyll new PATH
#=>创建新项目
jekyll new PATH --blank
#=>创建新的空项目
jekyll new-theme
#=>创建一个新的主题脚手架
jekyll build
#=>当前文件夹中的内容将被生成到./_site
jekyll build --destination <destination>
#=>当前文件夹中的内容将被生成到<destination>
jekyll build --source <source> --destination <destination> <source>
#=>文件夹中的内容将被生成到<destination>
jekyll build --watch
#=>当前文件夹中的内容将被生成到./_site, 检查改动，并自动重新生成
jekyll serve 或 jekyll s
#=>构建并启用内置服务运行项目，开发服务将会运行在http://localhost:4000/ 会自动监听文件变化并部署，对于 _config.yml 的修改不会自动部署
jekyll clean
#=>清除所有的构建产物
部署
使用 GitHub Actions进行部署
确保您的 Jekyll 网站包含.github/workflows/pages-deploy.yml文件。否则，创建一个新文件并填写示例文件的内容，并且 on.push.branches值应与存储库的默认分支名称相同。然后将您的存储库重命名为
现在发布您的Jekyll网站：
1.在GitHub 上浏览仓库。选择Settings选项卡，然后单击左侧导航栏中的Pages。然后，在Source部分（在Build and deployment下）中，从下拉菜单中选择“GitHub Actions”。
2.将任何提交推送到远程以触发 GitHub 操作工作流。在仓库的Actions选项卡中，应会看到workflowBuild and Deploy正在运行”。生成完成并成功后，就会自动部署站点。
3.在 GitHub 指定的地址访问您的网站。
手动构建和部署
在自托管服务器上，您无法享受GitHub Actions的便利。因此，应在本地计算机上生成站点，然后将站点文件上载到服务器。
转到源项目的根目录，并按如下所示生成站点：
1
JEKYLL_ENV=production bundle exec jekyll b
或者在 Docker 上构建网站：
1
2
3
4
5
docker run -it --rm \
--env JEKYLL_ENV=production \
--volume="$PWD:/srv/jekyll" \
jekyll/jekyll \
jekyll build
除非指定了输出路径，否则生成的站点文件将放置在项目根目录的文件夹中。现在，您应该将这些文件上传到目标服务器。
结束
至此一个Jekyll博客基本可以跑起来了，当然完全配置为自己的博客还需要修改很多东西，包括布局，collections数据等等。