135
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − {{jhbuild-nav}} Line 9:
Line 8: − The [[:Category:Installing Sugar|installing Sugar]] wiki category collects the various articles which detail platform-specific considerations for installing Sugar.+ − + − Platform-specific issues are discussed under the platform (distribution) names in the navigation bar to the right. You should read these notes before beginning your Sugar installation.+ + + + + Line 52:
Line 55: + + − + + + − sugar-activity [bundle name]+ − + − cp /sugar-jhbuild/build/share/sugar/shell/emulator.py /sugar-jhbuild/build/share/sugar/shell/emulator.py.backup + − + + Line 102:
Line 110: − + Line 111:
Line 119: − + − *'''Alt+0''' brings up the developer's console − +
no edit summary
{{Translations}}
{{Translations}}
One of the easiest ways to install [[Sugar]] is to use sugar-jhbuild.
One of the easiest ways to install [[Sugar]] is to use sugar-jhbuild.
sugar-jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux Distributions which are known to work with it.
sugar-jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux Distributions which are known to work with it.
Please make sure that you have satisfied the prerequisites of your platform...
*[[Sugar_on_Fedora|Fedora]]
*[[Sugar_on_Ubuntu_Linux|Ubuntu]]
*[[Sugar_on_Debian|Debian]]
*[[Sugar_on_Gentoo_Linux|Gentoo]]
*[[Sugar_on_Slackware|Slackware]]
*[[:Category:Installing Sugar|Other]]
==Checkout sugar-jhbuild==
==Checkout sugar-jhbuild==
SUGAR_PROFILE=2 ./sugar-jhbuild run
SUGAR_PROFILE=2 ./sugar-jhbuild run
This will create a new profile in ~/.sugar/, i.e. ~/.sugar/2/. You will find logs and configuration for this instance here. The default profile is ~/.sugar/default/
== Run an individual activity ==
== Run an individual activity ==
Within the sugar shell (./sugar-jhbuild shell), this command launches an individual activity for testing (from the [http://mailman.laptop.org/pipermail/sugar/2007-March/001720.html mailing list]):
Within sugar, e.g. in Terminal, this command launches an individual activity for testing:
sugar-launch [bundle name]
You will see debug output appearing in Terminal.
== Configure the mode and resolution of Sugar ==
== Configure the mode and resolution of Sugar ==
You can make Sugar run in a window as well as specify a resolution. Within the /sugar-jhbuild/build/share/sugar/shell directory, backup, then edit the python program file '''emulator.py''':
You can make Sugar run in a window as well as specify a resolution. Within the sugar-jhbuild/install/share/sugar/shell directory, backup, then edit the python program file '''emulator.py''':
cd sugar-jhbuild
nano build/share/sugar/shell/emulator.py
cp install/share/sugar/shell/emulator.py install/share/sugar/shell/emulator.py.backup
nano install/share/sugar/shell/emulator.py
Find this piece of code:
Find this piece of code:
./sugar-jhbuild --help-commands
./sugar-jhbuild --help-commands
A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]:
A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]: (Note that build will update first anyway, so run update separately if you want to see what changed more easily.)
./sugar-jhbuild update
./sugar-jhbuild update
Once you have Sugar running, here are some useful commands:
Once you have Sugar running, here are some useful commands:
*'''Alt+F''' makes the frame appear and disappear
*'''Alt+F''' makes the frame appear and disappear
*'''Alt+C''' quits an activity
*'''Ctrl-Q''' quits an activity
*'''Alt+Q''' quits Sugar
*'''Alt+Q''' quits Sugar
*'''Alt+N''' switches applications within sugar (like alt-tab on the device)
*'''Alt+N''' and '''Alt+P''' switch applications within sugar (like alt-tab on the device)
== Customize ==
== Customize ==