docs/global-variable.md at 11b2ac3b3ead355696c66ea2b76e27dceaeab16e - docs

5.3 KiB

Raw Blame History Unescape Escape

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：友情链接页面

用法：

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

5.3 KiB Raw Blame History Unescape Escape