从官方文档学《Freemarker》(2)

Freemarker官方参考手册里到底说了什么

前一节强调了看文档谦虚的心态，阅读的时候如果是抱着就是要找自己想要知道信息的态度去看，那就会看的比较累比较躁了。反而我们要抱着看作者到底想要什么的角度去看，就会觉得有意思很多。

博主本人手边的一些文档，不少反反复复的看一遍又一遍，经常一不小心就被原作者精心的编撰所折服。那让我们来看看Freemarker官方文档到底说了什么。

Freemarker官方文档的内容

作为Freemarker Manual 这个文档是作为手册而存在的，所以里面不会是大量可运行的示例代码，那个是Quick Start，Simple Example的要说明的内容。

一个重要的技巧从大纲去读一遍文档

Freemarker手册分为

• 模板开发指南
• 程序开发指南
• 模板语言参考
• XML处理指南
• 附录
  五大部分。

精通一项技术和研究一门外语一样，要学这门语言的文化背景，这门语言的语法结构，还有别忘了身边随时留一份这门语言的辞典。Freemarker的这份参考手册就是说明了这类问题。

模板开发指南部分

是在告诉我们Freemarker这门技术的来龙去脉，Freemarker的作者是怎么看待字处理模板引擎技术的，

程序开发指南

告诉了我们Freemarker是如何安排Java模块实现以上思想的，当然限于作者的精力，不可能那么详细，但是对于知其所以然的理解Spring、Struts2等容器是如何整合Freemarker的，以及如何自定义扩展Freemarker有重要的参考意义

* 模板语言参考

这部分就是一份长期离不开的辞典了，以上两个部分也许看过以后会，理解了就融汇贯通了。有一段时间不怎么需要看，而这部分则会在相当长的一段时间内常常要翻阅。其实这种翻阅也是一种查生词式的翻阅。

XML处理指南

这个功能是Freemarker技术的一个独有功能，能够将XML按模板转换，这个问题暂时不在这里展开描述。

附录

最后重点要提醒一下，大家别忘了附录，想象一下如果你写了一本书（当然为了凑页数除外），既然放在附录里的往往会有一些比较实用的干货，很值得一看。例如这里就解释了为什么Freemarker坚持一定要明确处理null值,以及许多新手遇到的数字有逗号分隔符号的问题。

总结

其实互联网上的知识，有时候也是稀疏的。同样是做网站相关的，有的人搞的是PHP、有的人搞的JSF，有的人是在互联网行业、有的人是在企业应用行业。他们对于技术的需求和理解，他们所处的合作技术生态是各有差异的。能保持自己的一双慧眼，独立的思考和实践，不急不躁，认识到一份资料里有什么、没有什么，也就迈出了自主学习的第一步。