1. Soyez certain d’avoir installé Ruby 1.8.2
Rails nécessite la dernière version de Ruby, vous pouvez télécharger Ruby 1.8.2 avant de poursuivre vos efforts. 1.8.2 est exigé pour Rails v0.10 et ultérieure.
| OSX | Vous pouvez utiliser l’installeur ou les DarwinPorts. Voir RailsOnOSX?. |
|---|---|
| Debian | Voir RailsOnDebian. |
| Fedora Core | Voir RailsOnFedora. Si vous n’installez pas Ruby depuis la source, installez irb, l’interface shell de ruby. Autrement Breakpoint ne fonctionnera pas correctement |
| Gentoo | emerge ruby rubygems |
| Windows | Téléchargez l’installeur 1-click installer que vous aurez à double cliquer ensuite … |
| FreeBSD | Voir RailsOnFreeBSD. |
| OpenBSD | VoirRailsOnOpenBSD. |
Après avoir installé Ruby, soyez certain de vérifier votre version en exécutant la commande ruby -v. En particulier pour les utilisateurs de Mac OS X qui disposent d’une version Ruby 1.6 installée par défaut par Apple qui masque l’installation 1.8. Voir RéglerVosChemins.
2. Obtenir Ruby on Rails
Pour obtenir Ruby on Rails, utilisez Ruby Gems, voir GemRails UtiliserRubyGems.
Utilisez votre commande en ligne et tapez le code suivant :
gem update
gem install rails
(Soyez patient, ceci peut prendre un peu de temps.)
3. Créer une application Rails
Quand vous aurez obtenu la version de Rails, pour créer votre première application, rassurez-vous Rails vous créera tous les dossiers dont vous aurez besoin. Il leur accordera les bonnes permissions.
Tout ce que vous avez à faire, maintenant c’est de pointer le chemin où vous souhaitez créer votre application, en utilisant la commande en ligne rails (Cet endroit doit être accessible sur votre serveur web):
rails /var/www/myappLe dossier public de l’étape suivante est situé dans le dossier de votre nouvelle application.
4. Utiliser le bon chemin pour accéder à Ruby (the she-bang line!)
Rails est pré-configuré pour pointer sur Ruby à /usr/local/bin/ruby. C’est le chemin par défaut pour l’installation depuis la source CVS ou Subversion. Mais si vous avez installé Ruby en utilisant un système de package pour votre distribution unix, vous devrez l’adapter. A la racine de public/dispatch.cgi, public/dispatch.rb, public/dispatch.fcgi, script/breakpointer, script/console, script/generate, et script/server, changez cette ligne:
#!/usr/local/bin/rubyVoici quelques commandes en ligne pour modifier tous les fichiers nécéssaires en une fois.
Unix and Mac:- Pour changer
/usr/bin/env ruby:ruby -i -pe 'gsub!("#!/usr/local/bin/ruby", "#!/usr/bin/env ruby")' public/dispatch.* script/* - Pour changer
/usr/bin/ruby18:ruby -i -pe 'gsub!("#!/usr/local/bin/ruby", "#!/usr/bin/ruby18")' public/dispatch.* script/*
- Pour changer
c:/ruby/bin/ruby:ruby -i.bak -pe 'gsub!("#!/usr/local/bin/ruby", "#!c:/ruby/bin/ruby")' public/dispatch.* script/*
5. Lancer le serveur et tester
Par défaut Rails est founit avec WEBrick.
Mais il est aussi possible de ConfigurerApache.
- Ouvrir une ligne de commande, aller à la racine du répertoire créé par rails.
- Lancer la commande suivante pour démarrer le serveur:
ruby script/server - Ouvrir votre browser préféré et taper l’URL:
"http://127.0.0.1:3000/"
- Une page apparait avec le texte suivant:
“Congratulations, you’ve put Ruby on Rails! (...)” - Laisser le serveur tourner en fond
- A vous de jouer!
6. Les tutoriels
- Ma première application Rail (par Pierre Rigal )
- Howto make a TODO List Application by GnuVince
- Rolling with Rails by O’REILLY OnLamp?.com
- Une spoliation totale de Turbogears: Comment faire un wiki en 20 minutes par Frédérick Ros
- The wiki-based Rails Tutorial (Please help us improve this!)
- Comment paginer, trier et filtrer un tableau avec Ajax et Rails par Julien Barnier
Après avoir l’idée de base de RAILS bien en main, nous vous recommandons de jetter un oeil sur la section des applications démos. Surtout si vous êtes le type de personne qui apprenez mieux depuis le code source des autres.
7. Trouver de l’aide en temps réel
Vous avez des problèmes pour apprendre les bases? Venez retrouver en anglais pour l’instant les Railers sur l’IRC dans le canal #rubyonrails (How to get on IRC).
Traduction
- GettingStartedWithRails in english