主题开发

公共模板

目录

公共模板

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

为了减少重复代码,我们将某些常见的全局变量封装成了一个公共模板,我们只需要引入该模板,然后调用其中的宏模板即可。

公共 head 模板

需要注意的是,为了保证系统功能的完整性,我们强制要求在每个页面的 <head> 标签下必须包含此模板。

<@global.head />

等同于:

<#if options.seo_spider_disabled!false>
    <meta name="robots" content="none">
</#if>
<meta name="generator" content="Halo ${version!}"/>
<@favicon />
<@custom_head />
<@custom_content_head />

公共底部

需要注意的是,为了保证系统功能的完整性,我们强制要求在每个页面的尾部必须包含此模板。

<@global.footer />

等同于:

<@global.statistics />
<@global.footer_info />

相对时间

<@global.timeline datetime="时间" />

// 输出
x 年前/x 个月前/x 天前/昨天/x 小时前/x 分钟前/x 秒前/刚刚

评论模块

<@global.comment target= type="" />

等同于:

<#if !post.disallowComment!false>
    <script src="//cdn.jsdelivr.net/npm/[email protected]/dist/vue.min.js"></script>
    <script src="${options.comment_internal_plugin_js!'//cdn.jsdelivr.net/npm/[email protected]/dist/halo-comment.min.js'"></script>
    <halo-comment id="${post.id}" type="${type}"/>
</#if>

参数说明:

  • target:post / sheet / journal 对象
  • type:评论类型,可为:post / sheet / journal

例子:

在文章页面(post.ftl or post_xxx.ftl):

<@global.comment target=post type="post" />

在自定义页面(sheet.ftl or post_sheet.ftl):

<@global.comment target=sheet type="sheet" />

在日志页面(journals.ftl):

<@global.comment target=journal type="journal" />