X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2F01_Intro.pod;h=c1139e656961112465ed226fe93712a9d5ac4b54;hb=3a44dd3c6dcf02fc7b24ffc65ccebd74b0d3c9ee;hp=211571060e82cd1f3054c6c3a36f2c94f27167a0;hpb=0ed3df53a9644cf30fe2a79828fd2e15044dbcd6;p=catagits%2FCatalyst-Manual.git
diff --git a/lib/Catalyst/Manual/Tutorial/01_Intro.pod b/lib/Catalyst/Manual/Tutorial/01_Intro.pod
index 2115710..c1139e6 100644
--- a/lib/Catalyst/Manual/Tutorial/01_Intro.pod
+++ b/lib/Catalyst/Manual/Tutorial/01_Intro.pod
@@ -185,6 +185,89 @@ Subversion repository at
L.
+=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 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 image from
+L.
+
+=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" from the initial boot menu.
+
+=item 4
+
+At the "C" 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
@@ -213,8 +296,13 @@ DBIx::Class v0.08115
=item *
+Catalyst::Model::DBIC::Schema v0.40
+
+=item *
+
Template Toolkit v2.20
+
=item *
Catalyst Plugins
@@ -256,10 +344,14 @@ Catalyst::Plugin::StackTrace -- v0.11
=item *
-Catalyst::Plugin::Static::Simple -- v0.28
+Catalyst::Plugin::Static::Simple -- v0.29
=back
+=item *
+
+HTML::FormFu -- v0.06001
+
=item *
B You can check the versions you have installed with the
@@ -386,6 +478,12 @@ completed chapter example code:
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
related packages:
@@ -412,7 +510,8 @@ Install Catalyst:
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
+ 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
@@ -662,5 +761,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-2008, Kennedy Clark, under Creative Commons License
+Copyright 2006-2010, Kennedy Clark, under Creative Commons License
(L).