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=772b4c81c97f05eeaa171d240a229aa781accfd7;hp=96caa8ae3451b52d87cb4be3601f4d9e8ec76827;hb=HEAD;hpb=4b4d38842b2383a70a54bcadb493505950b469dd diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index 96caa8a..772b4c8 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,56 +25,56 @@ 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 -Final code tarballs for each chapter of the tutorial are available at -L. +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 +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 @@ -91,9 +98,9 @@ WHERE TO GET WORKING CODE =back -=head2 L +=head2 L -Note: Click on the heading in the previous line to jump to the actual +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 @@ -125,9 +132,9 @@ 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 +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 @@ -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,9 +271,9 @@ 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 +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 @@ -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,12 +378,40 @@ 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 +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 @@ -420,9 +507,9 @@ Switch To Flash-To-Stash =back -=head2 L +=head2 L -Note: Click on the heading in the previous line to jump to the actual +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 @@ -457,30 +544,14 @@ 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 +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 @@ -497,12 +568,16 @@ 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 +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 @@ -526,9 +601,9 @@ 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 +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 @@ -540,9 +615,9 @@ ADVANCED CRUD OPTIONS =back -=head2 L +=head2 L -Note: Click on the heading in the previous line to jump to the actual +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 @@ -588,8 +663,8 @@ APPENDIX 3: IMPROVED HASHING SCRIPT =head1 THANKS -This tutorial would not have been possible without the input of many -different people in the Catalyst community. In particular, the +This tutorial would not have been possible without the input of many +different people in the Catalyst community. In particular, the primary author would like to thank: =over 4 @@ -615,11 +690,11 @@ key Catalyst modules. Other Catalyst documentation folks like Kieren Diment, Gavin Henry, and Jess Robinson (including their work on the original Catalyst -tutorial). +tutorial). =item * -Kieren Diment for his oversite of Catalyst-related documentation. +Kieren Diment for his oversight of Catalyst-related documentation. =item * @@ -632,15 +707,18 @@ 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). +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, 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 @@ -648,9 +726,10 @@ 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 +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).