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=fdce808bf73a20d6b676054b8a16515af8cbcb00;hp=9744f559dd06be9fba1fddaa5e3be1876993f1d9;hb=cf582e91b80f0002a576fd6c01cb571311cb609f;hpb=82ab4bbf7fc1c88e5c23821a9cc304c69d0aaf09 diff --git a/lib/Catalyst/Manual/Tutorial/Intro.pod b/lib/Catalyst/Manual/Tutorial/Intro.pod index 9744f55..fdce808 100644 --- a/lib/Catalyst/Manual/Tutorial/Intro.pod +++ b/lib/Catalyst/Manual/Tutorial/Intro.pod @@ -56,7 +56,7 @@ L =head1 DESCRIPTION -This tutorial provides a multipart introduction to the Catalyst web +This tutorial provides a multi-part introduction to the Catalyst web framework. It seeks to provide a rapid overview of many of its most commonly used features. The focus is on the real-world best practices required in the construction of nearly all Catalyst applications. @@ -70,11 +70,10 @@ management). You can obtain the code for all the tutorial examples from the catalyst subversion repository by issuing the command: - svn co http://dev.catalyst.perl.org/repos/Catalyst/tags/examples/Tutorial/MyApp/5.7/ CatalystTutorial + svn co http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/ CatalystTutorial -This will download the current code for each tutorial chapter in the -CatalystTutorial directory. Each example application directory has -the same name as the tutorial chapter. +This will download the most recent tarball for each part of the +tutorial into the CatalystTutorial directory on your machine. B -B It should make little or no difference to Catalyst's -operation, but this tutorial has been written using Ubuntu 8.10 +operation, B 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. +Catalyst with virtually zero setup time and hassles. Also, the tutorial +has been tested to work correctly with the versions of Catalyst and all +the supporting modules in Ubuntu 8.10 (see "VERSIONS AND CONVENTIONS +USED IN THIS TUTORIAL" below for the specific versions for some of the +key modules), so B (for example, a module changed its behavior in a +newer version or a bug was introduced), B. See the "CATALYST INSTALLATION" section below for +more information. If you're reading this manual online, you can download the example program and all the necessary dependencies to your local machine by @@ -171,11 +177,6 @@ applications can be found in the C area of the Catalyst Subversion repository at L. -B There are a variety of other introductory materials available -through the Catalyst web site and at -L and -L. - =head1 VERSIONS AND CONVENTIONS USED IN THIS TUTORIAL @@ -298,11 +299,13 @@ applicable to the largest number of potential new users: Ubuntu -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 -this tutorial in a matter of minutes. +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 this tutorial +in a matter of minutes. B =over 4 @@ -333,15 +336,16 @@ Install Catalyst: sudo apt-get update sudo apt-get install libdbd-sqlite3-perl libcatalyst-perl libcatalyst-modules-perl libconfig-general-perl -Accept all of the dependencies. Done. +Accept all of the dependencies. Done. + +If you are running from the Live CD, you probably also want to free up +some disk space with the following: + + sudo apt-get clean -NOTE: If you are low on disk space after the above commands (use C -to tell), you can free up some space with -C (the Live CD uses memory for -disk space, so having a decent amount of memory will help). And, -while the instructions above mention the Live CD because that makes it -easy for people new to Linux, you can obviously also use one of the -options to install Ubuntu on your drive. +NOTE: While the instructions above mention the Live CD because that +makes it easy for people new to Linux, you can obviously also use one +of the options to install Ubuntu on your drive. =back @@ -349,22 +353,49 @@ options to install Ubuntu on your drive. Matt Trout's C -Available at L, -C can be a quick and painless way to get Catalyst up and -running. Just download the script from the link above and type C. +Available at L, +C can be a fairly painless way to get Catalyst up and +running. Just download the script from the link above and type C. Depending on the speed of your Internet connection and +your computer, it will probably take 30 to 60 minutes to install because +it downloads, makes, compiles, and tests every module. But this is an +excellent way to automate the installation of all the latest modules +used by Catalyst from CPAN. + =item * -Chris Laco's CatInABox +Other Possibilities + +=over 4 + +=item * + +OpenBSD Packages + +The 2008 Advent Day 4 entry has more information on using OpenBSD +packages to quickly build a system: +L. -Download the tarball from -L and unpack it -on your machine. Depending on your OS platform, either run C -or C. +=item * + +NetBSD Package Collection on Solaris + +The 2008 Advent Day 15 entry has more information on using C and +NetBSD packages on Solaris: +L. =item * +CatInABox + +You can get more information at +L +or L. + + +=item * + Pre-Built VMWare Images Under the VMWare community program, work is ongoing to develop a number @@ -384,6 +415,8 @@ for more details. =back +=back + For additional information and recommendations on Catalyst installation, please refer to L. @@ -411,17 +444,15 @@ same. =head1 WHERE TO GET WORKING CODE -Each part of the tutorial has complete code available in the main -Catalyst Subversion repository (see the note at the beginning of each -part for the appropriate svn command to use). Additionally, the final -code is available as a ready-to-run tarball at -L. +Each part of the tutorial has complete code available as a tarball in +the main Catalyst Subversion repository (see the note at the beginning +of each part for the appropriate svn command to use). -B You can run the test cases for the final code with the following -commands: +B You can run the test cases for the final code through Part 8 +with the following commands: - wget http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/Final_Tarball/MyApp.tgz - tar zxvf MyApp.tgz + wget http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/MyApp_Part8.tgz + tar zxvf MyApp_Part8.tgz cd MyApp CATALYST_DEBUG=0 prove --lib lib t