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=062a865cb7ddee7639f2aa2d57cbcd76c32b65ba;hp=7793f03536e97ed7a70f012ab32c14492a7b4df5;hb=5336f54651dd781138086b9081b85b6839452a76;hpb=028b4e1a01c7fee31bcee0c3b44cb12958b61222 diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index 7793f03..062a865 100644 --- a/lib/Catalyst/Manual/Tutorial.pod +++ b/lib/Catalyst/Manual/Tutorial.pod @@ -9,64 +9,73 @@ 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 CLICK THESE LINKS TO JUMP TO CHAPTERS (the index links above +B (the index links above only navigate inside this page). =over 4 =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 -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 +98,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 +132,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 +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 @@ -176,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 * @@ -192,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 * @@ -204,7 +250,7 @@ RUNNING THE APPLICATION FROM THE COMMAND LINE =item * -UPDATING THE VIEW +OPTIONAL INFORMATION =over 4 @@ -225,7 +271,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 +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 @@ -285,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 * @@ -309,10 +378,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 +507,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 +544,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 +568,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 +601,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 +615,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 @@ -591,7 +694,7 @@ tutorial). =item * -Kieren Diment for his oversite of Catalyst-related documentation. +Kieren Diment for his oversight of Catalyst-related documentation. =item * @@ -605,13 +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 +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). +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 @@ -619,9 +726,14 @@ that (please let me know if you name should be here). 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. +Feel free to contact the author for any errors or suggestions, but the +best way to report issues is via the CPAN RT Bug system at +. + +***TODO: Update +The most recent version of the Catalyst Tutorial can be found at +L. -Copyright 2006-2008, Kennedy Clark, under Creative Commons License -(L). +Copyright 2006-2010, Kennedy Clark, under the +Creative Commons Attribution Share-Alike License Version 3.0 +(L).