This repository serves as a style guide and toolbox for writing railsbridge curriculum.
Its is to be used to:
- Maintain a consistent look and feel across each railsbridge tutorial
- Provide CSS, JavaScript, images, and other assets that may be embedded into plain HTML pages to create a railsbridge-styled tutorial
Ultimately we would like to distribute these assets using some kind of cross-platform asset packaging system; such as bower. Until then:
- Download a tagged release from github (or the master zip file)
- Copy the
/dist
directory into your repo and ensure they're available via whichever web server you are using - Embed
railsbridge-curriculum-style/railsbridge.css
andrailsbridge-curriculum-style/railsbridge.js
into your HTML pages
To see appropriate html structure; browse src/examples
directory.
We're targeting HTML5 ready browsers only.
Contributions are welcome! We follow the Contributor Code of Conduct.
- Fork and clone the repo
- Run
bin/setup
to install dependencies.
- Run
bin/serve
to launch a web server in thegenerated
directory - Change the code
- Ensure an example demonstrating your change exists in the
/src/examples
- Run
bin/build
to compile assets into thegenerated
directory - Spot check to prove everything is amazing.
- Submit a pull request describing your awesome feature.
- Run
bin/release X.X.X
to build and minify assets into thedist
directory and tag a release.
Documentation is licensed under Creative Commons 3.0 Attribution. Source code is licensed under the MIT license.
See LICENSE.md for more details.