變數

全域變數

變數 描述 類型
site 網站範圍資訊。 object;請參閱 網站變數
page 頁面特定資訊以及在前置資訊中設定的自訂變數。 object;請參閱 頁面變數
config 網站設定。 object(您的網站 _config 檔案)
theme 主題設定。繼承自網站設定。 object(您的主題 _config 檔案)
path 目前頁面的路徑 string
url 目前頁面的完整 URL string
env 環境變數 ???

自 Hexo 5.0.0 起,Lodash 已從全域變數中移除。You-Dont-Need-Lodash-Underscore 可能對您的遷移有所幫助。

網站變數

變數 描述 類型
site.posts 所有文章 post 物件的 array
site.pages 所有頁面 page 物件的 array
site.categories 所有分類 ??? 的 array
site.tags 所有標籤 ??? 的 array

頁面變數

文章 (page)

變數 描述 類型
page.title 文章標題 string
page.date 文章建立日期 Moment.js 物件
page.updated 文章上次更新日期 Moment.js 物件
page.comments 是否啟用評論 boolean
page.layout 版面配置名稱 string
page.content 文章的完整處理內容 string
page.excerpt 文章摘要 string
page.more 文章摘要以外的內容 string
page.source 來源檔案的路徑 string
page.full_source 來源檔案的完整路徑 string
page.path 文章的 URL,不含根 URL。我們通常在主題中使用 url_for(page.path) string
page.permalink 文章的完整(已編碼)URL string
page.prev 上一篇文章,如果文章是第一篇則為 null ???
page.next 下一篇文章,如果文章是最後一篇則為 null ???
page.raw 文章的原始資料 ???
page.photos 文章的照片(用於圖庫文章) ??? 的 array
page.link 文章的外部連結(用於連結文章) string

文章 (post):page 版面配置相同,但新增以下變數。

變數 描述 類型
page.published 如果文章不是草稿則為 True boolean
page.categories 文章的所有分類 ??? 的 array
page.tags 文章的所有標籤 ??? 的 array

首頁 (index)

變數 描述 類型
page.per_page 每頁顯示的文章數 number
page.total 總頁數 number
page.current 目前頁碼 number
page.current_url 目前頁面的 URL string
page.posts 此頁的文章 (資料模型) object
page.prev 上一頁的頁碼。如果目前頁面是第一頁則為 0 number
page.prev_link 上一頁的 URL。如果目前頁面是第一頁則為 '' string
page.next 下一頁的頁碼。如果目前頁面是最後一頁則為 0 number
page.next_link 下一頁的 URL。如果目前頁面是最後一頁則為 '' string
page.path 目前頁面的 URL,不含根 URL。我們通常在主題中使用 url_for(page.path) string

封存 (archive):index 版面配置相同,但新增以下變數。

變數 描述 類型
page.archive 等於 true boolean
page.year 封存年份(4 位數) number
page.month 封存月份(2 位數,不含前導零) number

分類 (category):index 版面配置相同,但新增以下變數。

變數 描述 類型
page.category 分類名稱 string

標籤 (tag):index 版面配置相同,但新增以下變數。

變數 描述 類型
page.tag 標籤名稱 string