使用用 Jekyll 建站 _ Jekyll 文档中文版_人工翻译

Jekyll 是一个古老且优秀的静态网站生成器,无需数据库和服务器就能轻松构建和部署一个静态网站,静态网站不会被黑、访问速度快、对搜索引擎友好。

Jekyll 使用大众喜爱的 Markdown (.md)和轻易上手的 Liquid 模板语言(会一点 HTML 就能快速入门)创建静态网站。你可以按照自己的喜好选择或修改网站的外观、URL、页面显示数据或内容。

准备工作

安装和运行 Jekyll 需先安装以下环境:

  • Ruby 2.5.0 或者更高版本
  • RubyGems
  • GCC and Make

请参照 系统环境要求 查看详细内容和安装指引。

快速安装教程

  1. 确保已安装全部 系统环境要求 的内容。
  2. 打开终端(terminal、终端、CMD、Shell),安装 jekyll 和 bundler gems.
    gem install jekyll bundler
    
  3. 创建一个新的 Jekyll 站点 ./myblog (在终端当前路径下创建 myblog目录,相关文件都会放到这个目录)
    jekyll new myblog
    
  4. 进入新创建的目录
    cd myblog
    
  5. 构建站点,并在本地创建虚拟服务器使站点可以在本地预览。(如果你使用 Ruby 3及更高版本请查看下面的警告内容)
    bundle exec jekyll serve
    
  6. 浏览器访问 http://localhost:4000 查看你在本地构建的 Jekyll 站点

如果你使用的 Ruby 版本是 3.0.0 或更高版本,运行第5步 可能会执行命令失败并会报错。这个时候可以添加 webrick 依赖解决这个问题,安装 webrick 依赖的终端命令: bundle add webrick

如果你想每次修改源文件时可以在浏览器看到实时预览,可以在 serve 命令后面加上 --livereload 选项,终端命令:bundle exec jekyll serve --livereload

如果在构建站点时发生报错,请检查是否已经安装 系统环境要求中所有内容。如果还是有问题,请参考故障排除解决问题。

不同的电脑操作系统的安装过程会有所不同,请参照各系统安装 Jekyll 的教程 了解对应操作系统安装流程和方式。