|
|
---
|
|
|
title: 全局变量
|
|
|
description: 系统提供的一些全局变量
|
|
|
---
|
|
|
|
|
|
## 博客地址
|
|
|
|
|
|
```
|
|
|
${blog_url!}
|
|
|
```
|
|
|
|
|
|
此变量与后台博客设置中的 `博客地址` 相对应。
|
|
|
|
|
|
|
|
|
## 网站根路径
|
|
|
|
|
|
```
|
|
|
${context!}
|
|
|
```
|
|
|
|
|
|
需要注意的是，此变量和 `blog_url` 不同的是，这个变量有两种值，一种为相对路径形式，一种为绝对路径形式。
|
|
|
|
|
|
那么，当在后台博客设置中将 `全局绝对路径` 的选项打开时，`context` 变量值为 `${blog_url}/`，关闭时，`context` 的变量值为 `/`。
|
|
|
|
|
|
假设，我设置的 `博客地址` 为 `https://halo.run`，那么：
|
|
|
|
|
|
- 全局绝对路径为开启的状态下：https://halo.run/
|
|
|
- 全局绝对路径为关闭的状态下：/
|
|
|
|
|
|
## 主题资源根路径
|
|
|
|
|
|
```
|
|
|
${theme_base!}
|
|
|
```
|
|
|
|
|
|
假设你的主题在 `~/halo-dev/templates/themes/anatole` 这个目录，那么 `theme_base` 为 `https://yourdomain/themes/anatole`
|
|
|
|
|
|
举个例子，你当前开发的主题为 `anatole`，当你要获取主题下 `css/style.css` 这个文件的路径，那么：
|
|
|
|
|
|
```
|
|
|
${theme_base!}/css/style.css
|
|
|
```
|
|
|
|
|
|
## 主题信息
|
|
|
|
|
|
主题名称：
|
|
|
|
|
|
```
|
|
|
${theme.name!}
|
|
|
```
|
|
|
|
|
|
主题 git 仓库地址：
|
|
|
|
|
|
```
|
|
|
${theme.repo!}
|
|
|
```
|
|
|
|
|
|
主题版本号：
|
|
|
|
|
|
```
|
|
|
${theme.version!}
|
|
|
```
|
|
|
|
|
|
## 博客标题
|
|
|
|
|
|
```
|
|
|
${blog_title!}
|
|
|
```
|
|
|
|
|
|
此变量与后台博客设置中的 `博客标题` 相对应。
|
|
|
|
|
|
## 博客 Logo
|
|
|
|
|
|
```
|
|
|
${blog_logo!}
|
|
|
```
|
|
|
|
|
|
此变量与后台博客设置中的 `Logo` 相对应。
|
|
|
|
|
|
## Halo 版本
|
|
|
|
|
|
```
|
|
|
${version!}
|
|
|
```
|
|
|
|
|
|
当前 Halo 的版本，如：1.3.0
|
|
|
|
|
|
## 博主信息
|
|
|
|
|
|
昵称：
|
|
|
|
|
|
```
|
|
|
${user.nickname!}
|
|
|
```
|
|
|
|
|
|
邮箱地址：
|
|
|
|
|
|
```
|
|
|
${user.email!}
|
|
|
```
|
|
|
|
|
|
描述：
|
|
|
|
|
|
```
|
|
|
${user.description!}
|
|
|
```
|
|
|
|
|
|
头像地址：
|
|
|
|
|
|
```
|
|
|
${user.avatar!}
|
|
|
```
|
|
|
|
|
|
上次登录时间：
|
|
|
|
|
|
```
|
|
|
${user.expireTime!}
|
|
|
```
|
|
|
|
|
|
## SEO 关键词
|
|
|
|
|
|
```
|
|
|
${meta_keywords!}
|
|
|
```
|
|
|
|
|
|
需要注意的是，虽然这个变量在任何页面都可以使用，但是其值可能在不同的页面是不一样的。会根据用户的设置，生成对应的值。
|
|
|
|
|
|
假设在文章页面：
|
|
|
|
|
|
- 如果用户为文章设置了标签，而没有设置 `自定义关键词`，系统会自动将标签设置为页面关键词。
|
|
|
- 如果用户设置了 `自定义关键词`，那么则会取用户设置的值。
|
|
|
|
|
|
## SEO 描述
|
|
|
|
|
|
```
|
|
|
${meta_description!}
|
|
|
```
|
|
|
|
|
|
需要注意的是，虽然这个变量在任何页面都可以使用，但是其值可能在不同的页面是不一样的。会根据用户的设置，生成对应的值。
|
|
|
|
|
|
|
|
|
## RSS 2.0 订阅地址
|
|
|
|
|
|
```
|
|
|
${rss_url!}
|
|
|
```
|
|
|
|
|
|
如：`https://yourdomain/rss.xml`
|
|
|
|
|
|
## Atom 格式的订阅地址
|
|
|
|
|
|
```
|
|
|
${atom_url!}
|
|
|
```
|
|
|
|
|
|
如：`https://yourdomain/atom.xml`
|
|
|
|
|
|
## Xml 格式的网站地图地址
|
|
|
|
|
|
```
|
|
|
${sitemap_xml_url!}
|
|
|
```
|
|
|
|
|
|
如：`https://yourdomain/sitemap.xml`
|
|
|
|
|
|
## HTML 格式的网站地图地址
|
|
|
|
|
|
```
|
|
|
${sitemap_html_url!}
|
|
|
```
|
|
|
|
|
|
如：`https://yourdomain/sitemap.html`
|
|
|
|
|
|
## 友情链接页面地址
|
|
|
|
|
|
```
|
|
|
${links_url!}
|
|
|
```
|
|
|
|
|
|
- **全局绝对路径为开启的状态下**：`https://yourdomain.com/{links_prefix}`
|
|
|
- **全局绝对路径为关闭的状态下**：`/{links_prefix}`
|
|
|
|
|
|
`{links_prefix}` 是用户可设定的值，用户可以在后台修改 `友情链接` 的前缀，默认为 `links`。
|
|
|
|
|
|
## 图库页面地址
|
|
|
|
|
|
```
|
|
|
${photos_url!}
|
|
|
```
|
|
|
|
|
|
- **全局绝对路径为开启的状态下**：`https://yourdomain.com/{photos_prefix}`
|
|
|
- **全局绝对路径为关闭的状态下**：`/{photos_prefix}`
|
|
|
|
|
|
`{photos_prefix}` 是用户可设定的值，用户可以在后台修改 `图库页面` 的前缀，默认为 `photos`。
|
|
|
|
|
|
## 日志页面地址
|
|
|
|
|
|
```
|
|
|
${journals_url!}
|
|
|
```
|
|
|
|
|
|
- **全局绝对路径为开启的状态下**：`https://yourdomain.com/{journals_prefix}`
|
|
|
- **全局绝对路径为关闭的状态下**：`/{journals_prefix}`
|
|
|
|
|
|
`{journals_prefix}` 是用户可设定的值，用户可以在后台修改 `日志页面` 的前缀，默认为 `journals`。
|
|
|
|
|
|
## 文章归档页面地址
|
|
|
|
|
|
```
|
|
|
${archives_url!}
|
|
|
```
|
|
|
|
|
|
- **全局绝对路径为开启的状态下**：`https://yourdomain.com/{archives_prefix}`
|
|
|
- **全局绝对路径为关闭的状态下**：`/{archives_prefix}`
|
|
|
|
|
|
`{archives_prefix}` 是用户可设定的值，用户可以在后台修改 `归档` 的前缀，默认为 `archives`。
|
|
|
|
|
|
## 分类列表页面地址
|
|
|
|
|
|
```
|
|
|
${categories_url!}
|
|
|
```
|
|
|
|
|
|
- **全局绝对路径为开启的状态下**：`https://yourdomain.com/{categories_prefix}`
|
|
|
- **全局绝对路径为关闭的状态下**：`/{categories_prefix}`
|
|
|
|
|
|
`{categories_prefix}` 是用户可设定的值，用户可以在后台修改 `分类` 的前缀，默认为 `categories`。
|
|
|
|
|
|
## 标签列表页面地址
|
|
|
|
|
|
```
|
|
|
${tags_url!}
|
|
|
```
|
|
|
|
|
|
- **全局绝对路径为开启的状态下**：`https://yourdomain.com/{tags_prefix}`
|
|
|
- **全局绝对路径为关闭的状态下**：`/{tags_prefix}`
|
|
|
|
|
|
`{tags_prefix}` 是用户可设定的值，用户可以在后台修改 `标签` 的前缀，默认为 `tags`。
|
|
|
|
|
|
## 页面判断
|
|
|
|
|
|
判断当前页面是否是特定的页面。
|
|
|
|
|
|
- **is_index**：首页
|
|
|
- **is_post**：文章页
|
|
|
- **is_sheet**：自定义页面
|
|
|
- **is_archives**：归档页面
|
|
|
- **is_categories**：分类列表页面
|
|
|
- **is_category**：单个分类页面
|
|
|
- **is_tags**：标签列表页面
|
|
|
- **is_tag**：单个标签页面
|
|
|
- **is_search**：搜索结果页面
|
|
|
- **is_journals**：日志页面
|
|
|
- **is_photos**：图库页面
|
|
|
- **is_links**：友情链接页面
|
|
|
|
|
|
用法：
|
|
|
|
|
|
```html
|
|
|
<#if is_index??>
|
|
|
当前页面是首页
|
|
|
</#if>
|
|
|
```
|
