Python模板库Mako

顺德公农庄

官方最新文档：
http://docs.makotemplates.org/en/latest/

中文语法文档
http://www.yeolar.com/note/2012/08/28/mako-syntax/　　
　　快速总结
　　特点：简单快速，对模块化编程支持到位，能直接调用python代码。

　　关于速度的对比：
　　　　Mako:1.10 ms    Myghty:4.52 ms
　　　　Cheetah:1.10 msGenshi:11.46 ms
　　　　Django:2.74 msKid:14.54 ms

　　本质及哲学：
　　mako的本质：模板语言。

　　第一原则：要写好mako，最重要的是模块化编程，将重复代码抽取出来，提取出公用的模块。mako的inherit/def/namespace/page等功能对模块化编程提供了很方便的支持。另外要把握模板语言的本质和知识结构。

　　第二原则：弄明白mako运行环境和运行机制。在此提供两段代码，如果你能知道mako背后都做了哪些事情就Ok。

　　Mako' Philosophy: Don't reinvent the wheel

　　常见的使用方式：



Python代码  

• from mako.template import Template  
  
• from mako.runtime import Context  
  
• from StringIO import StringIO  
  
• 
  
• mytemplate = Template("hello, ${name}!")  
  
• buf = StringIO()
  
• ctx = Context(buf, name="jack")  
  
• mytemplate.render_context(ctx)
  

　　Python代码  

• from mako.template import Template  
  
• from mako.lookup import TemplateLookup  
  
• 
  
• mylookup = TemplateLookup(directories=['/docs'], module_directory='/tmp/mako_modules')  
  
• 
  
• def serve_template(templatename, **kwargs):  
  
•     mytemplate = mylookup.get_template(templatename)
  
•     print mytemplate.render(**kwargs)  
  

Python代码  

• from mako.template import Template  
  
• 
  
• mytemplate = Template(filename='/docs/mytmpl.txt', module_directory='/tmp/mako_modules')  
  
• print mytemplate.render()  
  

　　



Python代码  

• from mako.template import Template  
  
• from mako.lookup import TemplateLookup  
  
• 
  
• mylookup = TemplateLookup(directories=['/docs'])  
  
• mytemplate = Template("""<%include file="header.txt"/> hello world!""", lookup=mylookup)  
  

　　
知识结构：
　　所有的模板语言，都是对“文本”进行编译，所得结果为最终“页面”（“文本”和“页面”在后面会解释）。在编译过程中进行值的替换：将原文本中某些特殊标记（比如${name}）替换为目标文本（target）。定义特殊标记的规则便是模板语言的语法，比如取值运算，方法定义，方法调用等。在将原文本替换为目标的过程中，常常依赖外界传入值，比如，讲原文本${name}替换为用户的姓名，可用户的姓名去哪取呢？这就需要在生成模板的时候提供一个环境，也叫“上下文”（Context），专门用于提供模板解析过程中需要的值。

　　上段文字中提到的文本／页面／上下文，有必要解释一下。

　　文本：模板一定是存放在文本中么？不是。可以存在string变量中，数据库中或者从网络上读取。

　　页面：模板处理的结果一定是页面么？不是。大部分情况下我们将模板语言用于生成网页页面，但也可以用于生成邮件内容吧？可以生成pdf吧？或者，用来生成代码（代码的模板），做一个代码生成器。

　　上下文：上下文一定需要是个Context对象么？不一定，只要可以用于传递值就Ok，所以可以是Context，也可以像struts标签那样使用栈，也可以像mako这样使用一个字典（dict）。

　　再说说模板的缓存：
　　模板的缓存以提高性能，在内存中缓存一些模板，下次调用模板时就不要去硬盘读取。这样理解错误，最重要的是，不需要进行模板的重新编译和模块重新加载。毕竟，原模板是人写出来的，但对机器处理来说可读性并不高，所以需要编译处理的过程。缓存模板可以省略硬盘文件读取语法检查和编译这些阶段。下次需要使用该模板渲染数据的时候，先检查硬盘模板文件的更新时间和缓存结果的编译时间做对比，如果模板编译后硬盘文件未发生更新，直接使用编译后的模板即可。否则，需要重新读取硬盘中模板文件再次编译。当然，如果是从数据库和网络读取文件，另说。
　　
　　参考：
　　http://liaofeng-xiao.iyunv.com/blog/1297272