diff --git a/website/sphinx/index.rst b/website/sphinx/index.rst
index a6246211..f31fc488 100644
--- a/website/sphinx/index.rst
+++ b/website/sphinx/index.rst
@@ -9,6 +9,7 @@ available.
.. toctree::
:maxdepth: 2
+ overview
webframework
networking
integration
diff --git a/website/sphinx/overview.rst b/website/sphinx/overview.rst
index 040d5c08..67df0dc6 100644
--- a/website/sphinx/overview.rst
+++ b/website/sphinx/overview.rst
@@ -1,7 +1,7 @@
Overview
---------
+========
-`FriendFeed `_'s web server is a relatively
+`FriendFeed's `_ web server is a relatively
simple, non-blocking web server written in Python. The FriendFeed
application is written using a web framework that looks a bit like
`web.py `_ or Google's
@@ -144,48 +144,38 @@ Ubuntu Linux (Python 2.5)
Module index
------------
-The most important module is
-```web`` `_,
+The most important module is `tornado.web`
which is the web framework that includes most of the meat of the Tornado
-package. The other modules are tools that make ``web`` more useful. See
+package. The other modules are tools that make `tornado.web` more useful. See
`Tornado walkthrough <#tornado-walkthrough>`_ below for a detailed
-walkthrough of the ``web`` package.
+walkthrough of the `~tornado.web` package.
Main modules
~~~~~~~~~~~~
-- ```web`` `_
- - The web framework on which FriendFeed is built. ``web``
+- `tornado.web` - The web framework on which FriendFeed is built. `web`
incorporates most of the important features of Tornado
-- ```escape`` `_
- - XHTML, JSON, and URL encoding/decoding methods
-- ```database`` `_
- - A simple wrapper around ``MySQLdb`` to make MySQL easier to use
-- ```template`` `_
- - A Python-based web templating language
-- ```httpclient`` `_
- - A non-blocking HTTP client designed to work with ``web`` and
- ``httpserver``
-- ```auth`` `_
- - Implementation of third party authentication and authorization
- schemes (Google OpenID/OAuth, Facebook Platform, Yahoo BBAuth,
+- `tornado.escape` - XHTML, JSON, and URL encoding/decoding methods
+- `tornado.database` - A simple wrapper around ``MySQLdb`` to make MySQL
+ easier to use
+- `tornado.template` - A Python-based web templating language
+- `tornado.httpclient` - A non-blocking HTTP client designed to work
+ with ``web`` and ``httpserver``
+- `tornado.auth` - Implementation of third party authentication and
+ authorization schemes (Google OpenID/OAuth, Facebook Platform, Yahoo BBAuth,
FriendFeed OpenID/OAuth, Twitter OAuth)
-- ```locale`` `_
- - Localization/translation support
-- ```options`` `_
- - Command line and config file parsing, optimized for server
- environments
+- `tornado.locale` - Localization/translation support
+- `tornado.options` - Command line and config file parsing, optimized for
+ server environments
Low-level modules
~~~~~~~~~~~~~~~~~
-- ```httpserver`` `_
- - A very simple HTTP server built on which ``web`` is built
-- ```iostream`` `_
- - A simple wrapper around non-blocking sockets to aide common reading
- and writing patterns
-- ```ioloop`` `_
- - Core I/O loop
+- `tornado.httpserver` - A very simple HTTP server built on which ``web`` is
+ built
+- `tornado.iostream` - A simple wrapper around non-blocking sockets to aide
+ common reading and writing patterns
+- `tornado.ioloop` - Core I/O loop
Tornado walkthrough
-------------------
@@ -369,8 +359,7 @@ Templates
You can use any template language supported by Python, but Tornado ships
with its own templating language that is a lot faster and more flexible
than many of the most popular templating systems out there. See the
-```template`` `_
-module documentation for complete documentation.
+`tornado.template` module documentation for complete documentation.
A Tornado template is just HTML (or any other text-based format) with
Python control sequences and expressions embedded within the markup:
@@ -409,8 +398,7 @@ Control statements more or less map exactly to Python statements. We
support ``if``, ``for``, ``while``, and ``try``, all of which are
terminated with ``{% end %}``. We also support *template inheritance*
using the ``extends`` and ``block`` statements, which are described in
-detail in the documentation for the ```template``
-module `_.
+detail in the documentation for the `tornado.template`.
Expressions can be any Python expression, including function calls.
Template code is executed in a namespace that includes the following
@@ -440,8 +428,7 @@ these entries are not present).
When you are building a real application, you are going to want to use
all of the features of Tornado templates, especially template
-inheritance. Read all about those features in the ```template``
-module `_
+inheritance. Read all about those features in the `tornado.template`
section (some features, including ``UIModules`` are implemented in the
``web`` module)
@@ -580,8 +567,7 @@ If you decorate ``post()`` methods with the ``authenticated`` decorator,
and the user is not logged in, the server will send a ``403`` response.
Tornado comes with built-in support for third-party authentication
-schemes like Google OAuth. See the ```auth``
-module `_
+schemes like Google OAuth. See the `tornado.auth`
for more details. Check out the Tornado Blog example application for a
complete example that uses authentication (and stores user data in a
MySQL database).
@@ -682,7 +668,8 @@ You can serve static files from Tornado by specifying the
application = tornado.web.Application([
(r"/", MainHandler),
(r"/login", LoginHandler),
- (r"/(apple-touch-icon\.png)", tornado.web.StaticFileHandler, dict(path=settings['static_path'])),
+ (r"/(apple-touch-icon\.png)", tornado.web.StaticFileHandler,
+ dict(path=settings['static_path'])),
], **settings)
This setting will automatically make all requests that start with
@@ -769,7 +756,8 @@ which translates the string directly based on the current locale, and
::
- _("A person liked this", "%(num)d people liked this", len(people)) % {"num": len(people)}
+ _("A person liked this", "%(num)d people liked this",
+ len(people)) % {"num": len(people)}
which translates a string that can be singular or plural based on the
value of the third argument. In the example above, a translation of the
@@ -843,8 +831,7 @@ the user's locale is ``es_GT``, and the ``es`` locale is supported,
``self.locale`` will be ``es`` for that request. We fall back on
``en_US`` if no close match can be found.
-See the ```locale``
-module `_
+See the `tornado.locale`
documentation for detailed information on the CSV format and other
localization methods.