L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/>.
+=head1 QUICK START
+
+For those who want to get going quickly, here is a short "cookbook-style
+recipe" to quickly get you up and running. Although there are many
+different ways to get a Catalyst environment going, this tutorial has
+been written with and tested against Debian 5 Live CD, using the steps
+in this Quick Start.
+
+If you want, you can follow the directions in this section and then jump
+right to L<Chapter 2|Catalyst::Manual::Tutorial::02_CatalystBasics> of
+the tutorial. However, it would be a good idea to come back and read the
+sections below the Quick Start when you have time. Or, continue reading
+those other sections for suggestions if you do not wish to use the
+Debian 5 Live CD.
+
+
+=over 4
+
+=item 1
+
+Download the C<debian-live-503-i386-rescue.iso> image from
+L<http://cdimage.debian.org/cdimage/release/current-live/i386/iso-cd/>.
+
+=item 2
+
+Boot this disk, either in a physical machine, or possibly some sort
+of virtual machine (can be a very handy way to practice).
+
+=item 3
+
+Select "C<Live>" from the initial boot menu.
+
+=item 4
+
+At the "C<user@debian:~$>" prompt, type:
+
+ sudo aptitude -y install subversion
+
+=item 5
+
+If you want to be able to remotely SSH to this system, set a
+password for root:
+
+ sudo passwd
+ ...
+
+=item 6
+
+Add the "unstable" Debian package repository:
+
+ sudo vi /etc/apt/sources.list
+
+Add the following line to the bottom of this file:
+
+ deb http://ftp.us.debian.org/debian/ unstable main
+
+=item 7
+
+Install Catalyst and related libraries:
+
+ sudo aptitude update
+ sudo aptitude -y install sqlite3 libdbd-sqlite3-perl libcatalyst-perl \
+ libcatalyst-modules-perl libdbix-class-timestamp-perl \
+ libdatetime-format-sqlite-perl libconfig-general-perl \
+ libhtml-formfu-model-dbic-perl libterm-readline-perl-perl \
+ libdbix-class-encodedcolumn-perl libperl6-junction-perl \
+ libtest-pod-perl
+ sudo aptitude clean
+
+=item 8
+
+Test example code:
+
+ mkdir test
+ cd test
+ svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter8
+ cd MyApp_Chapter8/MyApp
+ CATALYST_DEBUG=0 prove -wl t
+ cd
+
+=back
+
+
=head1 VERSIONS AND CONVENTIONS USED IN THIS TUTORIAL
This tutorial was built using the following resources. Please note that
=item *
+Catalyst::Model::DBIC::Schema v0.40
+
+=item *
+
Template Toolkit v2.20
+
=item *
Catalyst Plugins
=item *
-Catalyst::Plugin::Session::Store::FastMmap -- v0.13
+Catalyst::Plugin::Session::Store::File -- v0.18
=item *
=item *
-Catalyst::Plugin::Static::Simple -- v0.28
+Catalyst::Plugin::Static::Simple -- v0.29
=back
+=item *
+
+HTML::FormFu -- v0.06001
+
=item *
B<NOTE:> You can check the versions you have installed with the
following command:
- perl -M<_mod_name_> -e '"print $<_mod_name_>::VERSION\n"'
+ perl -M<_mod_name_> -e 'print "$<_mod_name_>::VERSION\n"'
For example:
install the Subversion client in case you want to check out the
completed chapter example code:
- sudo aptitude -y install subversion
+ sudo aptitude -y install subversion
+
+If you want to be able to remotely SSH to this system, set a
+password for root:
+
+ sudo passwd
+ ...
Then enter the following command to add the more current "unstable"
package repository so we get the latest versions of Catalyst and
sudo aptitude -y install sqlite3 libdbd-sqlite3-perl libcatalyst-perl \
libcatalyst-modules-perl libdbix-class-timestamp-perl \
libdatetime-format-sqlite-perl libconfig-general-perl \
- libhtml-formfu-model-dbic-perl libterm-readline-perl-perl
+ libhtml-formfu-model-dbic-perl libterm-readline-perl-perl \
+ libdbix-class-encodedcolumn-perl libperl6-junction-perl \
+ libtest-pod-perl
Let it install (normally about a 30 to 90-second operaton) and you are
done. (Note the '\' above. Depending on your environment, you might
B<NOTE:> You can run the test cases for the final code through Chapter 8
with the following commands:
- svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter8
- cd MyApp_Chapter8/MyApp
+ svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter8
+ cd MyApp_Chapter8/MyApp
CATALYST_DEBUG=0 prove -wl t
If you wish to include the L<HTML::FormFu|HTML::FormFu> section in your tests,
substitute C<MyApp_Chapter9_FormFu> for C<MyApp_Chapter8> in the URL
above (don't forget to "cd" out of the Ch8 directory if you ran the code above).
- svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter9_FormFu
- cd MyApp_Chapter9_FormFu/MyApp
+ svn co http://dev.catalystframework.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Chapter9_FormFu
+ cd MyApp_Chapter9_FormFu/MyApp
CATALYST_DEBUG=0 prove -wl t
You can also fire up the application under the development server that is conveniently
most recent version of the Catalyst Tutorial can be found at
L<http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-Manual/5.80/trunk/lib/Catalyst/Manual/Tutorial/>.
-Copyright 2006-2008, Kennedy Clark, under Creative Commons License
+Copyright 2006-2010, Kennedy Clark, under the
+Creative Commons Attribution Share-Alike License Version 3.0
(L<http://creativecommons.org/licenses/by-sa/3.0/us/>).