Flask：静态文件&模板（0.1）

Windows 10家庭中文版，Python 3.6.4，Flask 1.0.2

前面看了Flask的Quickstart文档，可是，一直没有练习里面的内容，这不，刚刚练习完毕，来写篇博文记录一下！

静态文件

我的Flask项目时一个单独的模块，因此，要使用静态文件，只需要在模块所在目录下建立static文件夹，然后把静态文件放入其中。

Flask项目启动后，使用“/static/”加上<文件名>就可以访问静态文件了。

/static/<文件名>

说明，在Quickstart文档中，如果Flask项目是package的话，将static文件夹放到package的根目录下。

我的测试是放了一个html文件进入，命名为static1.html，代码如下：

 <!DOCTYPE html>
 <html>
     <head>
         <meta charset="utf-8">
         <title>Static Files Test</title>
     </head>
     <body>
         <h1>This is the first satic file of Flask.</h1>
     </body>
 </html>

然后，启动hello.py模块：成功

访问上面建立的静态文件：成功

什么是静态文件呢？CSS、JavaScript、图片、音频、视频，甚至HTML文件都是……在我看来，只要放到static文件夹中，就是“静态文件”。

当然，在Quickstart文档介绍中，只提到了CSS、JavaScript文件。需要进行测试，并找更多资料来证明。

在Quickstart文档中介绍的静态文件的使用内置服务器仅适用于项目开发阶段，在生产环境部署时，静态文件是由Web服务器（比如Nginx）

处理、分发的。

很简单、快捷，的确。

模板

为什么使用模板？将数据和视图分离，分离之后，再使用模板引擎将两者生成带数据页面（专业名词叫 渲染（Render））返回给客户端浏览器。

Flask的模板引起是 Jinja2。

Quickstart中介绍了一个render_template()函数来渲染模板，并将一个name变量渲染到了模板中，代码如下：

 return render_template('hello.html', name=name)

在hello.html中一定定义了变量{{ name }}。

模板文件放在哪里？

按照下面的说明创建templates文件夹，，

-项目是一个模块，放到和模块同一目录下；

-项目是package，放到package的根目录下；

然后，将模板文件放入templates文件夹即可。

说明，和前面介绍的static文件夹位置相同。

接下来，建立一个模板文件tmpt1.html进行测试，源码如下：

 <!DOCTYPE html>
 <html>
     <head>
         <meta charset="utf-8">
         <title>Rendering Templates test</title>
     </head>
     <body>
         {{ name }}
     </body>
 </html>

上面的模板文件仅仅定义了一个变量{{ name }}。

目前接触的模板文件都是HTML文件，是否可以是其它文件呢？还需更多了解。

然后，在hello.py中编写处理模板渲染的URL处理函数：

 @app.route("/tmpt")
 def tmptTest():
     ctx = {}
     ctx['name'] = 'Benjamin'
     return render_template('tmpt1.html', **ctx)

启动项目，访问/tmpt链接：成功输出处理函数中需要被渲染的数据

进一步测试： 在模板文件中添加处理函数中没有的参数

前面的模板文件中添加了一个变量{{ name }}，现在，再添加一个变量{{ yourname }}，保持处理函数不变——仍然只提供一个name。

 <!DOCTYPE html>
 <html>
     <head>
         <meta charset="utf-8">
         <title>Rendering Templates test</title>
     </head>
     <body>
         {{ name }}<br />
         {{ yourname }}<br />
     </body>
 </html>

启动项目，访问页面：页面和之前一样，不过，Chrome的控制台没有报错。

千万注意，在更新模板文件后，一定要重启项目！否则，新的模板文件是不会生效的！~经过测试，项目模块文件更新后，也需要

重启才会生效！~总之，只要有改动，那边重启项目！

下面是更新后的项目模块文件，及重启后访问到的页面：显示了name、yourname变量的内容。

测试模板是遇到的错误：

在第一次使用render_template()函数时，将字典参数ctx直接写进入，然后启动得到如下错误：

提示我render_template()函数只有一个位置参数，而我给了两个！那么，我用错了！

查看render_template()函数的文档得知，的确只有一个位置参数，然后是关键词参数：

然后，给我的字典参数ctx加上两颗星号，问题就解决了。

看来，自己对Python函数的各种参数还是不太熟悉啊！位置参数、默认值参数、关键词参数~~

为什么会发生此错误？

一是由于没有细查，二是因为前面使用Django的渲染函数时传入的参数是一个字典的影响。

至此，本次测试完毕。

更多关于这方面的内容，还得查看官方文档才是。

参考链接：

Quickstart之Static Files

Quickstart之Rendering Templates

render_template()使用说明