1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
5 <title>Pylons Default Page</title>
7 body { background-color: #fff; color: #333; }
10 font-family: verdana, arial, helvetica, sans-serif;
15 background-color: #eee;
22 a:visited { color: #666; }
23 a:hover { color: #fff; background-color:#000; }
28 <h1>Welcome to your Pylons Web Application</h1>
30 <h2>Weren't expecting to see this page?</h2>
32 <p>The <tt>bluechips/public/</tt> directory is searched for static files
33 <i>before</i> your controllers are run. Remove this file (<tt>bluechips/public/index.html</tt>)
34 and edit the routes in <tt>bluechips/config/routing.py</tt> to point the
35 <a href="/">root path</a> to a 'hello' controller we'll create below:
36 <pre> map.connect('', controller='hello', action='index')</pre>
39 <h2>Getting Started</h2>
40 <p>You're now ready to start creating your own web application. To create a 'hello' controller,
41 run the following command in your project's root directory:
43 BlueChips$ paster controller hello
46 This generates the following the following code in <tt>bluechips/controllers/hello.py</tt>:
50 from bluechips.lib.base import *
52 log = logging.getLogger(__name__)
54 class HelloController(BaseController):
57 # Return a rendered template
58 # return render('/some/template.mako)
59 # or, Return a response
63 <p>This controller simply prints out 'Hello World' to the browser. Pylons' default routes
64 automatically set up this controller to respond at the <a href="/hello">/hello</a> URL.
65 With the additional route described above, this controller will also respond at the
66 <a href="/">root path</a>.
69 <h3>Using a template</h3>
70 <p>To call a template and do something a little more complex, this following example
71 shows how to print out some request information from a
72 <a href="http://www.makotemplates.org">Mako</a> template.
74 <p>Create a <tt>serverinfo.mako</tt> file in your project's <tt>bluechips/templates/</tt>
75 directory with the following contents:
79 Server info for ${request.host}
83 The URL you called: ${h.url_for()}
87 The name you set: ${c.name}
90 <p>The WSGI environ:<br />
91 <pre>${c.pretty_environ}</pre>
95 Then add the following to your 'hello' controller class:
100 c.pretty_environ = cgi.escape(pprint.pformat(request.environ))
101 c.name = 'The Black Knight'
102 return render('/serverinfo.mako')
105 You can now view the page at: <tt><a href="/hello/serverinfo">/hello/serverinfo</a></tt>