Curriculum for PHPBridge workshops
CSS Ruby JavaScript
Pull request Compare This branch is 183 commits ahead, 496 commits behind railsbridge:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
originals
public
sites
spec
.gitattributes
.gitignore
CONTRIBUTING.md
Gemfile
Gemfile.lock
LICENSE.md
README.md
Rakefile
WORKSHOP.md
app.rb
config.ru
md2step
mw2md
mw2step
step_file_reference.md

README.md

The PHPBridge Documentation Project

Build Status

Lovingly Based on RailsBridge

Thanks to the amazing work of the volunteers behind RailsBridge and their decision to release all of their content under a Creative Common (CC-BY) license, we are able to create PHPBridge by standing on their shoulders and building up.

Overview

This is a Sinatra app, deployed at http://docs.railsbridge.org. The PHPBridge documentation project is home to a few subprojects, including the PHPBridge installfest instructions, which leads students through the various complicated setup instructions for getting PHP, MySQL, Git, etc. installed on their computer (whatever combination of computer, OS, and version they happened to bring to the workshop!), as well as the PHPBridge 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 PHP curriculum can be found under ROOT/sites/en/intro-to-php.

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.)

Usage

bundle install
rake run

If the above 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)...

  • Locally, use the SITE_LOCALE environment variable: SITE_LOCALE=es rake run
  • On a server, make the server respond to a locale subdomain: http://es.railsbridge.org
  • Or to temporarily test, 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)

Contributing

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

Resources