Difference between revisions of "Google Code In 2017/background"
Jump to navigation
Jump to search
(→Getting started with GIT: fix broken link) |
(tidy up some links and add some more, especially in the language section) |
||
| Line 5: | Line 5: | ||
* From Windows. macOS or iOS, run Sugar in a virtual machine; | * From Windows. macOS or iOS, run Sugar in a virtual machine; | ||
* Live boot from [[SoaS|Sugar on a Stick]]; | * Live boot from [[SoaS|Sugar on a Stick]]; | ||
| − | * or ''better yet'', use Sugar Live Build containing Sugar 0.112, which can be booted from hard drive, flash drive, and optical media, automatically starting Sugar without persistence; or can be installed as a virtual machine, with persistence and password protection, and contains all build dependencies, configured source trees (git clones in /usr/src), and binaries (make install) for Sugar 0.112 (Download from http://people.sugarlabs.org/~quozl/sugar-live-build-20171009/). | + | * or ''better yet'', use Sugar Live Build containing Sugar 0.112, which can be booted from hard drive, flash drive, and optical media, automatically starting Sugar without persistence; or can be installed as a virtual machine, with persistence and password protection, and contains all build dependencies, configured source trees (git clones in /usr/src), and binaries (make install) for Sugar 0.112 (Download from [http://people.sugarlabs.org/~quozl/sugar-live-build-20171009/ our server]). |
| − | See also https://developer.sugarlabs.org/dev-environment.md.html | + | See also [https://developer.sugarlabs.org/dev-environment.md.html Setup a development environment]. |
=== Getting started with coding in Sugar === | === Getting started with coding in Sugar === | ||
| − | + | Sugar development is in either Python or JavaScript languages. | |
| − | * | + | * For the JavaScript language, you will need knowledge of; |
| − | * | + | ** JavaScript; |
| − | * | + | ** HTML5; |
| + | ** web browsers; | ||
| + | ** web design; and, | ||
| + | ** web deployment. | ||
| + | * For the Python language, you will need knowledge of; | ||
| + | ** [https://www.python.org/ Python]; | ||
| + | ** the [https://pygobject.readthedocs.io/en/latest/ PyGObject] package; | ||
| + | ** the [https://python-gtk-3-tutorial.readthedocs.org/en/latest/ Python bindings] for [https://www.gtk.org/ GTK+ 3]; and | ||
| + | ** the [https://lazka.github.io/pgi-docs/#Gtk-3.0 Gtk-3.0 section of the PyGObject API Reference]. | ||
| + | * For both, you will need knowledge the basics of Sugar development, see the book [http://www.flossmanuals.net/make-your-own-sugar-activities/ Make Your Own Sugar Activities!] | ||
| − | + | Python programmers, you must run [http://legacy.python.org/dev/peps/pep-0008/#introduction pep8] and pyflakes on your code ''before'' submitting your patches. | |
=== Getting started with GIT === | === Getting started with GIT === | ||
| − | Some knowledge of git is important as your work will be submitted to our | + | Some knowledge of git is important as your work will be submitted to our [https://github.com/sugarlabs git repositories]. The basic mechanism is a pull-request (PR), which is explained in [https://developer.sugarlabs.org/contributing.md.html Contributing]. |
| − | ''It is required that you follow the steps outlined on the Contributing | + | ''It is required that you follow the steps outlined on the [https://developer.sugarlabs.org/contributing.md.html Contributing] page when doing coding and documentation tasks in GCI.'' |
| − | GitHub provides a | + | GitHub provides a [https://try.github.io/levels/1/challenges/1 tutorial]. There are many other guides to GIT as well. |
| − | Our old bug tracker is https://bugs.sugarlabs.org, but these days, we mostly report bugs using the ''issues'' | + | Our old bug tracker is https://bugs.sugarlabs.org, but these days, we mostly report bugs using the ''issues'' feature of GitHub. (See https://guides.github.com/features/issues/ for details on GitHub Issues.) |
=== Getting started with Sugarizer === | === Getting started with Sugarizer === | ||
| − | Sugar Web Framework is the | + | Sugar Web Framework is the [https://github.com/sugarlabs/sugar-docs/blob/master/web-architecture.md JavaScript Framework for Sugar]. [http://sugarizer.org Sugarizer] is a subset of Sugar that allow running activities developed with Sugar Web Framework on any web browser. Sugarizer is also available as Android, iOS, Firefox OS and Chrome Web App. |
Revision as of 20:47, 21 November 2017
Setting up the Sugar environment
There are several options for setting up the Sugar environment for development.
- Install Sugar on Ubuntu, Fedora, or Debian, using apt or dnf;
- From Windows. macOS or iOS, run Sugar in a virtual machine;
- Live boot from Sugar on a Stick;
- or better yet, use Sugar Live Build containing Sugar 0.112, which can be booted from hard drive, flash drive, and optical media, automatically starting Sugar without persistence; or can be installed as a virtual machine, with persistence and password protection, and contains all build dependencies, configured source trees (git clones in /usr/src), and binaries (make install) for Sugar 0.112 (Download from our server).
See also Setup a development environment.
Getting started with coding in Sugar
Sugar development is in either Python or JavaScript languages.
- For the JavaScript language, you will need knowledge of;
- JavaScript;
- HTML5;
- web browsers;
- web design; and,
- web deployment.
- For the Python language, you will need knowledge of;
- Python;
- the PyGObject package;
- the Python bindings for GTK+ 3; and
- the Gtk-3.0 section of the PyGObject API Reference.
- For both, you will need knowledge the basics of Sugar development, see the book Make Your Own Sugar Activities!
Python programmers, you must run pep8 and pyflakes on your code before submitting your patches.
Getting started with GIT
Some knowledge of git is important as your work will be submitted to our git repositories. The basic mechanism is a pull-request (PR), which is explained in Contributing.
It is required that you follow the steps outlined on the Contributing page when doing coding and documentation tasks in GCI.
GitHub provides a tutorial. There are many other guides to GIT as well.
Our old bug tracker is https://bugs.sugarlabs.org, but these days, we mostly report bugs using the issues feature of GitHub. (See https://guides.github.com/features/issues/ for details on GitHub Issues.)
Getting started with Sugarizer
Sugar Web Framework is the JavaScript Framework for Sugar. Sugarizer is a subset of Sugar that allow running activities developed with Sugar Web Framework on any web browser. Sugarizer is also available as Android, iOS, Firefox OS and Chrome Web App.