資產

Jekyll 提供內建支援 Sass,並可透過 Ruby 寶石與 CoffeeScript 搭配使用。若要使用它們,您必須先建立一個具有正確副檔名 (其中一個為 .sass.scss.coffee) 的檔案,並以兩行三破折號開頭,如下所示

---
---

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

Jekyll 將這些檔案視為一般頁面,因此輸出檔案會放置在與其來源相同的目錄中。例如,如果您的網站原始碼資料夾中有一個名為 css/styles.scss 的檔案,Jekyll 會處理它並將其放在網站目標資料夾中的 css/styles.css 下。

Jekyll 會處理資產檔案中的所有 Liquid 篩選器和標籤

如果你使用 Mustache 或其他與 Liquid 範本語法 衝突的 JavaScript 範本語言,你需要在程式碼周圍加上 {% raw %}{% endraw %} 標籤。

Sass/SCSS

Jekyll 允許你以特定方式自訂你的 Sass 轉換。

將所有部分放置在你的 sass_dir 中,預設為 <source>/_sass。將你的主要 SCSS 或 Sass 檔案放置在輸出檔案中你想要它們出現的地方,例如 <source>/css。舉例來說,看看 這個使用 Jekyll 中 Sass 支援的範例網站

如果你使用 Sass @import 陳述式,你需要確保你的 sass_dir 設定為包含你的 Sass 檔案的基本目錄

sass:
    sass_dir: _sass

Sass 轉換器會將 sass_dir 組態選項預設為 _sass

sass_dir 僅由 Sass 使用

請注意,sass_dir 僅成為 Sass 匯入的載入路徑,僅此而已。這表示 Jekyll 並不知道這些檔案。此處的任何檔案都不應包含如上所述的空白前置事項。如果包含,它們將不會如上所述進行轉換。此資料夾應僅包含匯入。

你也可以在 _config.yml 檔案中使用 style 選項指定輸出樣式

sass:
    style: compressed

這些會傳遞給 Sass,因此 Sass 支援的任何輸出樣式選項在此也都是有效的。

有關 Sass 組態選項的更多資訊,請參閱 Sass 組態 文件。

Coffeescript

若要在 Jekyll 3.0 及更新版本中啟用 Coffeescript,您必須

  • 安裝 jekyll-coffeescript gem
  • 確保您的 _config.yml 為最新版本,並包含下列內容
plugins:
  - jekyll-coffeescript