配置模板
你的配置文件在 /模板目錄/config.yml
,這個配置文件採用 YAML 的格式,
如果沒有特殊要求,可以直接留白,下面是一個基本的 config.yml
範例。
configs:
enableCoffee: true
enableSass : true
enableSassc : false
shortnames:
"Ello": "test"
配置區塊
配置文件擁有不同的設定,在這裡我們將各個說明。
Configs
這是用來設定基本設置的區塊,其用法像這樣。
configs:
enableCoffee: true
enableSass : true
pjaxHeader : "HTTP_X_PJAX"
這個區塊你能夠設置的功能有:
設置名稱 | 中文名稱 | 類型 | 預設 | 說明 |
---|---|---|---|---|
enableCoffee | 啟用 Coffee | 布林值 | false | 是否要開啟 Coffee 編譯。 |
enableSass | 啟用 Sass | 布林值 | false | 是否要開啟 Sass 編譯。 |
enableSassc | 啟用 Sassc | 布林值 | false | 是否要透過 SassC 編譯而不是 Sass。 |
extension | 模板副檔名 | 字串 | .jade |
模板的副檔名。 |
coffeeExtension | Coffee 副檔名 | 字串 | .coffee |
Coffee 的副檔名。 |
sassExtension | Sass 副檔名 | 字串 | .sass |
Sass 的副檔名。 |
pjaxHeader | PJAX 標頭 | 字串 | HTTP_X_PJAX |
用以辨識是否為 PJAX 請求的標頭名稱。 |
titleVariable | 標題變數名 | 字串 | title |
作為網頁標題的變數名稱,會用在 PJAX 中。 |
Shortnames
你可以事先設置好模板路徑然後給他們一個簡短的暱稱,在渲染的時候就可以直接輸入模板暱稱,
不需要輸入一整個完整的路徑,在這裡設置的時候請省略模板副檔名。
shortnames:
"暱稱" : "模板路徑"
"Timeline": "timeline"
"Profile" : "user/profile"
Paths
你可以自訂模板資料夾的路徑。
shortnames:
sass : "my_sass"
compiled: "already_compiled"
這個區塊你能夠設置的功能有:
設置名稱 | 預設 | 說明 |
---|---|---|
sass | sass |
Sass 資料夾。 |
script | scripts |
Script 資料夾。 |
style | styles |
Style 資料夾。 |
coffee | coffees |
Coffee 資料夾 |
tpl | tpls |
存放模板的資料夾。 |
sassc | sassc |
在指令裡要如何呼叫 Sassc。 |