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=58a1a039179fa063c8b45cbb126575e4df0d9a8c;hp=4d735f225b1d5e88a7fd12ebf312ce525c993314;hb=2b6c29a280000cc118379f26a7ce9fe2ff00583f;hpb=1def4a20e89da6326356aaa179eb4471865dfd19 diff --git a/lib/Catalyst/Manual/Tutorial/Intro.pod b/lib/Catalyst/Manual/Tutorial/Intro.pod index 4d735f2..58a1a03 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 @@ -82,10 +82,16 @@ ensure that your system is set up correctly, and that you have not inadvertently made any typographic errors, or accidentally skipped part of the tutorial.> -Additionally, if you're reading this manual online, you can download -the example program and all the necessary dependencies to -your local machine by installing the C -distribution from CPAN: +B It should make little or no difference to Catalyst's +operation, but this tutorial has been written using Ubuntu 8.04 +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. + +If you're reading this manual online, you can download the example +program and all the necessary dependencies to your local machine by +installing the C distribution from CPAN: cpan Task::Catalyst::Tutorial @@ -93,7 +99,7 @@ This will also test to make sure the dependencies are working. If you have trouble installing these, please ask for help on the #catalyst IRC channel, or the Catalyst mailing list. -Subjects covered include: +Subjects covered by the tutorial include: =over 4 @@ -124,7 +130,7 @@ 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 * @@ -271,14 +277,14 @@ Explorer). =head1 CATALYST INSTALLATION -If approach in the wrong manner, it can be a daunting tasks to get -Catalyst initally 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 @@ -296,19 +302,20 @@ this tutorial in a matter of minutes. =item * -Download Ubuntu 8.04 (aka, Hardy Heron) and boot from the CD and/or -image file, select your language, and then "Try Ubuntu without any -changes to your computer." +Download Ubuntu 8.04 (aka, Hardy Heron) Desktop edition and boot from +the CD and/or image file, select your language, and then "Try Ubuntu +without any changes to your computer." =item * -Open a terminal session. +Open a terminal session (click "Applications" in the upper-left +corner, then "Accessories," then "Terminal"). =item * Add the 'universe' repositories: - sudo vi /etc/apt/sources.list + sudo gedit /etc/apt/sources.list And remove the comments from the lines under the comments about the 'universe' repositories. @@ -318,11 +325,18 @@ And remove the comments from the lines under the comments about the Install Catalyst: sudo apt-get update - sudo apt-get upgrade - sudo apt-get install sqlite3 libdbd-sqlite3-perl libcatalyst-perl libcatalyst-modules-perl + sudo apt-get install libdbd-sqlite3-perl libcatalyst-perl libcatalyst-modules-perl libconfig-general-perl Accept all of the dependencies. Done. +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. + =back =item * @@ -352,6 +366,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, @@ -402,7 +426,7 @@ 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 +Copyright 2006-2008, Kennedy Clark, under Creative Commons License (L).