Jekyll中文文档__Assets

Jekyll提供了对 Sass 的内置支持，并且可以通过 Ruby gem 与 CoffeeScript 一起工作。为了使用它们，您必须首先创建一个具有正确扩展名的文件（.sass, .scss, 或 .coffee之一），并以两行三连破折号开头，如下所示：

---
---

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

Jekyll将这些文件视为普通页面，因为输出文件将被放置在其来源的同一目录中。例如，如果您在站点的 source 文件夹中有一个名为 css/styles.scss 的文件，Jekyll会对其进行处理，并将其放在 css/styles.css 下的站点目标文件夹中。

Jekyll处理 asset 文件中的所有Liquid filters 和 tags

如果您使用的是 Mustache 或另一种与 Liquid 模板语法 冲突的 JavaScript 模板语言，则需要在代码周围放置 {% raw %} 和 {% endraw %} tags。

Sass/SCSS

Jekyll允许您以特定方式自定义Sass转换。

将所有的"部分"放在sass_dir中，默认为 <source>/_sass 。将您的主要SCSS或Sass文件放在您希望它们在输出文件中的位置，例如 <source>/css 。举个例子，看看 this example site using Sass support in Jekyll 。

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

sass:
    sass_dir: _sass

Sass转换器将 sass_dir 配置选项默认为 _sass

sass_dir 仅由Sass使用

请注意，sass_dir将成为sass导入的加载路径，仅此而已。这意味着Jekyll并不直接知道这些文件。此处的任何文件都不应包含如上所述的空的 front matter 。如果它们这样做了，就不会像上面描述的那样进行转换。此文件夹应仅包含导入。

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

sass:
    style: compressed

这些都被传递给Sass，所以Sass支持的任何输出样式选项在这里也是有效的。

有关Sass配置选项的更多信息，请参阅 Sass configuration 文档。

Coffeescript

要在Jekyll 3.0及更高版本中启用 Coffeescript ，您必须

• 安装 jekyll-coffeescript gem
• 确保您的_config.yml是最新的，并包括以下内容：

plugins:
  - jekyll-coffeescript

📃返回目录