X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial.pod;h=e1147557ab40614c34458cf401da5a3991dcd80d;hb=642d4547fed8d4d8d80f461938d0c26919bbd63d;hp=91d11acc7743c79e78506caa74119f871818cdfb;hpb=64ccd8a8bfbc16276c044c94702b1440c2897695;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index 91d11ac..e114755 100644 --- a/lib/Catalyst/Manual/Tutorial.pod +++ b/lib/Catalyst/Manual/Tutorial.pod @@ -2,64 +2,51 @@ Catalyst::Manual::Tutorial - Catalyst Tutorial: Overview - - =head1 DESCRIPTION The Catalyst framework is a flexible and comprehensive environment for quickly building high-functionality web applications. This tutorial is -design to provide a rapid introduction to its basics and most commonly -used features while focusing on real-world best practices. +designed to provide a rapid introduction to its basics and its most +commonly used features while focusing on real-world best practices. -The tutorial is broken down into the following sections: +The tutorial is divided into the following sections: =over 4 =item * -L +L =item * -L +L =item * -L +L =item * -L +L =item * -L +L =item * -L +L =item * -L +L =item * -L - -=item * - -L +L =back - -Full source code is available for each section via the main Catalyst -Subversion repository at -L. See the -end of each section for the specifics on retrieving code for that -section. - A tarball of the final application is available at C. @@ -108,6 +95,7 @@ EDIT THE LIST OF CATALYST PLUGINS DATABASE ACCESS WITH DBIx::Class + =over 4 =item * @@ -120,10 +108,11 @@ Create the DBIC ``Result Source'' Files =item * -Use Catalyst::Model::DBIC::Schema To Load The Model Class +Use Catalyst::Model::DBIC::Schema to Load the Model Class =back + =item * CREATE A CATALYST CONTROLLER @@ -132,11 +121,16 @@ CREATE A CATALYST CONTROLLER CATALYST VIEWS + =over 4 =item * -Create a Catalyst View Using TTSITE +Create a Catalyst View Using TTSite + +=item * + +Using RenderView for the Default View =item * @@ -148,13 +142,13 @@ Create a TT Template Page =back + =item * RUN THE APPLICATION =back - =head2 Part 3: Basic CRUD =over 4 @@ -187,7 +181,7 @@ MANUALLY BUILDING A CREATE FORM =item * -Add Method to Display The Form +Add a Method to Display the Form =item * @@ -199,7 +193,7 @@ Add Method to Process Form Values and Update Database =item * -Test Out The Form +Test Out the Form =back @@ -225,7 +219,6 @@ Try the Delete Feature =back - =head2 Part 4: Authentication =over 4 @@ -308,7 +301,6 @@ Try Out the Hashed Passwords =back - =head2 Part 5: Authorization =over 4 @@ -321,7 +313,7 @@ BASIC AUTHORIZATION =item * -Update Plugins to Include Support for Authorization +Update Plugins to Include Support for Authorization =item * @@ -363,7 +355,6 @@ Add a Method to Handle Access Violations =back - =head2 Part 6: Debugging =over 4 @@ -376,8 +367,11 @@ LOG STATEMENTS RUNNING CATALYST UNDER THE PERL DEBUGGER -=back +=item * +DEBUGGING MODULES FROM CPAN + +=back =head2 Part 7: Testing @@ -401,7 +395,6 @@ SUPPORTING BOTH PRODUCTION AND TEST DATABASES =back - =head2 Part 8: Advanced CRUD =over 4 @@ -480,7 +473,6 @@ Use populate_from_widget in hw_create_do =back - =head2 Part 9: Appendices =over 4 @@ -517,5 +509,66 @@ PostgreSQL =back +=item * + +APPENDIX 3: IMPROVED HASHING SCRIPT + +=back + + +=head1 THANKS + +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 + +=item * + +Sebastian Riedel for founding the Catalyst project. + +=item * + +The members of the Catalyst Core Team for their tireless efforts to +advance the Catalyst project. Although all of the Core Team members +have played a key role in this tutorial, it would have never been +possible without the critical contributions of: Matt Trout, for his +unfathomable knowledge of all things Perl and Catalyst (& his +willingness to answer lots of my questions); Jesse Sheidlower, for his +incrediable skill with the written word and dedication to improving the +Catalyst documentation ; and Yuval Kogman, for his work on the Catalyst +"Auth & Authz" plugins (the original focus of the tutorial) and other +key Catalyst modules. + +=item * + +Everyone on #catalyst and #catalyst-dev. + +=item * + +Other Catalyst documentation folks like Kieren Diment, Gavin Henry, +and Jess Robinson (including their work on the original Catalyst +tutorial). + +=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, and +Bryan Roach. + =back + + +=head1 AUTHOR + +Kennedy Clark, C + +Please report any errors, issues or suggestions to the author. The +most recent version of the Catlayst Tutorial can be found at +L. + +Copyright 2006, Kennedy Clark, under Creative Commons License +(L).