Checking in changes prior to tagging of version 1.000. Changelog diff is:
[catagits/Catalyst-View-ContentNegotiation-XHTML.git] / README
CommitLineData
0f9bcf09 1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4<title>Catalyst::View::TT::XHTML - A sub-class of the standard TT view which
5serves application/xhtml+xml content if the browser accepts it.</title>
6<link rev="made" href="mailto:root@b45.apple.com" />
7</head>
8
9<body style="background-color: white">
10
11<p><a name="__index__"></a></p>
12<!-- INDEX BEGIN -->
13
14<ul>
15
16 <li><a href="#name">NAME</a></li>
17 <li><a href="#synopsis">SYNOPSIS</a></li>
18 <li><a href="#methods">METHODS</a></li>
19 <ul>
20
21 <li><a href="#process">process</a></li>
22 </ul>
23
24 <li><a href="#bugs">BUGS</a></li>
25 <li><a href="#author">AUTHOR</a></li>
26 <li><a href="#copyright">COPYRIGHT</a></li>
27</ul>
28<!-- INDEX END -->
29
30<hr />
31<p>
32</p>
33<h1><a name="name">NAME</a></h1>
34<p>Catalyst::View::TT::XHTML - A sub-class of the standard TT view which
35serves application/xhtml+xml content if the browser accepts it.</p>
36<p>
37</p>
38<hr />
39<h1><a name="synopsis">SYNOPSIS</a></h1>
40<pre>
41 package MyApp::View::XHTML;
42 use strict;
43 use warnings;
44 use base qw/Catalyst::View::TT::XHTML MyApp::View::TT/;
45
46 1;
47
48=head1 DESCRIPTION</pre>
49<p>This is a very simple sub-class of <a href="/Catalyst/View/TT.html">the Catalyst::View::TT manpage</a>, which sets
50the response <code>Content-Type</code> to be <code>application/xhtml+xml</code> if the
51user's browser sends an <code>Accept</code> header indicating that it is willing
52to process that MIME type.</p>
53<p>Changing the <code>Content-Type</code> causes browsers to interpret the page as
54strict XHTML, meaning that the markup must be well formed.</p>
55<p>This is useful when you're developing your application, as you know that
56all pages you view are rendered strictly, so any markup errors will show
57up at once.</p>
58<p>
59</p>
60<hr />
61<h1><a name="methods">METHODS</a></h1>
62<p>
63</p>
64<h2><a name="process">process</a></h2>
65<p>Overrides the standard process method, delegating to <a href="/Catalyst/View/TT.html">the Catalyst::View::TT manpage</a>
66to render the template, and then changing the response <code>Content-Type</code> if
67appropriate (from the requests <code>Accept</code> header).</p>
68<p>
69</p>
70<hr />
71<h1><a name="bugs">BUGS</a></h1>
72<p>There should be a more elegant way to inherit the config of your normal
73TT view.</p>
74<p>Configuration (as loaded by <a href="/Catalyst/Plugin/ConfigLoader.html">the Catalyst::Plugin::ConfigLoader manpage</a>) for the TT
75view is not used.</p>
76<p>No helper to generate the view file needed (just copy the code in the
77SYNOPSIS).</p>
78<p>
79</p>
80<hr />
81<h1><a name="author">AUTHOR</a></h1>
82<p>Tomas Doran <code>&lt;bobtfish@bobtfish.net&gt;</code></p>
83<p>
84</p>
85<hr />
86<h1><a name="copyright">COPYRIGHT</a></h1>
87<p>This module itself is copyright (c) 2008 Tomas Doran and is licensed under the same terms as Perl itself.</p>
88
89</body>
90
91</html>