自翻译·Freemarker 文档（一）

自翻译·Freemarker 文档（一）

自己的英语水平只有一级半，为了努力学好英语，现在一天一个翻译，先从Freemarker文档开始，有不对的地方多谢指正抛砖。

Create a configuration instance
建立一个配置实例

First you have to create a freemarker.template.Configuration instance and adjust its settings. A Configuration instance is a central place to store the appliction level setting of FreeMarker. Also, it deals with the creation and caching of pre-parsed templates.
首先你必须建立一个freemarker.template.Configuration类的实例并调整它的设置. 一个Configuration类实例是保存Freemarker应用程序设置的中心首要. 同样, 它决定着预编译模版的建立和缓冲.

Probably you will do it only once at the beginning of the application(possibly servlet) life-cycle:
也许你只需要在程序开始时,仅仅只需调用一次下面的代码,并且在程序的整个生命周期都可用:

Configuration cfg  =   new  Configuration();
//  Specify the data source where the template files come from.
//  指定模板的数据源
//  Here I set a file directory for it:
//  在这里我设置为一个目录
cfg.setDirectoryForTemplateLoading( new  Fil( " /where/you/store/templates " ));
//  Specify how templates will see the data model. This is an advanced topic
//  指定模板怎么读取数据模型(data model). 这是一个需要专门讨论的话题
//  but just use this:
//  不过现在你可以这样做
cfg.setObjectWrapper( new  DefaultObjectWrapper());  

From now you should use this single configuration instance. Note however that if a system has multiple independent components that use FreeMarker, then of course they will use their own private Configuration instance.
现在开始,你就可以使用这个Configuration实例了. 如果一个系统有多个模块使用Freemarker的话, 毫无意外的, 它们最后使用它们各自私有的Configuration实例.