Line 1: |
Line 1: |
| {{Translations}} | | {{Translations}} |
− | {{jhbuild-nav}}
| |
| 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. |
| | | |
Line 9: |
Line 8: |
| 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. |
| | | |
− | The [[:Category:Installing Sugar|installing Sugar]] wiki category collects the various articles which detail platform-specific considerations for installing Sugar.
| + | Please make sure that you have satisfied the prerequisites of your platform... |
− | | + | *[[Sugar_on_Fedora|Fedora]] |
− | 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.
| + | *[[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== |
Line 52: |
Line 55: |
| | | |
| 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] |
| | | |
− | sugar-activity [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''': |
| | | |
− | cp /sugar-jhbuild/build/share/sugar/shell/emulator.py /sugar-jhbuild/build/share/sugar/shell/emulator.py.backup | + | 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: |
Line 102: |
Line 110: |
| ./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 |
Line 111: |
Line 119: |
| 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+0''' brings up the developer's console
| |
| *'''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 == |