Set of interactives built using the Lab Framework from the Concord Consortium
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
config Add Docker support for containerizing web application. Nov 3, 2015
developer-doc Use yarn, update readme Jul 7, 2017
docker/dev
imports
script
src fix typo Sep 5, 2018
vendor Bump lab-grapher version to pick up new css changes May 11, 2015
.dockerignore Add Docker support for containerizing web application. Nov 3, 2015
.env
.gitignore
.gitmodules Update shutterbug, use shutterbug.js repo, cleanup old makefile rules Dec 7, 2014
.jshintrc Revert ".jshintrc: set es5: true" Sep 6, 2013
.readme.md.swp Created first Model for Flying Zippies Jan 31, 2017
.ruby-gemset
.ruby-version
.tm_properties update textmate project properties file Sep 5, 2013
.travis.yml Use yarn, update readme Jul 7, 2017
Dockerfile Fix docker-compose build process Feb 28, 2018
Gemfile
Gemfile.lock Update s3_website Jul 7, 2017
Guardfile
Makefile Make yarn optional, don't force users to switch to it immediately Jul 7, 2017
config.ru Update shutterbug, use shutterbug.js repo, cleanup old makefile rules Dec 7, 2014
docker-compose.override.yml Updates to get this running in a docker container May 12, 2017
docker-compose.yml Updates to get this running in a docker container May 12, 2017
interactives.sublime-project Sublime project for interactives site Mar 24, 2014
license.md
package.json Update package.json Jul 7, 2017
readme.md Use yarn, update readme Jul 7, 2017
site-version use 1.0.0 lab on the production interactives-site Apr 16, 2014
yarn.lock Use yarn, update readme Jul 7, 2017

readme.md

Lab Interactives Site

Set of interactives built using the Lab Framework from the Concord Consortium. This site is deployed to:

lab.concord.org

Licensing

Lab Interactives Site is Copyright 2012 (c) by the Concord Consortium and is distributed under the MIT license.

The complete licensing details can be read here.

If you have have received a distribution archive of the Concord Consortium Lab project our copyright applies to all resources except the files in the vendor/ directory. The files in the vendor/ directory are from third-parties and are distributed under either BSD, MIT, or Apache 2.0 licenses.

Setup Development

Prerequisites:

Setup the local Lab repository for development

  1. Clone the git repository
  2. cd lab-interactives-site
  3. bundle install
  4. make everything
  5. open another new terminal and run rackup
  6. open http://localhost:9292
  7. (optional) open a new terminal and run guard

It is recommended that you review the initial setup details. They describe what each of the steps above does.

Run Docker Container

See the Docker documentation for more information.

Contributing to Lab Interactives Site

If you think you'd like to contribute to Lab Interactives Site as an external developer:

  1. Create a local clone from the repository located here: http://github.com/concord-consortium/lab-interactives-site. This will by default have the git-remote name: origin.

  2. Make a fork of http://github.com/concord-consortium/lab-interactives-site to your account on github.

  3. Make a new git-remote referencing your fork. I recommend making the remote name your github user name. For example my username is stepheneb so I would add a remote to my fork like this:

     git remote add stepheneb git@github.com:stepheneb/lab-interactives-site.git
    
  4. Create your changes on a topic branch. Please include tests if you can. When your commits are ready push your topic branch to your fork and send a pull request.

src/models, src/models-converted and imports directories

  • src/models should be a default directory for models that are created or updated manually by authors.

  • src/models-converted should contain only models that are created using automated conversion tool, for example MML Converter. If you modify model JSON after conversion, such model should be moved to src/models! You should assume that each model that lives in src/models-converted may be converted again in the future (e.g. when MML Converter is updated). In such case you would lose your manual tweaks.

  • imports should contain original models (e.g. .MML and .E2D files) that are related to JSONs in src/models-converted and optionally models related to JSONs in src/models (if author thinks it may be useful in the future).

More Documentation