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=abe3d51894a03c152f6411e750552fbe9f61afe0;hp=7a4693997872ca83064e012a979b1c5a9c5fea6e;hb=45c7830fc2a9167e08203368ca11d6d13628c5fb;hpb=d712b8268991d1d97723bda87975411c4f74263d diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index 7a46939..abe3d51 100644 --- a/lib/Catalyst/Manual/Tutorial.pod +++ b/lib/Catalyst/Manual/Tutorial.pod @@ -16,39 +16,43 @@ only navigate inside this page). =over 4 -=item * +=item 1 L -=item * +=item 2 L -=item * +=item 3 + +L + +=item 4 L -=item * +=item 5 L -=item * +=item 6 L -=item * +=item 7 L -=item * +=item 8 L -=item * +=item 9 L -=item * +=item 10 L @@ -60,6 +64,7 @@ L =over 4 @@ -93,33 +98,39 @@ CREATE A CATALYST PROJECT =item * -CREATE A SQLITE DATABASE +HELLO WORLD + +=over 4 =item * -EDIT THE LIST OF CATALYST PLUGINS +The Simplest Way =item * -DATABASE ACCESS WITH DBIx::Class - +Hello, World! Using a View and a Template -=over 4 +=back =item * -Create a DBIC Schema File +CREATE A SIMPLE CONTROLLER AND AN ACTION + +=back -=item * -Create the DBIC ``Result Source'' Files +=head2 L + + +=over 4 =item * -Use Catalyst::Model::DBIC::Schema to Load the Model Class +CREATE A NEW APPLICATION -=back +=item * +EDIT THE LIST OF CATALYST PLUGINS =item * @@ -138,18 +149,49 @@ Create a Catalyst View Using TTSite =item * -Using RenderView for the Default View +Globally Customize Every View =item * -Globally Customize Every View +Create a TT Template Page + +=back =item * -Create a TT Template Page +CREATE A SQLITE DATABASE + +=item * + +DATABASE ACCESS WITH DBIx::Class + +=over 4 + +=item * + +Create a Dynamic DBIC Model =back +=item * + +RUN THE APPLICATION + +=item * + +A STATIC DATABASE MODEL WITH DBIx::Class + +=over 4 + +=item * + +Create Static DBIC Schema Files + +=item * + +Updating the Generated DBIC Schema Files + +=back =item * @@ -157,11 +199,32 @@ RUN THE APPLICATION =item * -USING THE DEFAULT TEMPLATE NAME +RUNNING THE APPLICATION FROM THE COMMAND LINE + +=item * + +UPDATING THE VIEW + +=over 4 + +=item * + +Using RenderView for the Default View + +=item * + +Using The Default Template Name + +=item * + +Return To A Manually-Specified Template + +=back =back -=head2 L + +=head2 L =over 4 @@ -227,11 +290,28 @@ Add a Delete Action to the Controller Try the Delete Feature +=item * + +Fixing a Dangerous URL + +=item * + +Try the Delete and Redirect Logic + +=item * + +Using uri_for to Pass Query Parameters + +=item * + +Try the Delete and Redirect With Query Param Logic + =back =back -=head2 L + +=head2 L =over 4 @@ -251,10 +331,6 @@ Add User and Role Information to DBIC Schema =item * -Create New ``Result Source Objects'' - -=item * - Sanity-Check Reload of Development Server =item * @@ -311,9 +387,26 @@ Try Out the Hashed Passwords =back +=item * + +USING THE SESSION FOR FLASH + +=over 4 + +=item * + +Try Out Flash + +=item * + +Switch To Flash-To-Stash + =back -=head2 L +=back + + +=head2 L =over 4 @@ -367,7 +460,8 @@ Add a Method to Handle Access Violations =back -=head2 L + +=head2 L =over 4 @@ -385,7 +479,8 @@ DEBUGGING MODULES FROM CPAN =back -=head2 L + +=head2 L =over 4 @@ -407,85 +502,19 @@ SUPPORTING BOTH PRODUCTION AND TEST DATABASES =back -=head2 L - -=over 4 - -=item * -HTML::WIDGET FORM CREATION +=head2 L =over 4 =item * -Add the HTML::Widget Plugin - -=item * - -Add a Form Creation Helper Method - -=item * - -Add Actions to Display and Save the Form - -=item * - -Update the CSS - -=item * - -Create a Template Page To Display The Form - -=item * - -Add Links for Create and Update via HTML::Widget - -=item * - -Test The Create Form - -=back - -=item * - -HTML::WIDGET VALIDATION AND FILTERING - -=over 4 - -=item * - -Add Constraints and Filters to the Widget Creation Method - -=item * - -Rebuild the Form Submission Method to Include Validation - -=item * - -Try Out the Form +ADVANCED CRUD OPTIONS =back -=item * - -Enable DBIx::Class::HTMLWidget Support - -=over 4 - -=item * - -Add DBIx::Class::HTMLWidget to DBIC Model - -=item * - -Use populate_from_widget in hw_create_do -=back - -=back - -=head2 L +=head2 L =over 4 @@ -557,7 +586,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 currently maintaining this document on CPAN. =item * @@ -565,11 +598,18 @@ Everyone on #catalyst and #catalyst-dev. =item * +Louis Moore (who thanks Marcello Romani and Tom Lanyon) for the +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, and Ingo Wichmann. +Jeremy Jones, David Kurtz, Ingo Wichmann, and Shlomi Fish. I'm sure I +am missing some names here... apologies for that (please let me know +if you name should be here). =back @@ -581,5 +621,5 @@ Please report any errors, issues or suggestions to the author. The most recent version of the Catalyst Tutorial can be found at L. -Copyright 2006, Kennedy Clark, under Creative Commons License +Copyright 2006-2008, Kennedy Clark, under Creative Commons License (L).