Jekyll 常用命令终端命令

在终端命令执行 jekyll 时,获取 Jekyll gem 或使用相关组件或执行文件。

jekyll 程序有几个命令,结构始终如下:

jekyll command [argument] [option] [argument_to_option]

Examples:
    jekyll new site/ --blank
    jekyll serve --config _alternative_config.yml

在本地开发预览站点,生成站点静态文件 jekyll build 会用到,在本地预览站点会用到 jekyll serve

需了解完整的命令列表和详细的选项及参数,请查看 构建命令选项.

Jekyll 常用命令

以下是一些 Jekyll 的常用命令:

  • jekyll new PATH - 创建基于 gem 默认主题的新 Jekyll 站点, PATH 代表站点文件夹名,修改自己需要的目录名即可。站点会创建基于 gem 默认主题的演示文件。
    • PATH 会在当前终端命令目录下创建,PATH 必须不存在,已存在会无法创建。
  • jekyll new PATH --blank - 创建新的空白 Jekyll 站点。 PATH 代表站点文件夹名,修改自己需要的目录名即可。空白站点会创建必须得文件和文件夹,没有非必要内容。
  • jekyll build 或者 jekyll b - 构建站点生成静态文件到./_site目录(为默认配置,可修改,不建议修改)。
  • jekyll serve 或者 jekyll s - 在本地(电脑)构建你的站点,并在修改源文件时自动重新构建。
    • 源文件:指 _config.yml 之外的大多数文件,若想使 _config.yml 文件中内容生效需重新执行该命令。
    • 自动重新构建:刷新浏览器页面即可看到最新内容。
    • 执行命令时带上 --livereload 选项,每次修改保存重新构建后会自动刷新浏览器页面,实时加载和预览。
  • jekyll clean - 删除所有的生成文件,包括目标文件( /_site)、source 文件、Sass 文件和缓存文件。
  • jekyll help - 查看 Jekyll 命令帮助说明,也可以制定子命令查看对应的帮助说明,如 jekyll help build
  • jekyll new-theme - 创建新的主题模板
  • jekyll doctor - 检查并输出存在的配置问题和弃用问题(使用弃用的组件)。

如果需要修改 Jekyll 的默认构建配置,请查看配置选项