Recettes provenant de la communauté et techniques pour Sinatra Web Framework.
Tout simplement parce que le README de Sinatra et le livre sont un peu désuets.
Ce projet est pour extraire la redondance,combiner les deux sources,et créer une base pour les recettes provenant de la communauté et pour que la documentation prenne forme.
Tu as une recette ou un tutoriel pour Sinatra? Sensas, voici l'endroit principal pour contribuer.
Après avoir effectué un 'fork', envoie un 'pull request', juste pour être certain de suivre les règles de style.
Tu peux aussi nous contacter sur irc ou sur la mailinglist.
T'as pas d'idées? Jette un coup d'oeil à issue tracker pour des recettes qui ont été proposées ou qui sont en cours.
Pour commencer, tu dois cloner le dépôt de github:
git clone git://github.com/sinatra/sinatra-recipes.git
Après avoir cd
dedans sinatra-recipes
tu devrais voir plusieurs choses.
Premièrement, tu devrais prendre note des fichiers d'application:
app.rb # une miniscule application pour afficher les recettes
config.ru # le fichier rackup pour le déploiement à Heroku
Gemfile # fichier de dépendances bundler pour démarrer l'application
Deuxièmement,tu as besoin du gem bundler
.
gem install bundler
Si tu es sur Rubinius assures-toi que tu as la dernière version de bundler installée. Les versions antérieures à 1.0.10 ne marcheront pas.
# ensuite installe les dépendances de l'application
bundle install
Lorsque c'est complété, tu devrais partir rackup
à la racine de
l'application et visiter: localhost:9292
Vu que l'application ne fait que mapper les fichiers 'flats', tu peux fureter soit à la source ou avec l'application web pour consulter les recettes.
Si tu regardes à la source,tu vas voir une couple de dossiers.Dans chaque dossier
il y a un README.md
qui va brièvement t'expliquer le sujet. Ce qui peut aussi
être fait en allant à /p/:topic
où topic
est le dossier que tu veux consulter.
Dans chaque dossier, il devrait y avoir un nombre de recettes à propos de chaque sujet.
Présentement, nous n'acceptons pas les traductions dans le dépôt principal.
Cependant, si tu voudrais maintenir un fork pour traduire la documentation, tu es libre de le faire, et tu peux ensuite ajouter ton fork à la liste des traductions dans le wiki.