Jekyll 资源文件目录Assets(自动处理 .scss .sass .coffee)

Jekyll 内置了对 SassCoffeeScript 的支持,可以通过 Ruby gem 配合使用。使用时先创建一个带正确扩展名(.sass、.scss 或 .coffee)的文件,文件并以两行连字符开始,然后输入相关内容如下:

---
---

// start content
.my-definition
  font-size: 1.2em

Jekyll 会将这些文件与常规页面一样进行处理,输出的文件会放置在其来源文件相同的目录中。

假设 style.scss 的存放路径为 css/styles.scss ,Jekyll 处理后,会将处理后生成的 style.css 文件存放在同一目录中,具体路径为 css/styles.css

Jekyll 会处理所有 asset 文件中的 Liquid 过滤器和标签

如果你使用的是Mustache 或其他与Liquid模板语法冲突的 JavaScript 模板语言,你需要在代码前后放置{% raw %}{% endraw %}标签。

Sass/SCSS

Jekyll 允许你根据自己方的式自定义 Sass 转换。

将所有的局部文件放在sass_dir中,默认路径为<source>/_sass<source> 代指 Jekyll 站点的根目录)。将SCSS或Sass的主文件放在想要输出 css 文件的文件夹中,如<source>/css。示例请查看此示例站点使用Jekyll中的Sass支持

如果使用 Sass 的@import语句,需要确保sass_dir设置为包含 Sass 文件的基本目录:

sass:
    sass_dir: _sass

Sass转换器会默认配置sass_dir值为_sass

sass_dir仅用于Sass

请注意, sass_dir仅用作Sass导入的加载路径。这意味着Jekyll无法直接识别这些文件。这里的任何文件都不应包含上述空的前置数据(文件不以两行连字符开始)。如果包含,它们将不会像上述描述的那样进行转换。此文件夹应仅包含Sass的导入文件。

可以在_config.yml文件中使用style选项指定输出样式:

sass:
    style: compressed

这些选项会传递给Sass,因此Sass支持的任何输出样式选项在这里都是有效的。

有关Sass配置选项的详细信息,请参阅Sass配置文档。

Coffeescript

如果需要在 Jekyll 3.0 及更高版本启用 Coffeescript,需要执行以下操作:

  • 安装 jekyll-coffeescript gem
  • 确保 _config.yml 文件是最新的,并包含以下内容:
plugins:
  - jekyll-coffeescript