bretfisher/jekyll

Jekyll Docker容器

可能有人会问："已经有类似镜像了，为什么不用docker run jekyll/jekyll？"

• 我需要两个镜像：一个用于便捷的CLI操作（bretfisher/jekyll），另一个用于本地开发的简易服务器（bretfisher/jekyll-serve），后者是我90%的使用场景
• 支持通过docker-compose up快速启动Jekyll服务器
• 无需在主机系统安装Jekyll即可开发本地Jekyll网站
• 追求极简的启动流程
• 基于当前的Alpine、Ruby和Jekyll版本构建

本镜像正是为实现上述目标而创建。

注：我有关于Docker的课程（包含Jekyll in Docker的专题讲解）。

Docker镜像

快速开始

创建站点

shell
# 进入空目录
cd 空目录路径
# 运行容器创建新Jekyll站点（当前目录会被挂载到容器内的/site）
docker run -v $(pwd):/site bretfisher/jekyll new .

启动本地服务器

以合理默认值启动本地服务器，监听8080端口：

shell
# 进入Jekyll站点目录
cd 你的Jekyll站点目录
# 映射8080端口到容器的4000端口，挂载当前目录到容器内的/site
docker run -p 8080:4000 -v $(pwd):/site bretfisher/jekyll-serve

说明：容器会将当前路径挂载到/site目录，自动执行bundle install后启动Jekyll服务，可通过http://<docker主机IP>:8080访问站点。

为进一步简化操作，可将https://github.com/BretFisher/jekyll-serve/blob/master/docker-compose.yml%E4%B8%AD%E7%9A%84%60docker-compose.yml%60%E6%96%87%E4%BB%B6%E5%A4%8D%E5%88%B6%E5%88%B0Jekyll%E7%AB%99%E7%82%B9%E6%A0%B9%E7%9B%AE%E5%BD%95%EF%BC%8C%E4%B9%8B%E5%90%8E%E5%8F%AA%E9%9C%80%E6%89%A7%E8%A1%8C%EF%BC%9A

shell
cd 你的Jekyll站点目录
docker-compose up

常见问题

Q. 如何运行其他Jekyll命令？

在bretfisher/jekyll镜像后直接添加Jekyll命令即可：

shell
docker run -v $(pwd):/site bretfisher/jekyll doctor

许可证

MIT许可证

版权所有 (c) [Bret Fisher ***]

特此授予任何获得本软件及相关文档文件（以下简称"软件"）副本的人免费使用软件的权利，包括但不限于使用、复制、修改、合并、出版、发行、再许可和/或销售软件副本的权利，以及允许向其提供软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按"原样"提供，不提供任何明示或暗示的担保，包括但不限于对适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因软件或软件使用引起的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他形式的诉讼。