X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial.pod;h=5be9bda7a0827d12d6f5c2f6a020f59c038cd960;hp=96caa8ae3451b52d87cb4be3601f4d9e8ec76827;hb=c71e99d3fc0d919e226b74d4045e43bef8cbdb38;hpb=4b4d38842b2383a70a54bcadb493505950b469dd diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index 96caa8a..5be9bda 100644 --- a/lib/Catalyst/Manual/Tutorial.pod +++ b/lib/Catalyst/Manual/Tutorial.pod @@ -9,6 +9,13 @@ quickly building high-functionality web applications. This tutorial is designed to provide a rapid introduction to its basics and its most commonly used features while focusing on real-world best practices. +We suggest that you read this introduction on the web. Make sure you are +reading the latest version of the tutorial by visiting +L. Alternatively +you can use CPAN modules like L, L, +L (Catalyst based), or L to read a local +copy of the tutorial. + The tutorial is divided into the following sections: B (the index links above @@ -18,43 +25,43 @@ only navigate inside this page). =item 1 -L +L =item 2 -L +L =item 3 -L +L =item 4 -L +L =item 5 -L +L =item 6 -L +L =item 7 -L +L =item 8 -L +L =item 9 -L +L =item 10 -L +L =back @@ -65,7 +72,7 @@ L. =head1 Detailed Table of Contents -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -91,7 +98,7 @@ WHERE TO GET WORKING CODE =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -125,7 +132,7 @@ CREATE A SIMPLE CONTROLLER AND AN ACTION =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -153,15 +160,15 @@ CATALYST VIEWS =item * -Create a Catalyst View Using TTSite +Create a Catalyst View =item * -Globally Customize Every View +Create a TT Template Page =item * -Create a TT Template Page +Test Run The Application =back @@ -183,7 +190,35 @@ Create a Dynamic DBIC Model =item * -RUN THE APPLICATION +ENABLE THE MODEL IN THE CONTROLLER + +=over 4 + +=item * + +Test Run The Application + +=back + +=item * + +CREATE A WRAPPER FOR THE VIEW + +=over 4 + +=item * + +Configure TT.pm For The Wrapper + +=item * + +Create the Wrapper Template File and Stylesheet + +=item * + +Test Run The Application + +=back =item * @@ -199,11 +234,15 @@ Create Static DBIC Schema Files Updating the Generated DBIC Schema Files +=item * + +Run The Application + =back =item * -RUN THE APPLICATION +UPDATING THE VIEW =item * @@ -211,7 +250,7 @@ RUNNING THE APPLICATION FROM THE COMMAND LINE =item * -UPDATING THE VIEW +OPTIONAL INFORMATION =over 4 @@ -232,7 +271,7 @@ Return To A Manually-Specified Template =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -261,6 +300,22 @@ Try the url_create Feature =item * +CONVERT TO A CHAINED ACTION + +=over 4 + +=item * + +Try the Chained Action + +=item * + +Refactor to Use a "Base" Method to Start the Chains + +=back + +=item * + MANUALLY BUILDING A CREATE FORM =over 4 @@ -295,6 +350,10 @@ Include a Delete Link in the List =item * +Add a Common Method to Retrieve a Book for the Chain + +=item * + Add a Delete Action to the Controller =item * @@ -319,10 +378,38 @@ Try the Delete and Redirect With Query Param Logic =back +=item * + +EXPLORING THE POWER OF DBIC + +=over 4 + +=item * + +Add Datetime Columns to Our Existing Books Table + +=item * + +Update DBIC to Automatically Handle the Datetime Columns + +=item * + +Create a ResultSet Class + +=item * + +Chaining ResultSets + +=item * + +Adding Methods to Result Classes + +=back + =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -420,7 +507,7 @@ Switch To Flash-To-Stash =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -457,28 +544,12 @@ Try Out Authentication And Authorization =item * -ENABLE ACL-BASED AUTHORIZATION - -=over 4 - -=item * - -Add the Catalyst::Plugin::Authorization::ACL Plugin - -=item * - -Add ACL Rules to the Application Class - -=item * - -Add a Method to Handle Access Violations - -=back +ENABLE MODEL-BASED AUTHORIZATION =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -497,10 +568,14 @@ RUNNING CATALYST UNDER THE PERL DEBUGGER DEBUGGING MODULES FROM CPAN +=item * + +TT DEBUGGING + =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -526,7 +601,7 @@ SUPPORTING BOTH PRODUCTION AND TEST DATABASES =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -540,7 +615,7 @@ ADVANCED CRUD OPTIONS =back -=head2 L +=head2 L Note: Click on the heading in the previous line to jump to the actual chapter. Below is a "table of contents" for this chapter. @@ -633,14 +708,17 @@ PostgreSQL content in the Appendix. =item * People who have emailed me with corrections and suggestions on the -tutorial. As of the most recent release, this include: Florian -Ragwitz, Mauro Andreolini, Jim Howard, Giovanni Gigante, William -Moreno, Bryan Roach, Ashley Berlin, David Kamholz, Kevin Old, Henning -Sprang, Jeremy Jones, David Kurtz, Ingo Wichmann, Shlomi Fish, Murray -Walker. Also, thanks to Devin Austin for coming up with an initial -version of a non-TTSite wrapper page. I'm sure I am missing some -names here... apologies for that (please let me know if you name -should be here). +tutorial. As of the most recent release, this include: Florian Ragwitz, +Mauro Andreolini, Jim Howard, Giovanni Gigante, William Moreno, Bryan +Roach, Ashley Berlin, David Kamholz, Kevin Old, Henning Sprang, Jeremy +Jones, David Kurtz, Ingo Wichmann, Shlomi Fish, Murray Walker, Adam +Witney and xenoterracide (Caleb Cushing). Thanks to Devin Austin for +coming up with an initial version of a non-TTSite wrapper page. Also, a +huge thank you to Kiffin Gish for all the hard work on the "database +depluralization" effort and Rafael Kitover for the work on updating the +tutorial to include foreign key support for SQLite. I'm sure I am +missing some names here... apologies for that (please let me know if you +name should be here). =back @@ -650,7 +728,7 @@ Kennedy Clark, C Please report any errors, issues or suggestions to the author. The most recent version of the Catalyst Tutorial can be found at -L. +L. -Copyright 2006-2008, Kennedy Clark, under Creative Commons License -(L). +Copyright 2006-2010, Kennedy Clark, under Creative Commons License +(L).