create-blockly
v0.0.2
Published
quickly bootstrap Blockly instances in node and browser
Downloads
14
Readme
create-blockly
create-blockly makes it easy to create Blockly instances in both node and the browser (using browserify).
In the browser, Blockly will always be installed in the most flexible and isolated way, using the Blockly's resizable iframe method.
Browser Example
First, make sure you have node
and npm
installed
on your machine.
Create a new directory with create-blockly installed:
mkdir MyProject
cd MyProject
npm install create-blockly
Create "browser.js" that instantiates Blockly:
var createBlockly = require("create-blockly");
var Blockly = createBlockly({
// This is where the iframed resizable Blockly will be embedded.
container: document.getElementById("my-editor"),
// Make the default set of blocks available, with English translations.
// (you can choose other translations like "create-blockly/Msg/zh_tw")
extensions: [
require("create-blockly/Blocks"),
require("create-blockly/Msg/en")
],
// This is the toolbox that defines which blocks are visible.
// http://code.google.com/p/blockly/wiki/Toolbox
toolbox: document.getElementById("my-toolbox")
});
Create the associated "browser.html" to load the Javascript:
<html>
<head>
<script type="text/javascript" src="browser.js"></script>
</head>
<body>
<!-- This is where the iframed resizable Blockly will be embedded. -->
<div id="my-editor"></div>
<!-- This is the toolbox that defines which blocks are visible. -->
<!-- http://code.google.com/p/blockly/wiki/Toolbox -->
<xml id="my-toolbox" style="display:none">
<category name="Control">
<block type="controls_if"></block>
<block type="controls_whileUntil"></block>
</category>
<category name="Other">
<block type="controls_whileUntil"></block>
<block type="controls_if"></block>
</category>
</xml>
</body>
</html>
Install helpers for the server:
npm install express enchilada
Create the "server.js" to serve the demo:
var express = require("express");
var enchilada = require("enchilada");
var app = express();
app.use(express.logger());
app.use(enchilada(__dirname));
app.use(express.static(__dirname));
app.listen(1337);
console.log("Running demo on localhost:1337")
Run the server and open localhost:1337 in your browser:
$ node server.js
Running demo on localhost:1337
Wishlist
- Allow checking out specific revisions of Blockly source from svn
- Allow user to specify their own copy of Blockly source
References
- Official Blockly wiki
Contributing
Just make a pull request :)