不同的程序主题有不同的全局变量调用方式。比如我们熟悉的WordPress程序,他的各种调用标签是不同的,这些也是官方设定好的,我们也无法改变。任何的主题开发和二次开发都要遵循官方的标签调用。这不在Halo轻量博客程序中,我们要主题开发也需要熟悉官方的标签。这里,老蒋整理Halo轻量博客程序的全局变量。

Halo博客主题开发之全局变量模板标签调用整理

如果我们有主题开发或者调用的话需要遵循查看。

1、博客地址

${blog_url!}


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

2、网站根路径

${context!}


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

3、主题资源根路径

${theme_base!}


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

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

${theme_base!}/css/style.css


4、主题信息

主题名称

${theme.name!}


主题 git 仓库地址

${theme.repo!}


主题版本号

${theme.version!}


5、博客标题

${blog_title!}


6、博客LOGO

${blog_logo!}


7、程序版本号

${version!}


8、博主信息

昵称:

${user.nickname!}


邮箱地址:

${user.email!}


描述:

${user.description!}


头像地址:

${user.avatar!}


上次登录时间:

${user.expireTime!}


9、SEO关键字

${meta_keywords!}


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

10、SEO描述

${meta_description!}


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

11、RSS 2.0 订阅地址

${rss_url!}


12、Atom 格式的订阅地址

${atom_url!}


13、Xml 格式的网站地图地址

${sitemap_xml_url!}


14、HTML 格式的网站地图地址

${sitemap_html_url!}


格式如:https://www.itbulu.com/sitemap.html

15、友情链接页面地址

${links_url!}


16、图库页面地址

${photos_url!}


17、日志页面地址

${journals_url!}


18、 文章归档页面地址

${archives_url!}


全局绝对路径为开启的状态下:https://www.lezaiyun.com.com/{archives_prefix}

全局绝对路径为关闭的状态下:/{archives_prefix}

19、 分类列表页面地址

${categories_url!}


全局绝对路径为开启的状态下:https://www.itbulu.com.com/{categories_prefix}

全局绝对路径为关闭的状态下:/{categories_prefix}

20、 标签列表页面地址

${tags_url!}


21、 页面判断

判断当前页面是否是特定的页面。

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>


这样,基本上熟悉我们的使用Halo的全局变量调用,可以实现主题开发。实际上主题开发不难,只要前端后就是添加调用变量。