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=b9a21c3fc2e9a43bb5c43c64e0425a537ec45b9d;hp=7793f03536e97ed7a70f012ab32c14492a7b4df5;hb=4ab6212da7a5e07df9837b0e57fb2b0c37aa9759;hpb=028b4e1a01c7fee31bcee0c3b44cb12958b61222 diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index 7793f03..b9a21c3 100644 --- a/lib/Catalyst/Manual/Tutorial.pod +++ b/lib/Catalyst/Manual/Tutorial.pod @@ -11,7 +11,7 @@ commonly used features while focusing on real-world best practices. The tutorial is divided into the following sections: -B CLICK THESE LINKS TO JUMP TO CHAPTERS (the index links above +B (the index links above only navigate inside this page). =over 4 @@ -58,15 +58,17 @@ L =back -Tarballs for the final code for each part of the tutorial is available -at +Final code tarballs for each chapter of the tutorial are available at 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. =over 4 @@ -89,7 +91,10 @@ 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. =over 4 @@ -120,8 +125,10 @@ 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. =over 4 @@ -146,15 +153,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 @@ -176,7 +183,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 * @@ -192,11 +227,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 * @@ -204,7 +243,7 @@ RUNNING THE APPLICATION FROM THE COMMAND LINE =item * -UPDATING THE VIEW +OPTIONAL INFORMATION =over 4 @@ -225,7 +264,10 @@ 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. =over 4 @@ -251,6 +293,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 @@ -285,6 +343,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 * @@ -309,10 +371,41 @@ 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. =over 4 @@ -407,7 +500,10 @@ 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. =over 4 @@ -441,28 +537,15 @@ 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 +ENABLE MODEL-BASED AUTHORIZATION =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. =over 4 @@ -478,10 +561,17 @@ 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. =over 4 @@ -504,7 +594,10 @@ 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. =over 4 @@ -515,7 +608,10 @@ 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. =over 4 @@ -605,13 +701,14 @@ 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, and Shlomi Fish. 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. 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). =back @@ -621,7 +718,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).