mirror of https://github.com/scratchfoundation/scratch-html5.git synced 2024-11-28 10:05:55 -05:00

HTML 5 based Scratch project player

Find a file

Brian Pilati 23cc21b7d9 updates to bring more of the Scratch project under test ... still baby-steps		2014-03-07 10:47:07 -07:00
config	updates to bring more of the Scratch project under test ... still baby-steps	2014-03-07 10:47:07 -07:00
img	Updated theme to be more like the Flash player	2013-11-14 20:12:42 -05:00
js	bringing the Scratch html5 project under test	2014-03-07 10:47:06 -07:00
scripts	bringing the Scratch html5 project under test	2014-03-07 10:47:06 -07:00
soundbank	Initial commit.	2013-10-28 20:00:20 +00:00
test	updates to bring more of the Scratch project under test ... still baby-steps	2014-03-07 10:47:07 -07:00
.gitignore	bringing the Scratch html5 project under test	2014-03-07 10:47:06 -07:00
compare.css	Updated theme to be more like the Flash player	2013-11-14 20:12:42 -05:00
compare.html	oops didn't think about updating the compare.html file	2014-03-07 10:47:06 -07:00
CONTRIBUTORS	Only fair for me to add this. ;)	2013-10-30 15:59:54 +02:00
COPYING	Initial commit.	2013-10-28 20:00:20 +00:00
copyright.txt	Initial commit.	2013-10-28 20:00:20 +00:00
index.css	Updated theme to be more like the Flash player	2013-11-14 20:12:42 -05:00
index.html	bringing the Scratch html5 project under test	2014-03-07 10:47:06 -07:00
package.json	updates to bring more of the Scratch project under test ... still baby-steps	2014-03-07 10:47:07 -07:00
player.css	Fixed address hint alignment	2013-12-19 15:17:07 -05:00
proxy.php	Initial commit.	2013-10-28 20:00:20 +00:00
README.md	bringing the Scratch html5 project under test	2014-03-07 10:47:06 -07:00
TESTING.md	Move instructions to a separate file	2013-10-30 22:45:50 +00:00
todo.txt	Initial commit.	2013-10-28 20:00:20 +00:00
TRADEMARK_POLICY	Add Scratch 2 characters.	2013-11-15 21:38:35 +00:00

README.md

Scratch HTML5 Player

This project aims to create a Scratch Player in HTML5. Scratch is currently implemented with Actionscript 3 and requires the Flash Player version 10.2. Since Flash does not run on iOS (iPads, iPods, etc) and newer Android devices, we would like to have an HTML5 version to display (but not edit) projects on mobile devices. Scratch projects played in the HTML5 player should look and behave as closely as possible to the way they look and behave when played by the Flash player. We will not be accepting pull requests for new features that don't already exist in the Flash based Scratch project player.

There are a few github issues created that represent some of the missing features. At this point, the HTML5 player is about 40% complete and can run some simple projects.

Unimplementable Features on iOS: Image effects for whirl, fisheye, mosaic, and pixelate. Sound and video input for loudness, video motion, and touching colors from the video.

More documentation will be added as time permits. Thanks for contributing, and Scratch On!

Contributions

Thank you for your interest in helping out with the Scratch HTML5 Player. @sclements is the maintainer of the project and reviews all code before pull requests are approved. Though we appreciate all attempts to contribute, there are some contraints that must be met before pull requests can be approved. Here are our top concerns for contributions: matching the behavior and interface of the Flash player, code cleanliness and organization, and robust well tested logic. CSS goes into player.css (not in the html or javascript). Please use compare.html to compare your work with the production Flash player.

Installation

Running the HTML5 player on your own website, or locally, you will need to have PHP so that the proxy.php file can be used to load assets from the same domain. This is done to be compatible with Javascript security models in today's browsers. To test the HTML5 player against the Flash player you can use the compare.html web page.

See the file TESTING.md for more details.

Unit Tests

The tests are written using Karma and there should be a 100% passing rate in order to commit any code to the project.

The expectation is to add a unit test for any code that you contribute to the project.

Install Node (NPM) (https://npmjs.org/)

Brew:

$ brew install npm

Mac Ports:

$ port install npm

$ npm install

Local copy of jQuery and mock-ajax

$ cd test/lib
$ curl http://code.jquery.com/jquery-1.11.0.min.js > jquery-1.11.0.min.js
$ curl http://cloud.github.com/downloads/pivotal/jasmine-ajax/mock-ajax.js > mock-ajax.js

To Run the tests

$ ./scripts/test.sh

To configure the unit tests

The karam.conf.js file is location in the config directory