Difference between revisions of "Sweets Distribution"

Latest revision as of 16:50, 18 May 2016

NOTE:
The content of this page is considered
DEPRECATED and OBSOLETE
It is preserved for historical research, along with its talk page.

This was a sort of "Sugar LTS" project by User:alsroot that has been abandoned

These are overview and usage pages regarding the Sweets Distribution. Read technical pages for getting detailed information.

Summary

This is a set of 3rd party repositories with Sugar Learning Platform packages for major GNU/Linux distributions.

The major reasons to support all these repositories are:

Let people to try new functionality which is not available from the regular sources;
Support GNU/Linux distributions that lack of Sugar Learning Platform from official repositories;
Bring recent Sugar Learning Platform versions to systems initially released with older Sugar.

Repositories

Sweets Distribution is formed as a list of repositories that can be added to the system. Only one repository can be registered in the system at the same time. Repositories are identified by names and might be in stable or development stage. Different repositories might be available on different platforms from the supported platforms list.

Installation

The installation occurs in two phases:

add one of Sweets Distribution repositories to local system;
install packages from added Sweets Distribution repository.

Add repository

Experienced users might follow manual instructions to add Sweets Distribution repositories to the system.

For easy attaching Sweets Distribution repositories, use sweets-distribution command.

If sweets-distribution is not yet installed, download the sweets-distribution.sh install script and run it from the root user, e.g., type the following commands in a terminal:

wget http://download.sugarlabs.org/packages/sweets-distribution.sh
sudo sh sweets-distribution.sh

To get the status information about currently selected and all available repositories:

sweets-distribution status

To add chosen, here 0.94, repository in the system

sudo sweets-distribution select 0.94

Install packages

When the sweets-distribution select command finishes, the local system will be aware of the Sweets Distribution repository and it will be possible to install packages.

In the regular way for your operating system (such as with apt-get install or yum install), from a local system terminal, console, or via SSH, install one of the following packages:

sweets-desktop
The full set of packages from Sweets Desktop.

Sometimes, it may be required to downgrade packages while switching to another repository. The easy way to do so is with the sync command:

sudo sweets-distribution sync

Most of the Sweets Distribution packages will be placed in the /opt/sweets directory; thus, it will be possible to use Sugar from the Sweets Distribution and from official packages at the same time.

Usage

Below are instructions on how to use the Sweets Distribution after installing packages.

Sweets Desktop session

If sweets-desktop package was installed, it will be possible to log in to a Sweets Desktop session. Choose the Sweets Desktop session type in a login manager.

Run Sugar in a window

To run Sugar in a window without logging out from the current desktop environment, select the Education/Sugar application menu item or enter the following command in a terminal:

sweets-sugar-emulator

Run Sugar full screen

Run this command in a terminal or edit the properties of the menu item for Sugar

sweets-sugar-emulator -f, --fullscreen

Sugar Activities

For stable 0.94 and 0.88 repositories, the following points are assumed:

Fructose activities need to be used only from Sweets Distribution packages, at least for ones that have external dependencies, i.e., they should not be upgraded from the Activity Library;
The rest of activities need to be handled manually, e.g., manual installing missed dependencies.

All other repositories should bring Sugar Network integration, a different design solution for handling Sugar Activities. Sugar Network is assumed to improve the process of launching Sugar Activities to make it more reliable and smooth. By default, Sugar Network integration might be switched off, enable it after installation.

Testing

Latest Test results for Sweets Distribution on various platforms, such as Ubuntu, Trisquel, and Fedora 14.
Older Test results for Sweets Distribution on Ubuntu.

Feedback

Submit your bug report or feature request.
Subscribe to the sugar-devel mailing list and email with the subject prefixed with [SWEETS].
Ask your question on IRC channels, #sugar (not logged) or #sugar-newbies (logged).

@@ Line 1: / Line 1: @@
+{{Obsolete | This was a sort of "Sugar LTS" project by [[User:alsroot]] that has been abandoned}}
+<span class="linkgroup">[[File:Question.png|65px|link=Sweets_Distribution/Logo]]</span>
+{{Template:Sweets Distribution Linkbar}}
+These are overview and usage pages regarding the [[Sweets Distribution]]. Read [[Platform_Team/Sweets_Distribution|technical pages]] for getting detailed information.
 == Summary ==
