From bc8e021b34a696660410ee60e61664ab969e5cf3 Mon Sep 17 00:00:00 2001 From: Armin Ronacher Date: Thu, 15 Jul 2010 15:42:27 +0200 Subject: [PATCH] Added a note on references to static folders --- docs/patterns/packages.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/patterns/packages.rst b/docs/patterns/packages.rst index 63d7d76e..f6e1ad87 100644 --- a/docs/patterns/packages.rst +++ b/docs/patterns/packages.rst @@ -243,3 +243,18 @@ name of the module. So for the admin it would be ``render_template('admin/list_items.html')`` and so on. It is not possible to refer to templates without the prefixed module name. This is explicit unlike URL rules. + +.. admonition:: References to Static Folders + + Please keep in mind that if you are using unqualified endpoints by + default Flask will always assume the module's static folder, even if + there is no such folder. + + If you want to refer to the application's static folder, use a leading + dot:: + + # this refers to the application's static folder + url_for('.static', filename='static.css') + + # this refers to the current module's static folder + url_for('static', filename='static.css')