# 变量 ### 全局变量 | 变量 | 描述 | | --- | --- | | `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` | 标签名称 |