-These are the major purposes for this distribution:
+This is a set of 3rd party repositories with Sugar Learning Platform packages for major GNU/Linux [[Sweets_Distribution/Supported_platforms|distributions]].
+The major reasons to support all these repositories are:
+* Let people to try new functionality which is not available from the regular sources;
+* Support GNU/Linux distributions that lack of Sugar Learning Platform from official repositories;
+* Bring recent Sugar Learning Platform versions to systems initially released with older Sugar.
+== Repositories ==
+Sweets Distribution is formed as a [[Template:Sweets_Distribution_Linkbar|list of repositories]] that can be added to the system. Only one repository can be registered in the system at the same time. Repositories are identified by names and might be in stable or development stage. Different repositories might be available on different platforms from the [[Sweets_Distribution/Supported_platforms|supported platforms list]].
+== Installation ==
+The installation occurs in two phases:
+* [[#Add_repository|add]] one of Sweets Distribution repositories to local system;
+* [[#Install packages|install]] packages from added Sweets Distribution repository.
+=== Add repository ===
+Experienced users might follow [[Sweets_Distribution/Manual_Installation|manual instructions]] to add Sweets Distribution [http://download.sugarlabs.org/packages/ repositories] to the system.
+For easy attaching Sweets Distribution repositories, use {{Code|sweets-distribution}} command.
+If {{Code|sweets-distribution}} is not yet installed, download the [ftp://download.sugarlabs.org/packages/sweets-distribution.sh sweets-distribution.sh] install script and run it from the {{Code|root}} user, e.g.,
+type the following commands in a terminal:
-* When [[Platform_Team/Guide/Sweets_Usage#Sugar_via_Sweets|Sweets]] is more appropriate for personal usage, Sweets Distribution might be useful for Sugar distributors, e.g., special GNU/Linux distributions targeted for Sugar usage;
+ wget http://download.sugarlabs.org/packages/sweets-distribution.sh
-** Some times it is nearly impossible to have a recent Sugar release in not so recent GNU/Linux distributions, e.g., LTS releases. Sweets Distribution will be helpful in that case;
+ sudo sh sweets-distribution.sh
-* Sweets Distribution is all about packaging [[Platform_Team/Guide/Sweets_Usage#Sugar_via_Sweets|Sugar sweets]], thus, it is a zero-cost effort.  The downside is that it is impossible to add Sweets Distribution's packages to official repositories of GNU/Linux distributions.
-This is a special, Sugar only, distribution. These are the key points that make the Sweets Distribution different from other [[Community/Distributions|Distributions]]:
+*To get the status information about currently selected and all available repositories:
-* The Sweets Distribution is formed as a 3rd party repository, i.e., it is not a regular GNU/Linux distribution;
+ sweets-distribution status
-* It [[#Releases|supports]] several GNU/Linux distributions at the same time;
-* Packages from these repositories do not interfere with the rest of the system, e.g., it is possible to use Sugar from the Sweets Distribution and Sugar from official repositories at the same time.
-== Content ==
+*To add chosen, here {{Code|0.94}}, repository in the system
-Sweets Distribution contains only Glucose, Fructose, and Sugar Platform dependencies. More activities are not included because
+ sudo sweets-distribution select 0.94
-* people can install activities at any time, and
+=== Install packages ===
-* it is easy to support Sweets Distribution based Sugar distribution by including activities that are more appropriate for the current use case.
-Glucose is being used from {{Code|dextrose/sugar}} sweet and contains pristine Glucose and [[Dextrose]] patches.
+When the {{Code|sweets-distribution select}} command finishes, the local system will be aware of the Sweets Distribution repository and it will be possible to install packages.
-== Releases ==
+In the regular way for your operating system (such as with '''apt-get install''' or '''yum install'''), from a local system terminal, console, or via SSH, install one of the following packages:
-The following is a list of Sweets Distribution releases and GNU/Linux repositories they support. The list of supported GNU/Linux distributions is populated entirely on demand, e.g., Ubuntu packages are being used in [[Community/Distributions/Trisquel|Trisquel]]. Please, [[Platform_Team/Sweets/Feedback|submit]] a request if you need more.
+* {{Code|sweets-desktop}}<br>The full set of packages from Sweets Desktop.
+Sometimes, it may be required to downgrade packages while switching to another repository. The easy way to do so is with the {{Code|sync}} command:
+ sudo sweets-distribution sync
+Most of the Sweets Distribution packages will be placed in the {{Code|/opt/sweets}} directory; thus, it will be possible to use Sugar from the Sweets Distribution and from official packages at the same time.
+<!--
 === Sweets Distribution 0.88 ===
@@ Line 36: / Line 72: @@
 Testing [[Dextrose/3|Dextrose 3]] based releases:
+* [http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-11.10/ Ubuntu-11.10]
+: Found issues:
+:* Read doesn't start since it is impossible to start gtk-2 based version; gtk-3 based fails to start
 * [http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-11.04/ Ubuntu-11.04]
+* [http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-10.10/ Ubuntu-10.04]
+* [http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-10.04/ Ubuntu-10.04]
+-->
-== Installation ==
+== Usage ==
-=== Ubuntu and its derivates ===
+Below are instructions on how to use the Sweets Distribution after [[#Install_packages|installing]] packages.
-Register repository with importing its gpg key. For example for [http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-11.04/ Ubuntu-11.04] repository, type in a terminal:
+=== Sweets Desktop session ===
- sudo apt-add-repository 'deb http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-11.04/ ./'
+If {{Code|sweets-desktop}} package was installed, it will be possible to log in to a Sweets Desktop session. Choose the ''Sweets Desktop'' session type in a login manager.
- curl http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-11.04/Release.key | sudo apt-key add -
-Refresh information about repositories:
+=== Run Sugar in a window ===
-  sudo apt-get update
+To run Sugar in a window without logging out from the current desktop environment, select the ''Education/Sugar'' application menu item or enter the following command in a terminal:
+  sweets-sugar-emulator
-Install full Sweets Distribution, i.e., Sugar Shell and Fructose activities:
+=== [[The_Undiscoverable#sugar-emulator.2C_sugar-runner_and_sweets-sugar-emulator|Run Sugar full screen]] ===
+Run this command in a terminal or edit the properties of the menu item for ''Sugar''
-  sudo apt-get install sweets-distribution
+  sweets-sugar-emulator -f, --fullscreen
-Install only Sugar Shell:
+=== Sugar Activities ===
- sudo apt-get install sweets-sugar
+For stable 0.94 and 0.88 repositories, the following points are assumed:
-== Usage ==
+* Fructose activities need to be used only from Sweets Distribution packages, at least for ones that have external dependencies, i.e., they should not be upgraded from the [[Activity Library]];
+* The rest of activities need to be handled manually, e.g., manual installing missed dependencies.
-To run Sugar in emulator mode, select ''Education/Sugar'' application menu item or type in a terminal:
+All other repositories should bring [[Sugar Network]] integration, a different design solution for handling Sugar Activities. [[Sugar Network]] is assumed to improve the process of launching Sugar Activities to make it more reliable and smooth. By default, Sugar Network integration might be switched off, [[Platform_Team/Sweets_Distribution/0.94:SugarNetwork#Sugar_Network_integration|enable]] it after installation.
- sweets-sugar-emulator
+== Testing ==
+* Latest [[Community/Distributions/Sweets_Distribution/Testing|Test results for Sweets Distribution]] on various platforms, such as Ubuntu, Trisquel, and Fedora 14.
+* Older [[Community/Distributions/Ubuntu/Tests|Test results for Sweets Distribution on Ubuntu]].
-To login into Sugar session, choose ''Sweets Distribution'' session type.
+== See also ==
+* [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg23369.html Announcement post],
 == Feedback ==
-{{:Platform_Team/Sweets/Feedback}}
+{{:Platform_Team/Sweets_Distribution/Feedback}}