主题开发

全局变量

目录

全局变量

最后更新时间:2020-03-26

这些变量可以在页面的任意地方调用。

博客地址

${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!}

页面关键词

${meta_keywords!}

需要注意的是,虽然这个变量在任何页面都可以使用,但是其值可能在不同的页面是不一样的。会根据用户的设置,生成对应的值。

假设在文章页面:

  • 如果用户为文章设置了标签,而没有设置 自定义关键词,系统会自动将标签设置为页面关键词。
  • 如果用户设置了 自定义关键词,那么则会取用户设置的值。

页面描述

${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

图库页面地址

${photos_url!}

需要注意的是,该链接也不是固定的值,主要根据用户的设置而改变。

假设后台的 全局绝对路径 为开启状态,那么其变量值为 https://yourdomain.com/{photos_prefix},反之则为 /{photos_prefix}

其中, 也是用户可设定的值,用户可以在后台修改 图库页面 的前缀,默认为 photos

日志页面地址

${journals_url!}

需要注意的是,该链接也不是固定的值,主要根据用户的设置而改变。

假设后台的 全局绝对路径 为开启状态,那么其变量值为 https://yourdomain.com/{journals_prefix},反之则为 /{journals_prefix}

其中, 也是用户可设定的值,用户可以在后台修改 日志页面 的前缀,默认为 journals

文章归档页面地址

${archives_url!}

需要注意的是,该链接也不是固定的值,主要根据用户的设置而改变。

假设后台的 全局绝对路径 为开启状态,那么其变量值为 https://yourdomain.com/{archives_prefix},反之则为 /{archives_prefix}

其中, 也是用户可设定的值,用户可以在后台修改 归档 的前缀,默认为 archives

分类列表页面地址

${categories_url!}

需要注意的是,该链接也不是固定的值,主要根据用户的设置而改变。

假设后台的 全局绝对路径 为开启状态,那么其变量值为 https://yourdomain.com/{categories_prefix},反之则为 /{categories_prefix}

其中, 也是用户可设定的值,用户可以在后台修改 分类 的前缀,默认为 categories

标签列表页面地址

${tags_url!}

需要注意的是,该链接也不是固定的值,主要根据用户的设置而改变。

假设后台的 全局绝对路径 为开启状态,那么其变量值为 https://yourdomain.com/{tags_prefix},反之则为 /{tags_prefix}

其中, 也是用户可设定的值,用户可以在后台修改 标签 的前缀,默认为 tags