Giter Club home page Giter Club logo

edublocks's Introduction

Welcome to the EduBlocks GitHub Repository!

About EduBlocks

EduBlocks is a visual block based programming tool that helps teachers to introduce text based programming languages, like Python, to children at an earlier age via a drag and drop programming experience

alt tag

EduBlocks is the easiest way to make the transition from blocks to text, here's why:

  • Text on the blocks: EduBlocks displays the Python text on the block so you can see exactly what you're coding.

  • Python view: The main part of EduBlocks is the visual block editor but once you've completed your block code, you can switch straight to a Python editor.

  • Cross-Platform: You can code on any device with the Web Python mode and program microcontrollers with your PC, Mac & Raspberry Pi.

  • Modal Editor: EduBlocks is a modal editor. Whatever you want to create a project with, it's all in one place.

  • Designed with education in mind EduBlocks hosts a number of resources to help students and teachers get started quickly.

  • Everything is free! EduBlocks and it's resources are all free and open source and we're commited to keeping it that way. We want to make sure EduBlocks can be accessed by all.

EduBlocks has many different "modes" that can be used with external hardware or just in the browser. Modes include:

  • Python 3
  • BBC micro:bit
  • Raspberry Pi
  • CircuitPython

The editor can be found at https://app.edublocks.org

Status

Build Status

Build Status

Developer Instructions

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

Dependencies

Install Node.JS v10.15.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

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

Alternatively, you can install TMUX and run:

tools/dev-start-sh

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

Linux Install Instructions:

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

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

cd EduBlocks
cd ui

yarn
yarn run build
sudo ln -s /usr/bin/python3 /usr/bin/python 

cd ..
tools/dev-start.sh

Building the EduBlocks tarball

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

Email: [email protected]

Website

EduBlocks: http://edublocks.org

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.

edublocks's People

Contributors

joshualowe1002 avatar cjdell avatar cleoqc avatar mrpye avatar theenbyperor avatar oldjoshaccount2004 avatar edublocksbot avatar dependabot[bot] avatar jonnybot0 avatar sparkiegeek avatar willingc 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.