这篇导读写给已经装好站点、准备动手改默认主题的开发者。它不按章节讲语法,而是从最常见的五件事出发,告诉你该翻到《FreeMarker 模板入门手册》的哪一页。本页可以直接翻阅的文件就是这本手册,共十二页。
从要做的事找页码
| 想做的事 | 翻到哪里 |
|---|---|
| 改页头、页脚 | 第4页:布局宏与公共片段 |
| 调整首页“最新文章”的条数和排序 | 第9页:文章列表标签及参数 |
| 给栏目页加上分页 | 第9页:分页列表 |
| 输出同级栏目的导航 | 第10页:栏目列表 |
| 页面报错,或内容被原样显示 | 第11页:常见问题 |
两个容易踩的地方
- 用包含指令引入的片段不受外层转义保护,转义要在片段里另写一遍(第8页);
- 数字用在链接或脚本里时,要按不带千位分隔符的写法输出(第11页)。
动手之前,先确认改的是站点正在使用的那套主题。