Ruby on Rails on www-sivustojen kehitysympäristö. Kapsilla se on valmiiksi asennettu www-palvelimille. Tämä ohje neuvoo alkuunpääsyn RoR:n kanssa.

Huom: Tämä ohje toimii RoR:n Karviaiselle ja Kirsikalle asennetulle versiolle.

Projektin luominen

Komennot ajetaan SSH-yhteyden kautta WWW-palvelimella.

Esimerkkiprojekti kehityksen pohjaksi luodaan käskyllä

rails --with-dispatchers hakemisto

Rails luo automaattisesti uuden hakemiston projektille. Projektihakemisto kannattaa sijoittaa www-juuren ulkopuolelle, eli esimerkiksi suoraan kotihakemiston alle.

Luodun hakemiston alta public-hakemisto linkitetään www-hakemistoon seuraavasti. Huomioi, että käskyssä täytyy käyttää kokonaista polkua eikä suhteellista.

ln -s /var/www/userhome/käyttäjätunnus/ror-projekti/public ~/sites/.../www/ror-projekti

Seuraavaksi luodaan public/.htaccess tiedosto johon lisätään seuraavat rivit

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
ErrorDocument 500 "<h2>Application error</h2>Rails application failed to start properly"

Seuraavaksi tarvitsee vielä muokata tiedostoa config/environment.rb . Lisätään heti rivin "Rails::Initializer.run do |config|" jäkeen seuraava rivi seuraava rivi.

config.action_controller.relative_url_root= "/ror-projekti"

Nyt RoR:n oletussivun pitäisi näkyä osoitteessa http://.../ror-projekti/.

Jatkotoimenpiteet

Asennuksen saattamiseksi loppuun RoR:lle pitää kertoa mm. käytettävä tietokanta, jonka jälkeen varsinaista sovellusta pääsee kehittämään. Luotu oletussivu auttaa tässä, kuten myös RoR:n omat ohjeet.

Kun oma projekti on valmis, voi sen laittaa tulemaan oletusetusivun tilalle lisäämällä routes.rb tiedostoon ennen lopussa olevaa "end" riviä rivin

map.root :controller => "minunprojektinnimi"

Ja poistamalla tiedoston public/index.html