資產
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