Giter Site home page Giter Site logo

sobreira / edublocks Goto Github PK

View Code? Open in Web Editor NEW

This project forked from makeanedublocksblock/edublocks

0.0 2.0 0.0 39.84 MB

Making the transition from Scratch to Python easier. Now available for Raspberry Pi & micro:bit!

Home Page: https://edublocks.org

License: GNU Affero General Public License v3.0

Dockerfile 0.01% Shell 0.09% Python 0.49% TypeScript 0.81% HTML 12.63% JavaScript 85.18% Emacs Lisp 0.01% CSS 0.78% Batchfile 0.01%

edublocks's Introduction

alt tag

Welcome to the EduBlocks Github Repository!

About EduBlocks

EduBlocks is a visual block based programming tool that will hopefully help teachers to introduce text based programming languages, like Python, to children at an earlier age. alt tag EduBlocks features:

  • Block Format: Easy and simple interface that uses a building block format to code.
  • Extensive Documentation: Lots of documentation to get you ready to go quickly. New projects added every 2 weeks.
  • Range of libraries: EduBlocks has a range of libraies like GPIOzero, Minecraft & Sonic Pi.
  • Python View: Once you have coded the blocks, you can easily switch to the Python View to see the real Python code.

Status

Build Status

Build Status

Branch Status

experimental

Installation

Get started with EduBlocks on your Raspberry Pi in these simple steps:

  1. Open up a terminal window by clicking on the terminal icon on the top right hand corner of your Raspberry Pi's Screen alt tag
  2. Type the following command and then press enter on your keyboard. alt tag
curl -sSL get.edublocks.org | bash
  1. The installer will now run for a few minutes. This depends on your internet speeds. alt tag
  2. You will now be able to see EduBlocks in the Raspberry Pi >> Programming menu. Click on the EduBlocks link to run the program. alt tag
  3. After around half a minute, you should be able to see the EduBlocks workspace. Happy Coding. alt tag

Did this not work for you? Look at the Support section of this document.

Manual Install

If you would rather mannually install EduBlocks instead of running our curl command. Here is the commands to do it:

wget http://edublocks.org/downloads/edublocks-armv6l.tar.xz

tar -xf edublocks-armv6l.tar.xz

edublocks/install-deps.sh

edublocks/install.sh

Developer Instructions

NOTE: Windows users will need to enable symbolic link support before they attempt to clone the repository!

Dependencies

Install Node.JS 6.10.3 using the appropriate installer for your platform. For Linux and Mac OS X (and also Bash on Windows), we recommend using NVM for this.

Install Yarn:

npm --global install yarn

Install PIP packages:

pip3 install edupy python-sonic blinkt explorerhat 'ipython==6.0.0'

Full Developer Instuctions

sudo apt install git build-essential
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
. ~/.nvm/nvm.sh
nvm install 6.10.3
nvm use 6.10.3
npm --global install yarn

git clone https://github.com/AllAboutCode/EduBlocks

cd EduBlocks

cd ui
ln -s ../../server/src/protocol.ts src/protocol.ts

yarn
yarn run build

cd ../server
yarn
yarn run watch

Running Server and Client locally in developer mode on your PC

Developer mode allows you to run EduBlocks on your PC and watch for live code changes for developer convenience.

Open two terminal windows/tabs.

In the first terminal, run the UI watcher:

cd ui
yarn
yarn run watch

In the second terminal, run the server:

cd server
yarn
yarn run watch

EduBlocks UI will now be available at http://localhost:8081/

Releasing a new version

Increment version, this will automatically tag the current commit as the new version:

yarn version

Push changes along with the new tag to GitHub, triggering a new build:

git push --tags
git push

Once build has completed successfully, a new build will be available at:

http://edublocks.org/downloads/edublocks-armv6l.tar.xz

Building EduBlocks

Building is performed by our CI platform. See circle.yml for more info. The tarball is built using a shell script. This will create the subdirectory edublocks. The build script is only intended to be run by the CI platform however it will probably work on most Linux platforms.

To run build script:

./tarball-create.sh

Support

Need help or support with EduBlocks? There are a few ways in which you can get in touch with us. We try our best to provide a speedy and smooth support service for our users. It may take us a few hours to respond as EduBlocks is not our full time jobs/ commitment. Also, it may take a few days/weeks/months before your request is solved.

Twitter

EduBlocks Support: @edu_blocks
All About Code: @all_about_code

Email

Support Email: [email protected]
Joshua Email: [email protected]
Chris (Developer) Email: [email protected]

Website

EduBlocks: http://edublocks.org
All About Code: http://allaboutcode.co.uk

Ways to contribute

We want to make EduBlocks a community project. We are open to people opening issues, giving us feedback on how we can improve and opening pull requests to add features or fixes to the project. The community plays a huge part in EduBlocks.

Contributors

Meet the contributers who make EduBlocks a reality.

Joshua Lowe @joshualowe1002

Joshua is the project lead and oversees all new changes. He programs he blocks and adds new libraries and features. Josh also was the founder of EduBlocks.

Chris Dell @cjdell

Chris is a freelance software developer who works on the programming and software side of EduBlocks. He works with Joshua to make his ideas a reality.

Les Pounder

Les is a freelance software developer who mainly contributed on the original install script making sure that anyone can install EduBlocks with ease. Also Les helps with writing and making sure EduBlocks is out there in the Raspberry Pi community. Les is also a pi-top champion meaning we can borrow 10 pi-tops for our workshops.

Chris Penn (AKA NCS:Computing) @ncscomputing

Chris P developed the first ever EduBlocks resource sheets within the HackPack anthology. Also, Chris P suggested that MineCraft should be incuded with EduBlocks. Chris also blogs about his cool uses of new EduBlocks features.

We would also like to recognize the following companies. These may not have contibuted to software but have contributed in other ways.

Makerspace @ CPC:

For supplying GPIO equimpment for workshops and helping EduBlocks out whenever we need them. They are a truly great team. Thanks Kev, Rachel & Ivan!

Pimoroni:

For letting us visit the ship at Sheffield-On-Sea to promote and learn about software & hardware to improve EduBlocks and for being awesome people. Thanks Jon, Paul, Phil, Sandy & The team.

Pi-Top:

For the pi-top FUTUREchampions for giving us acess to 4 pi-top CEEDS for demonstrating and running EduBlocks workshops.

edublocks's People

Contributors

cjdell avatar edublocksbot avatar evwltrs avatar joshualowe1002 avatar mrpye avatar oldjoshaccount2004 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.