# 變量
### 全局變量
| 變量 | 描述 |
| --- | --- |
| `site` | [網站變量](#網站變量) |
| `page` | 針對該頁面的內容以及 front-matter 所設定的變量。 |
| `config` | 網站配置 |
| `theme` | 主題配置。繼承自網站配置。 |
| `_` (單下劃線) | [Lodash](http://lodash.com/) 函數庫 |
| `path` | 當前頁面的路徑(不含根路徑) |
| `url` | 當前頁面的完整網址 |
| `env` | 環境變量 |
### 網站變量
| 變量 | 描述 |
| --- | --- |
| `site.posts` | 所有文章 |
| `site.pages` | 所有分頁 |
| `site.categories` | 所有分類 |
| `site.tags` | 所有標簽 |
### 頁面變量
**頁面(page)**
| 變量 | 描述 |
| --- | --- |
| `page.title` | 頁面標題 |
| `page.date` | 頁面建立日期([Moment.js](http://momentjs.com/) 對象) |
| `page.updated` | 頁面更新日期([Moment.js](http://momentjs.com/) 對象) |
| `page.comments` | 留言是否開啟 |
| `page.layout` | 布局名稱 |
| `page.content` | 頁面的完整內容 |
| `page.excerpt` | 頁面摘要 |
| `page.more` | 除了頁面摘要的其余內容 |
| `page.source` | 頁面原始路徑 |
| `page.full_source` | 頁面的完整原始路徑 |
| `page.path` | 頁面網址(不含根路徑)。我們通常在主題中使用 `url_for(page.path)`。 |
| `page.permalink` | 頁面的完整網址 |
| `page.prev` | 上一個頁面。如果此為第一個頁面則為 `null`。 |
| `page.next` | 下一個頁面。如果此為最后一個頁面則為 `null`。 |
| `page.raw` | 文章的原始內容 |
| `page.photos` | 文章的照片(用于相簿) |
| `page.link` | 文章的外部鏈接(用于鏈接文章) |
**文章 (post):** 和 `page` 布局類似,但是添加了下列變量。
| Variable | Description |
| --- | --- |
| `page.published` | 如果該文章已發布則為True |
| `page.categories` | 該文章的所有分類 |
| `page.tags` | 該文章的所有標簽 |
**首頁(index)**
| 變量 | 描述 |
| --- | --- |
| `page.per_page` | 每頁顯示的文章數量 |
| `page.total` | 總文章數 |
| `page.current` | 目前頁數 |
| `page.current_url` | 目前分頁的網址 |
| `page.posts` | 本頁文章 |
| `page.prev` | 上一頁的頁數。如果此頁是第一頁的話則為 `0`。 |
| `page.prev_link` | 上一頁的網址。如果此頁是第一頁的話則為 `''`。 |
| `page.next` | 下一頁的頁數。如果此頁是最后一頁的話則為 `0`。 |
| `page.next_link` | 下一頁的網址。如果此頁是最后一頁的話則為 `''`。 |
| `page.path` | 當前頁面的路徑(不含根目錄)。我們通常在主題中使用 `url_for(page.path)`。 |
**歸檔 (archive)**:與 `index` 布局相同,但新增以下變量。
| 變量 | 描述 |
| --- | --- |
| `page.archive` | 等于 `true` |
| `page.year` | 年份歸檔 (4位) |
| `page.month` | 月份歸檔 (沒有前導零的2位數) |
**分類 (category)**:與 `index` 布局相同,但新增以下變量。
| 變量 | 描述 |
| --- | --- |
| `page.category` | 分類名稱 |
**標簽 (tag)**:與 `index` 布局相同,但新增以下變量。
| 變量 | 描述 |
| --- | --- |
| `page.tag` | 標簽名稱 |
- 文檔
- 開始使用
- 概述
- 建站
- 配置
- 指令
- 遷移
- 基本操作
- 寫作
- Front-matter
- 標簽插件(Tag Plugins)
- 資源文件夾
- 數據文件
- 服務器
- 生成文件
- 部署
- 自定義
- 永久鏈接(Permalinks)
- 主題
- 模版
- 變量
- 輔助函數(Helpers)
- 國際化(i18n)
- 插件
- 其他
- 問題解答
- 貢獻
- API
- 核心
- 概述
- 事件
- 局部變量
- 路由
- Box
- 渲染
- 文章
- 腳手架(Scaffold)
- 主題
- 擴展
- 控制臺(Console)
- 部署器(Deployer)
- 過濾器(Filter)
- 生成器(Generator)
- 輔助函數(Helper)
- 遷移器(Migrator)
- 處理器(Processor)
- 渲染引擎(Renderer)
- 標簽插件(Tag)