Browse Source

Fixed some minor typos throughout docs.

pull/1638/head
Ron DuPlain 15 years ago committed by Armin Ronacher
parent
commit
93a8ca0282
  1. 4
      docs/becomingbig.rst
  2. 6
      docs/design.rst
  3. 6
      docs/foreword.rst
  4. 2
      docs/installation.rst
  5. 16
      docs/quickstart.rst

4
docs/becomingbig.rst

@ -25,7 +25,7 @@ In that case, it makes a lot of sense to use dotted names for the URL
endpoints.
Here are some suggestions for how Flask can be modified to better
accomodate large-scale applications:
accommodate large-scale applications:
- implement dotted names for URL endpoints
- get rid of the decorator function registering which causes a lot
@ -33,7 +33,7 @@ accomodate large-scale applications:
also requires that the whole application is imported when the system
initializes or certain URLs will not be available right away. A
better solution would be to have one module with all URLs in there and
specifing the target functions explicitly or by name and importing
specifying the target functions explicitly or by name and importing
them when needed.
- switch to explicit request object passing. This requires more typing
(because you now have something to pass around) but it makes it a

6
docs/design.rst

@ -51,7 +51,7 @@ possible without hacks if the object were created ahead of time for you
based on a class that is not exposed to you.
But there is another very important reason why Flask depends on an
explicit instanciation of that class: the package name. Whenever you
explicit instantiation of that class: the package name. Whenever you
create a Flask instance you usually pass it `__name__` as package name.
Flask depends on that information to properly load resources relative
to your module. With Python's outstanding support for reflection it can
@ -125,7 +125,7 @@ advantage.
Flask is a framework that takes advantage of the work already done by
Werkzeug to properly interface WSGI (which can be a complex task at
times). Thanks to recent developments in the Python package
infrastructure, packages with depencencies are no longer an issue and
infrastructure, packages with dependencies are no longer an issue and
there are very few reasons against having libraries that depend on others.
@ -140,7 +140,7 @@ isn't that a bad idea?
Yes it is usually not such a bright idea to use thread locals. They cause
troubles for servers that are not based on the concept of threads and make
large applications harder to maintain. However Flask is just not designed
for large applications or asyncronous servers. Flask wants to make it
for large applications or asynchronous servers. Flask wants to make it
quick and easy to write a traditional web application.
Also see the :ref:`becomingbig` section of the documentation for some

6
docs/foreword.rst

@ -68,15 +68,15 @@ up in situations where we think "well, this is just far fetched, how could
that possibly be exploited" and then an intelligent guy comes along and
figures a way out to exploit that application. And don't think, your
application is not important enough for hackers to take notice. Depending
ont he kind of attack, chances are there are automated botnets out there
trying to figure out how to fill your database with viagra adverisments.
on the kind of attack, chances are there are automated botnets out there
trying to figure out how to fill your database with viagra advertisements.
So always keep that in mind when doing web development.
Target Audience
---------------
Is Flask for you? Is your application small-ish (less than 4000 lines of
Is Flask for you? If your application small-ish (less than 4000 lines of
Python code) and does not depend on too complex database structures, Flask
is the Framework for you. It was designed from the ground up to be easy
to use, based on established principles, good intentions and on top of two

2
docs/installation.rst

@ -122,7 +122,7 @@ Get the git checkout in a new virtualenv and run in develop mode::
...
Finished processing dependencies for Flask
This will pull in the depdenencies and activate the git head as current
This will pull in the dependencies and activate the git head as current
version. Then you just have to ``git pull origin`` to get the latest
version.

16
docs/quickstart.rst

@ -83,7 +83,7 @@ you enable the debug support the server will reload itself on code changes
and also provide you with a helpful debugger if things go wrong.
There are two ways to enable debugging. Either set that flag on the
applciation object::
application object::
app.debug = True
app.run()
@ -139,7 +139,7 @@ likely he will like the page and come back next time.
To add variable parts to a URL you can mark these special sections as
``<variable_name>``. Such a part is then passed as keyword argument to
your function. Optionally a converter can be specifed by specifying a
your function. Optionally a converter can be specified by specifying a
rule with ``<converter:variable_name>``. Here some nice examples::
@app.route('/user/<username>')
@ -186,8 +186,8 @@ parameter. Here some examples:
>>> with app.test_request_context():
... print url_for('index')
... print url_for('login')
... print url_for('profile', username='John Doe')
... print url_for('login', next='/')
... print url_for('profile', username='John Doe')
...
/
/login
@ -319,7 +319,7 @@ Here's a simple example of how to render a template::
Flask will look for templates in the `templates` folder. So if your
application is a module, that folder is next to that module, if it's a
pacakge it's actually inside your package:
package it's actually inside your package:
**Case 1**: a module::
@ -484,7 +484,7 @@ We recommend accessing URL parameters with `get` or by catching the
`KeyError` because users might change the URL and presenting them a 400
bad request page in that case is a bit user unfriendly.
For a full list of methods and attribtues on that object, head over to the
For a full list of methods and attributes on that object, head over to the
:class:`~flask.request` documentation.
@ -493,7 +493,7 @@ File Uploads
Obviously you can handle uploaded files with Flask just as easy. Just
make sure not to forget to set the ``enctype="multipart/form-data"``
attribtue on your HTML form, otherwise the browser will not transmit your
attribute on your HTML form, otherwise the browser will not transmit your
files at all.
Uploaded files are stored in memory or at a temporary location on the
@ -576,7 +576,7 @@ you want to customize the error page, you can use the
Note the ``404`` after the :func:`~flask.render_template` call. This
tells Flask that the status code of that page should be 404 which means
not found. By default 200 is assumed which translats to: all went well.
not found. By default 200 is assumed which translates to: all went well.
.. _sessions:
@ -586,7 +586,7 @@ Sessions
Besides the request object there is also a second object called
:class:`~flask.session` that allows you to store information specific to a
user from one request to the next. This is implemented on top of cookies
for you and signes the cookies cryptographically. What this means is that
for you and signs the cookies cryptographically. What this means is that
the user could look at the contents of your cookie but not modify it,
unless he knows the secret key used for signing.

Loading…
Cancel
Save