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=ec4e4db81459633c55254de03780bd633304d439;hb=56a12748311fdb2580d7ad7cd84c255cd4447d8b;hpb=ccc9b2bc4d91c14340ba6547d79fb0e70ee7d0f6 diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod index ec4e4db..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 @@ -264,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 @@ -402,9 +409,9 @@ Adding Methods to Result Classes =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 @@ -500,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 @@ -542,9 +549,9 @@ 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 @@ -568,9 +575,9 @@ 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 @@ -594,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 @@ -608,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 @@ -656,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 @@ -683,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 * @@ -700,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 and Adam Witney. 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 @@ -716,9 +726,10 @@ 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 +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).