跳到主要内容
版本:1.5

全局变量

博客地址

${blog_url!}

此变量与后台博客设置中的 博客地址 相对应。

网站根路径

${context!}

需要注意的是,此变量和 blog_url 不同的是,这个变量有两种值,一种为相对路径形式,一种为绝对路径形式。

那么,当在后台博客设置中将 全局绝对路径 的选项打开时,context 变量值为 ${blog_url}/,关闭时,context 的变量值为 /

假设,我设置的 博客地址https://halo.run,那么:

  • 全局绝对路径为开启的状态下:https://halo.run/
  • 全局绝对路径为关闭的状态下:/

主题资源根路径

${theme_base!}

假设你的主题在 ~/halo-dev/templates/themes/anatole 这个目录,那么 theme_basehttps://yourdomain/themes/anatole

举个例子,你当前开发的主题为 anatole,当你要获取主题下 css/style.css 这个文件的路径,那么:

${theme_base!}/css/style.css

主题信息

主题名称:

${theme.name!}

主题 git 仓库地址:

${theme.repo!}

主题版本号:

${theme.version!}

博客标题

${blog_title!}

此变量与后台博客设置中的 博客标题 相对应。

${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:友情链接页面

用法:

<#if is_index??>
当前页面是首页
</#if>