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 ==
-[http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg23369.html Announcement post]
+This is a set of 3rd party repositories with Sugar Learning Platform packages for major GNU/Linux [[Sweets_Distribution/Supported_platforms|distributions]].
-These are the major purposes for this distribution:
+The major reasons to support all these repositories are:
-* 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;
+* Let people to try new functionality which is not available from the regular sources;
-* 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;
+* Support GNU/Linux distributions that lack of Sugar Learning Platform from official repositories;
-* 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.
+* Bring recent Sugar Learning Platform versions to systems initially released with older Sugar.
-This is a special, Sugar only, distribution. These are the key points that make the Sweets Distribution different from other [[Community/Distributions|Distributions]]:
+== Repositories ==
-* The Sweets Distribution is formed as a 3rd party repository, i.e., it is not a complete GNU/Linux distribution;
+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]].
-* 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 ==
+== Installation ==
-Sweets Distribution contains only Glucose, Fructose, and Sugar Platform dependencies. More activities are not included because
+The installation occurs in two phases:
-* people can install activities at any time, and
+* [[#Add_repository|add]] one of Sweets Distribution repositories to local system;
-* it is easy to support Sweets Distribution based Sugar distribution by including activities that are more appropriate for the current use case.
+* [[#Install packages|install]] packages from added Sweets Distribution repository.
-Glucose is being used from {{Code|dextrose/sugar}} sweet and contains pristine Glucose and [[Dextrose]] patches.
+=== Add repository ===
-== Releases ==
+Experienced users might follow [[Sweets_Distribution/Manual_Installation|manual instructions]] to add Sweets Distribution [http://download.sugarlabs.org/packages/ repositories] to the system.
-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.
+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:
+ 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 {{Code|0.94}}, repository in the system
+ sudo sweets-distribution select 0.94
+=== Install packages ===
+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.
+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:
+* {{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 38: / 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 a repository by importing its gpg key. For example, for the [http://download.sugarlabs.org/packages/SweetsDistribution:/0.94/Ubuntu-11.04/ Ubuntu-11.04] repository, enter the following 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.
- wget -qO- 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 ===
-:(Note the following steps can also be done from synaptic package manager)
-  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 the 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 the 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 the ''Education/Sugar'' application menu item or enter the following 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 to a Sugar session, choose the ''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}}