summaryrefslogtreecommitdiff
path: root/docs/quick_tutorial/static_assets.rst
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2016-04-16 06:57:21 -0700
committerSteve Piercy <web@stevepiercy.com>2016-04-16 06:57:21 -0700
commit41279dddbf5343488542f2629194c68dd3c2142d (patch)
tree36c368d3e6d83f203a29d8707d4b4c34399edef3 /docs/quick_tutorial/static_assets.rst
parentd5e6762315458de334896096923abcd3d51a31f5 (diff)
downloadpyramid-41279dddbf5343488542f2629194c68dd3c2142d.tar.gz
pyramid-41279dddbf5343488542f2629194c68dd3c2142d.tar.bz2
pyramid-41279dddbf5343488542f2629194c68dd3c2142d.zip
quick_tutorial cleanup
- replace nose with pytest - cleanup static_assets.rst
Diffstat (limited to 'docs/quick_tutorial/static_assets.rst')
-rw-r--r--docs/quick_tutorial/static_assets.rst45
1 files changed, 24 insertions, 21 deletions
diff --git a/docs/quick_tutorial/static_assets.rst b/docs/quick_tutorial/static_assets.rst
index 61c5fbd50..65b34f8f9 100644
--- a/docs/quick_tutorial/static_assets.rst
+++ b/docs/quick_tutorial/static_assets.rst
@@ -4,16 +4,17 @@
13: CSS/JS/Images Files With Static Assets
==========================================
-Of course the Web is more than just markup. You need static assets:
-CSS, JS, and images. Let's point our web app at a directory where
-Pyramid will serve some static assets.
+Of course the Web is more than just markup. You need static assets: CSS, JS,
+and images. Let's point our web app at a directory where Pyramid will serve
+some static assets.
Objectives
==========
-- Publish a directory of static assets at a URL
+- Publish a directory of static assets at a URL.
+
+- Use Pyramid to help generate URLs to files in that directory.
-- Use Pyramid to help generate URLs to files in that directory
Steps
=====
@@ -37,8 +38,7 @@ Steps
.. literalinclude:: static_assets/tutorial/home.pt
:language: html
-#. Add a CSS file at
- ``static_assets/tutorial/static/app.css``:
+#. Add a CSS file at ``static_assets/tutorial/static/app.css``:
.. literalinclude:: static_assets/tutorial/static/app.css
:language: css
@@ -47,7 +47,9 @@ Steps
.. code-block:: bash
- $ $VENV/bin/nosetests tutorial
+ $ $VENV/bin/$VENV/bin/py.test tutorial/tests.py -q
+ ....
+ 4 passed in 0.50 seconds
#. Run your Pyramid application with:
@@ -57,30 +59,31 @@ Steps
#. Open http://localhost:6543/ in your browser and note the new font.
+
Analysis
========
We changed our WSGI application to map requests under
-http://localhost:6543/static/ to files and directories inside a
-``static`` directory inside our ``tutorial`` package. This directory
-contained ``app.css``.
+http://localhost:6543/static/ to files and directories inside a ``static``
+directory inside our ``tutorial`` package. This directory contained
+``app.css``.
-We linked to the CSS in our template. We could have hard-coded this
-link to ``/static/app.css``. But what if the site is later moved under
-``/somesite/static/``? Or perhaps the web developer changes the
-arrangement on disk? Pyramid gives a helper that provides flexibility
-on URL generation:
+We linked to the CSS in our template. We could have hard-coded this link to
+``/static/app.css``. But what if the site is later moved under
+``/somesite/static/``? Or perhaps the web developer changes the arrangement on
+disk? Pyramid gives a helper that provides flexibility on URL generation:
.. code-block:: html
${request.static_url('tutorial:static/app.css')}
-This matches the ``path='tutorial:static'`` in our
-``config.add_static_view`` registration. By using ``request.static_url``
-to generate the full URL to the static assets, you both ensure you stay
-in sync with the configuration and gain refactoring flexibility later.
+This matches the ``path='tutorial:static'`` in our ``config.add_static_view``
+registration. By using ``request.static_url`` to generate the full URL to the
+static assets, you both ensure you stay in sync with the configuration and gain
+refactoring flexibility later.
+
-Extra Credit
+Extra credit
============
#. There is also a ``request.static_path`` API. How does this differ from