<table cellspacing="0" cellpadding="0" width="100%" summary="Header navigation table" border="0"><tbody><tr><th align="middle" colspan="3">Smarty - the compiling PHP template engine<br/><br/> Smarty - PHP 模板编译引擎</th></tr><tr><td valign="bottom" align="left" width="25%"><a accesskey="P" href="preface.html">Prev</a></td> <td valign="bottom" align="middle" width="50%"/> <td valign="bottom" align="right" width="25%"><a accesskey="N" href="getting.started.html">Next</a></td></tr></tbody></table> # Preface to Translation 译序 一、声明 本Smarty3中文手册是由原php中文社区的smarty2中文手册基础上改进而来。虽然Smarty3代码已全部转为面向对象语言，但整体功能大部份并没有因此改变，鉴于此，本手册保留了原Smarty2中文手册的目录结构、页面排版及大部份层叠样式表（css）等，当然，里面也有翻译人手有限--只有一人的因素。因此，初乍看本手册与原2手册非常相像。因为，本手册保留原2手册大部份翻译文字，因此，为尊重翻译成果起见，在24章的翻译列表里还保留2手册的全部翻译人员名单。 本手册除了内容有所改变以外，在手册的整理上还作了调整： 删除了页面中的php中文社区链接，因为该链接已经失效；但还是为该社区做下广告--[PHP中文社区](http://www.phpnet.cn)：）； 为了阅读流畅、译文更准确起见，本手册修改了部份原2手册的翻译文字，包括函数名等的翻译，请留意； 没有翻译[{php}](#)和[{include_php}](#)这两个内置函数，因为大量使用这两个函数会使Smarty失去意义，如果有需要可查看英文手册，或原2手册。 另外在2手册的基础上作了些其它改变： 增加了简单的Smarty示意图； 统一了原2手册的命名，因为Smarty2.x手册是由多人合译的，在命名方面稍显凌乱； 统一提示、注意、译注、警告等样式； 为阅读方便，由原来的一段英文对应一段的翻译改为按情况1对1或n对n的连续翻译做法； 增加了3.0.x安装包里面两个文件的翻译，分别是《[smarty2_bc_notes](#)》和《[readme](#)》，因为本人觉得这两个文件很重要，特别是对于由2升至3的使用者。建议老用户通读这两个文件； 可能很多人都有与我一样的感受---查看中英文对照翻译版本非常累，要么阅读纯粹的英文版本，要么阅读纯中文版本，但，翻译纯中文版本的前提是译文准确。因此，为实现这个目标，我会先将本中英版本放上网络，等待大家的翻译改进意见，到时机成熟时再推出纯中文Smarty3手册。 另外，原英文manual手册中出现了不少笔误，本人在翻译过程中尽量按上下文语意理解，实在难以解释的地方旁边加译注，希望有识之人能在阅读过程中反馈回来，以便在新Smarty3中文手册中加以改进。 为尊重翻译起见，建议转载本手册的用户保留手册里面的翻译列表，特别是需要分解手册为单页面放入网络的人士。 如果原php社区翻译人员在翻译或注明翻译人员安排方面有异议请与本人联系。 二、翻译来由 仰慕Smarty的大名已很久。对于所有的phper，模板始终是一个绕不过的垦，当然，对于大公司而言可像discuz!一样使用自己的模板，而不必再奢求另一种模板语言。但对于大部份的phper而言，使用现成的、可靠的模板语言还是最现实的选择。而Smarty则是php模板语言中的杰出者，它酒精考验---发展近10年，功能强大---自定义书写方式、自定义插件、自定义函数...简直随心所欲，机制合理---编译、缓存，而且价格公道---免费，如此Smarty怎能叫人不爱呢？！ 嗯，虽然Smarty足够优秀，但它并非只是由几段简单的php语句构成，就像很多时候，当一个美女站在你面前时，你并非总能立即长插直入，虽然这种情况也有，但事后你会觉得兴趣全无，大部份时候，你需层层剥离、拨云见日才能达到目标，而Smarty就是那种需要你琢磨、捣鼓的东东，因为它内涵丰富、气质独特，它包含有变量、调节器、函数、插件、方法、编译、缓存等一大堆内容。所以，毫不夸张地说，你在学php以外的另一种语言。 当观摩完（配不上学）php一年之后，面对Smarty，我遇到了一个难题，那就是Smarty3完成没有中文手册！我只能找来Smarty2中文配Smarty3观摩一番，问题出现了，Smarty3并非是Smarty2的简单升级，它改了内核，调整了内容，当你完全按照Smarty2手册的指示实践时，错误频出。 怎么办？网络是绝望了，如果你搜索下载Smarty3中文手册，那你就被骗了，因为它在本手册诞生前并不存在。而对于英文manual，我真的不想再装逼看下去，因为它令人头痛，而且纯pdf的格式我喜欢不来。 经过几天几夜的思考，我决定豁出去了，准备拯救一回世界，为此我断断续续总共花费了近2个月，然后...，基本这就是本手册诞生的过程啦：）。 不过，希望大家不要对我抱太大的希望，本人英语水平只有可怜的四级，而且考了几回，最重要的是那还是七八年前的事了。能借助有道字典与google翻译把每个单词看懂已实属不易（其实还有很多并不明白），而要把它们串联起来则更加困难；再者，对于php，对于smarty我并不比你懂，所以，我对手册中翻译错误频出非常有信心。如果各位能在百忙之中抽时间帮我改正、指点一二，在下十分感激。 三、Smarty示意图 1、工作流程示意图  2、文件结构示意图  3、第一个Smarty模板 <table border="0" bgcolor="#e0e0e0" width="100%"><tbody><tr><td><p>test.php:<br/> //放在/demo文件夹下面<br/> &lt;?php<br/> include_once('../libs/Smarty.class.php');<br/> $smarty = new Smarty;<br/> $var = 'hello!';<br/> $smarty-&gt;assign('abc',$var);<br/> $smarty-&gt;display('test.html');</p> <p>test.html:<br/> //放在/demo/templates文件夹下面<br/> {assign var="bcd" value="everyone!"}<br/> {$abc}{$bcd}</p> <p>输出：<br/> //输入网址http://127.0.0.1/smarty/demo/test.php<br/> hello,everyone!</p></td> </tr></tbody></table> 译注 | 可以看到上面有两个assign，都用来赋值。第一个为Smarty方法，用在php程序里面，第二个为内置函数，用在模板中赋值。 | |-----| <table cellspacing="0" cellpadding="0" width="100%" summary="Footer navigation table" border="0"><tbody><tr><td valign="top" align="left" width="33%"><a accesskey="P" href="preface.html">Prev</a></td> <td valign="top" align="center" width="34%"><a accesskey="H" href="index.html">Home</a></td> <td valign="top" align="right" width="33%"><a accesskey="N" href="getting.started.html">Next</a></td></tr><tr><td valign="top" align="left" width="33%">Preface<br/> 序</td> <td valign="top" align="middle" width="34%"> </td> <td valign="top" align="right" width="33%">Getting Started<br/> 开始</td></tr></tbody></table>