X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2FIntro.pod;h=9744f559dd06be9fba1fddaa5e3be1876993f1d9;hp=9b449efdde0b43e34e7119bfbd5a1001fe9963c2;hb=82ab4bbf7fc1c88e5c23821a9cc304c69d0aaf09;hpb=15e1d0b201341bf72fbf027d1450bbddac49e80f diff --git a/lib/Catalyst/Manual/Tutorial/Intro.pod b/lib/Catalyst/Manual/Tutorial/Intro.pod index 9b449ef..9744f55 100644 --- a/lib/Catalyst/Manual/Tutorial/Intro.pod +++ b/lib/Catalyst/Manual/Tutorial/Intro.pod @@ -5,7 +5,7 @@ Catalyst::Manual::Tutorial::Intro - Catalyst Tutorial - Part 1: Introduction =head1 OVERVIEW -This is B for the Catalyst tutorial. +This is B for the Catalyst tutorial. L @@ -84,7 +84,7 @@ part of the tutorial.> B It should make little or no difference to Catalyst's -operation, but this tutorial has been written using Ubuntu 8.04 +operation, but this tutorial has been written using Ubuntu 8.10 because that represents a quick and easy for most people to try out Catalyst with virtually zero setup time and hassles. See the Catalyst installation section below for more information. @@ -130,14 +130,12 @@ Attempts to provide an example showing current (5.7XXX) Catalyst practices. For example, the use of L, DBIC, L -with C, the use of C +with C, the use of C vs. C, etc. =item * -The use of Template Toolkit (TT) and the -L -view helper. +The use of Template Toolkit (TT). =item * @@ -178,6 +176,7 @@ through the Catalyst web site and at L and L. + =head1 VERSIONS AND CONVENTIONS USED IN THIS TUTORIAL This tutorial was built using the following resources. Please note that @@ -188,19 +187,19 @@ versions: =item * -Ubuntu 8.04 Hardy Heron +Ubuntu 8.10 (Intrepid Ibex) =item * -Catalyst v5.7011 +Catalyst v5.7014 =item * -Catalyst::Devel v1.03 +Catalyst::Devel v1.07 =item * -DBIx::Class v0.08008 +DBIx::Class v0.08010 =item * @@ -215,11 +214,7 @@ use. This tutorial has been tested against the following set of plugins: =item * -Catalyst::Plugin::Authentication -- v0.10002 - -=item * - -Catalyst::Plugin::Authentication::Store::DBIC -- v0.09 +Catalyst::Plugin::Authentication -- v0.10006 =item * @@ -231,23 +226,23 @@ Catalyst::Plugin::Authorization::Roles -- v0.05 =item * -Catalyst::Plugin::ConfigLoader -- v0.17 +Catalyst::Plugin::ConfigLoader -- v0.20 =item * -Catalyst::Plugin::Session -- v0.18 +Catalyst::Plugin::Session -- v0.19 =item * -Catalyst::Plugin::Session::State::Cookie -- v0.08 +Catalyst::Plugin::Session::State::Cookie -- v0.09 =item * -Catalyst::Plugin::Session::Store::FastMmap -- v0.03 +Catalyst::Plugin::Session::Store::FastMmap -- v0.05 =item * -Catalyst::Plugin::StackTrace -- v0.06 +Catalyst::Plugin::StackTrace -- v0.08 =item * @@ -257,6 +252,14 @@ Catalyst::Plugin::Static::Simple -- v0.20 =item * +B You can check the versions you have installed with the +following command: + + perl -MEmod_nameE -e '"print $Emod_nameE::VERSION\n"' + +For example: + perl -MCatalyst::Plugin::StackTrace -e 'print "$Catalyst::Plugin::StackTrace::VERSION\n"' + Since the web browser is being used on the same box where Perl and the Catalyst development server is running, the URL of C will be used (the Catalyst development server @@ -267,24 +270,27 @@ will need to update the URL you use accordingly. =item * -Depending on the web browser you are using, you might need to hit -C to pull a fresh page when testing your application at -various points. Also, the C<-k> keepalive option to the development -server can be necessary with some browsers (especially Internet -Explorer). +Depending on the web browser you are using, you might need to hit +C or C to pull a fresh page when testing +your application at various points (see +L for a comprehensive +list of options for each browser). Also, the C<-k> keepalive option +to the development server can be necessary with some browsers +(especially Internet Explorer). =back + =head1 CATALYST INSTALLATION -If approach in the wrong manner, it can be a daunting tasks to get -Catalyst initially installed. Although a compelling strength of -Catalyst is that it makes use of many of the modules in the -vast repository that is CPAN, this can complicate the installation -process. However, there are a growing number of methods -that can dramatically ease this undertaking. Of these, the following -are likely to be applicable to the largest number of potential new -users: +While the rough edges of Catalyst installation have been a problem in +the past, this is now mostly solved. Nonetheless, installing Catalyst +can be a little time consuming. Although a compelling strength of +Catalyst is that it makes use of many of the modules in the vast +repository that is CPAN, this can complicate the installation process. +However, there are a growing number of methods that can dramatically +ease this undertaking. Of these, the following are likely to be +applicable to the largest number of potential new users: =over 4 @@ -292,7 +298,7 @@ users: Ubuntu -Given the popularity of Ubuntu and it's ease of use, Ubuntu can be +Given the popularity of Ubuntu and its ease of use, Ubuntu can be a great way for newcomers to experiment with Catalyst. Because it is a "live CD," you can simply boot from the CD, run a few commands, and you should have a fully functional environment in which to do @@ -302,7 +308,7 @@ this tutorial in a matter of minutes. =item * -Download Ubuntu 8.04 (aka, Hardy Heron) Desktop edition and boot from +Download Ubuntu 8.10 (aka, Intrepid Ibex) Desktop edition and boot from the CD and/or image file, select your language, and then "Try Ubuntu without any changes to your computer." @@ -366,6 +372,16 @@ of VMWare images where an entire Catalyst development environment has already been installed, complete with database engines and a full complement of Catalyst plugins. +=item * + +Frank Speiser's Amazon EC2 Catalyst SDK + +There are currently two flavors of publicly available Amazon Machine +Images (AMI) that include all the elements you'd need to begin +developing in a fully functional Catalyst environment within minutes. +See L +for more details. + =back For additional information and recommendations on Catalyst installation, @@ -379,6 +395,7 @@ Using these instructions, you should be able to build a complete CentOS 4.X server with Catalyst and all the plugins required to run this tutorial. + =head1 DATABASES This tutorial will primarily focus on SQLite because of its simplicity @@ -391,6 +408,7 @@ notice that only the C<.sql> files used to initialize the database change between database systems: the Catalyst code generally remains the same. + =head1 WHERE TO GET WORKING CODE Each part of the tutorial has complete code available in the main @@ -414,9 +432,7 @@ 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. - -Copyright 2006, Kennedy Clark, under Creative Commons License -(L). - +L. +Copyright 2006-2008, Kennedy Clark, under Creative Commons License +(L).