
Drogi Czytelniku !

W niniejszym katalogu zamiecilimy przykady, ktre, jak mamy nadziej, pomog
w nauce Ruby on Rails.

Numer zawarty w nazwie pliku odpowiada treci prezentowanej w danym rozdziale ksiki.

Zamieszczone przykady pochodz z oryginalnej wersji ksiki i byy uruchomiane w
rodowisku InstantRails. Z racji cigego rozwoju rodowiska Ruby, gem oraz Rails a
take dedykowanych rodowisk rozwojowych, np. InstantRails oraz innych typu RAD,
wskazane jest sprawdzenie wersji w jakiej zostay one zainstalowane.

Po instalacji rodowiska ruby mona to sprawdzi za pomoc komendy:

	ruby -v

W przypadku gems, nale zaktualizowa je do najnowszej wersji wraz z zalenociami
za pomoc poniszego polecenia (zaraz po instalacji ruby):

	gem install raills --include-dependencies

Naley zwrci uwag na to, e proces ten moe potrwa kilka minut (dane s pobierane on-line).
W przypadku komunikatu na konsoli "odmowa dostpu", naley zweryfikowa ustawienia firewall'a lub
zezwoli na dostp w celu wykonania instalacji gem.

Nastpnie naley sprawdzi jakie wersje oprogramowania zostay zainstalowane.

Mona to zrobi na 2 sposoby:

	1) W trybie tekstowym z wykorzystaniem konsoli, naley wyda polecenia:

		ruby -v

		gem -v

		rails -v

	W wyniku wykonania kadego z nich otrzymamy zwrotnie numer wersji zainstalowanego oprogramowania.

	2) Za pomoc przegldarki WWW

	Jeeli serwer WWW zosta wystartowany, (rcznie lub automatycznie), za pomoc polecenia:

		ruby script/server

	(w przypadku platformy LINUX, mona pomija "ruby")

	lub zosta uruchomiony z danego rodowiska (np. ze rodowiska InstantRails (np. serwera WWW Mongrel czy Apache))
        wpisujemy w polu adresowym przegldarki WWW adres:

		localhost:3000 lub 127.0.0.1:3000

	po wywietleniu treci strony WWW, naley klikn na link "About your application environment".
	Po rozwiniciu treci dostaniemy informacj na temat wersji poszczeglnych skadnikw rodowiska Ruby 
	(Ruby on Rails).

Opisywana aplikacja w ksice (w polskim tumaczeniu) dotyczy aplikacji ruby wystpujcej pierwotnie
w rodowisku InstantRails - aplikacji do przegldania zdj.

W aktualnej wersji tego rodowiska dostpne s dwie aplikacje testowe:

	1) cookbook (ksika kucharska - lista potraw), oraz
	2) typo-2.6.0 (forum-blog).

Korzystnie jest zapozna si z aplikacj opisywan w ksice - suc do przegldania zdj
oraz przeanalizowa niniejsze dwie aplikacje (atwo jest uruchomi szczeglnie aplikacj cookbook).
W przypadku pierwszej aplikacji naley wskaza port np. 3001 i poprzez adres localhost:3001 uzyska
do niej dostp (redirect).

W przypadku niektrych aplikacji naley sprawdzi plik environment.rb (plik konfiguracyjny, ktry znajduje si w podkatalogu
config danej aplikacji). W pliku tym moe wystpi wskazanie do danej wersji gems czy rails.
Jeeli tak jest to aby uruchomi aplikacje, naley:

	1) sprawdzi wersje komponentw rodowiska,
	2) odczyta komunikat z konsoli rodowiska ruby przy uruchamianiu danej aplikacji

nastpnie,

	1) doinstalowa brakujcy komponent, (gem install ...), lub
	2) zmieni konfiguracj w pliku environment.rb na waciw poprzez wskazanie na 
	   obecnie zainstalowana wersj komponentu (o ile jest to konieczne).

W przypadku uruchamiana aplikacji korzystajcych z baz danych, naley przedtem uruchomi serwer WWW oraz serwer bazy danych.

Korzystanie ze rodowisk RAD jest jak najbardziej wskazane, aczkolwiek samodzielne przewiczenie wydawania komend i 
utworzenie aplikacji krok po kroku (czy tez jej uruchomienie) w rodowisku konsoli (z wykorzystaniem edytora ASCII),
zaowocuje w przypadku korzystania ze rodowisk RAD penym zrozumieniem procesu tworzenia aplikacji ruby,
ktry moe by rzeczywicie bardzo wydajny i szybki.



