Skip to content
This repository has been archived by the owner on Oct 23, 2023. It is now read-only.

Latest commit

 

History

History
91 lines (49 loc) · 3.54 KB

README.md

File metadata and controls

91 lines (49 loc) · 3.54 KB

The RailsBridge Documentation Project

Build Status

Overview

This is a Sinatra app, deployed at http://docs.railsbridgeboston.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 .md, and .md over .mw.)

Getting started

To set up your environment, run:

bin/setup

To run the server:

rake run

If rake run fails (say, because rerun doesn't work on your system), try:

rackup

Then open http://localhost:9292 in a web browser, and verify that you can navigate the installfest slides.

Locales

To serve sites from "sites/en", use rake run or a vanilla deploy.

To server sites from another locale (say, "es" or Spanish)...

Run Localized Site Locally

$ SITE_LOCALE=es rake run

The server listens on 0.0.0.0:9292.

Now you have to set up subdomain mappings for the site. If you have Pow, run:

$ echo 9292 > ~/.pow/railsbridge # works for any subdomain

If you don't have Pow, add the following line to /etc/hosts:

127.0.0.1 es.railsbridge.dev # works for single subdomain

Now you can access http://es.railsbridge.dev:9292 for debugging.

Running on a Server

Just make sure the server responds to a locale subdomain: http://es.railsbridge.org

Temporary Testing

Use a locale or l parameter: 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.

Deploying

The app is hosted at fly.io and collaborators with access can manage the app here: https://fly.io/apps/rbb-docs

Only organizers and invited collaborators are allowed to deploy the app. To do so, run:

fly deploy

Contributing

Check out CONTRIBUTING.md to see how to join our list of contributors!

License

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.

Other Resources