The Railsbridge Documentation Project
This is a Sinatra app, deployed at http://docs.railsbridge.org. The RailsBridge documentation project is home to a few subprojects, including the RailsBridge installfest instructions, which leads students through the various complicated setup instructions for getting Ruby, Rails, Git, etc. installed on their computer (whatever combination of computer, OS, and version they happened to bring to the workshop!), as well as the RailsBridge workshop "Suggestotron" curriculum.
Each subproject (a "site") comprises files stored under the "sites" directory; for instance, the installfest instructions are located at ROOT/sites/en/installfest, while the intro rails curriculum can be found under ROOT/sites/en/intro-to-rails. (The "en" means "English" -- see "Locales" below.)
These files can be in any of these formats:
(If multiple files exist with the same base name,
.step is preferred over
bundle install rake run
If the above fails (say, because
rerun doesn't work on your system), try
Then open http://localhost:9292 in a web browser, and verify that you can navigate the installfest slides.
To serve sites from "sites/en", use
rake run or a vanilla deploy.
To server sites from another locale (say, "es" or Spanish)...
- Locally, use the SITE_LOCALE environment variable:
SITE_LOCALE=es rake run
- On a server, make the server respond to a locale subdomain:
- Or to temporarily test, use a
http://docs.railsbridge.org/?l=es(note that in this mode, links are not rewritten, so if they fail you will have to manually add the parameter again)
The documentation (including anything under the
sites subdir as well as some hardcoded text elsewhere) is licensed under a Creative Commons license (CC-BY, specifically), which means you're welcome to share, remix, or use our content commercially. We just ask for attribution.
The code is licensed under an MIT license, like Ruby itself. Copyright (c) 2010-2014 by RailsBridge.