这篇导读写给已经装好站点、准备动手改默认主题的开发者。它不按章节讲语法,而是从最常见的五件事出发,告诉你该翻到《FreeMarker 模板入门手册》的哪一页。本页可以直接翻阅的文件就是这本手册,共十二页。

从要做的事找页码

想做的事翻到哪里
改页头、页脚第4页:布局宏与公共片段
调整首页“最新文章”的条数和排序第9页:文章列表标签及参数
给栏目页加上分页第9页:分页列表
输出同级栏目的导航第10页:栏目列表
页面报错,或内容被原样显示第11页:常见问题

两个容易踩的地方

  • 用包含指令引入的片段不受外层转义保护,转义要在片段里另写一遍(第8页);
  • 数字用在链接或脚本里时,要按不带千位分隔符的写法输出(第11页)。

动手之前,先确认改的是站点正在使用的那套主题。