diff options
| author | Steve Piercy <web@stevepiercy.com> | 2015-10-04 02:14:38 -0700 |
|---|---|---|
| committer | Steve Piercy <web@stevepiercy.com> | 2015-10-04 02:14:38 -0700 |
| commit | cbd2b039e5c57df5f17ef543c52056bc983f8ccf (patch) | |
| tree | f51e87ce82b0280735e4869e38a8e90a9d1f6c7a | |
| parent | 7dee962c56f5ff5c8ad486944253635fd1df3739 (diff) | |
| download | pyramid-cbd2b039e5c57df5f17ef543c52056bc983f8ccf.tar.gz pyramid-cbd2b039e5c57df5f17ef543c52056bc983f8ccf.tar.bz2 pyramid-cbd2b039e5c57df5f17ef543c52056bc983f8ccf.zip | |
grammar, rst heading underline fixes
| -rw-r--r-- | docs/narr/firstapp.rst | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/docs/narr/firstapp.rst b/docs/narr/firstapp.rst index e73ef66ac..ee7511770 100644 --- a/docs/narr/firstapp.rst +++ b/docs/narr/firstapp.rst @@ -4,7 +4,7 @@ .. _firstapp_chapter: Creating Your First :app:`Pyramid` Application -================================================= +============================================== In this chapter, we will walk through the creation of a tiny :app:`Pyramid` application. After we're finished creating the application, we'll explain in @@ -52,7 +52,7 @@ done by the wsgiref server we've used to serve this application. It logs an Press ``Ctrl-C`` (or ``Ctrl-Break`` on Windows) to stop the application. Now that we have a rudimentary understanding of what the application does, -let's examine it piece-by-piece. +let's examine it piece by piece. Imports ~~~~~~~ @@ -129,7 +129,7 @@ defined imports and function definitions, placed within the confines of an :linenos: :lines: 9-15 -Let's break this down piece-by-piece. +Let's break this down piece by piece. Configurator Construction ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -145,7 +145,7 @@ line. For example, if the file named ``helloworld.py`` contains the entire script body, the code within the ``if`` statement will only be invoked when ``python helloworld.py`` is executed from the command line. -Using the ``if`` clause is necessary -- or at least best practice -- because +Using the ``if`` clause is necessary—or at least best practice—because code in a Python ``.py`` file may be eventually imported via the Python ``import`` statement by another ``.py`` file. ``.py`` files that are imported by other ``.py`` files are referred to as *modules*. By using the @@ -170,7 +170,7 @@ Adding Configuration :linenos: :lines: 11-12 -First line above calls the :meth:`pyramid.config.Configurator.add_route` +The first line above calls the :meth:`pyramid.config.Configurator.add_route` method, which registers a :term:`route` to match any URL path that begins with ``/hello/`` followed by a string. @@ -220,7 +220,7 @@ WSGI Application Serving Finally, we actually serve the application to requestors by starting up a WSGI server. We happen to use the :mod:`wsgiref` ``make_server`` server maker for this purpose. We pass in as the first argument ``'0.0.0.0'``, -which means "listen on all TCP interfaces." By default, the HTTP server +which means "listen on all TCP interfaces". By default, the HTTP server listens only on the ``127.0.0.1`` interface, which is problematic if you're running the server on a remote system and you wish to access it with a web browser from a local system. We also specify a TCP port number to listen on, |