Jekyll 资源文件目录Assets(自动处理 .scss .sass .coffee)
Jekyll 内置了对 Sass 和 CoffeeScript 的支持,可以通过 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