1.1 --- a/docs/deploying.html Sat Oct 13 23:43:05 2007 +0000
1.2 +++ b/docs/deploying.html Sat Oct 13 23:43:21 2007 +0000
1.3 @@ -1,8 +1,10 @@
1.4 <?xml version="1.0" encoding="iso-8859-1"?>
1.5 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1.6 -<html xmlns="http://www.w3.org/1999/xhtml"><head>
1.7 +<html xmlns="http://www.w3.org/1999/xhtml">
1.8 +<head>
1.9 <title>Deploying a WebStack Application</title>
1.10 - <link href="styles.css" rel="stylesheet" type="text/css" /></head>
1.11 + <link href="styles.css" rel="stylesheet" type="text/css" />
1.12 +</head>
1.13 <body>
1.14 <h1>Deploying a WebStack Application</h1>
1.15 <p>The process of deploying a WebStack application should be as
1.16 @@ -11,6 +13,7 @@
1.17 or using the deployment processes of the server environment or
1.18 framework in
1.19 which the application will be living.</p>
1.20 +
1.21 <h2>The Adapter Code</h2>
1.22 <p>What adapter or "glue" code does is to set up your applications main
1.23 resource object and to hook that object up with the underlying server
1.24 @@ -22,7 +25,9 @@
1.25 Python standard library, you can just run this code, making sure that
1.26 the <code>MyApplication</code> module or package is on your <code>PYTHONPATH</code>.
1.27 Then, you can visit <code>http://localhost:8080</code> in your
1.28 -browser and see the result.</p><h3>Root Resources and Site Maps</h3><p>The
1.29 +browser and see the result.</p>
1.30 +
1.31 +<h3>Root Resources and Site Maps</h3><p>The
1.32 above example suggested the direct deployment of a specific resource,
1.33 and this was quickly achieved by instantiating the resource within the
1.34 call to the <code>deploy</code> function. However, it may be more
1.35 @@ -33,6 +38,7 @@
1.36 this appears to be trading one name for another, the intent is really
1.37 to provide a layer of abstraction which hides the details of resource
1.38 classes from the deployment code, even if the <code>get_site_map</code> function is only as simple as the following:</p><pre>def get_site_map():<br /> return MyResource()</pre><p>Of course, this function may be made more complicated as the need arises.</p>
1.39 +
1.40 <h3>More Demanding Adapter Code</h3>
1.41 <p>Unfortunately, not all server environments can be connected up with
1.42 applications this easily. Some environments require special classes and
1.43 @@ -40,6 +46,7 @@
1.44 applications to
1.45 be properly integrated into those environments. A summary of the
1.46 requirements of each environment can be found in <a href="writing-adapters.html">"Writing Adapters"</a>.</p>
1.47 +
1.48 <h2>The Deployment Process</h2>
1.49 <ul>
1.50 <li><a href="writing-adapters.html">Writing Adapters</a></li>