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]].
+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 ==
-These are the major purposes for this 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]].
-* 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;
+== Installation ==
-* 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;
-* 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]]:
+The installation occurs in two phases:
-* The Sweets Distribution is formed as a 3rd party repository, i.e., it is not a complete GNU/Linux distribution;
+* [[#Add_repository|add]] one of Sweets Distribution repositories to local system;
-* It [[#Releases|supports]] several GNU/Linux distributions at the same time;
+* [[#Install packages|install]] packages from added Sweets Distribution repository.
-* 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 ==
+=== Add repository ===
-Sweets Distribution contains only Glucose, Fructose, and Sugar Platform dependencies. More activities are not included because
+Experienced users might follow [[Sweets_Distribution/Manual_Installation|manual instructions]] to add Sweets Distribution [http://download.sugarlabs.org/packages/ repositories] to the system.
-* people can install activities at any time, and
+For easy attaching Sweets Distribution repositories, use {{Code|sweets-distribution}} command.
-* 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.
+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:
-== Releases ==
+ wget http://download.sugarlabs.org/packages/sweets-distribution.sh
+ sudo sh sweets-distribution.sh
-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.
+*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 44: / Line 78: @@
 * [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 ===
-Add a software source and import the key.  Choose one of the following:
+Below are instructions on how to use the Sweets Distribution after [[#Install_packages|installing]] packages.
-*<s>Sugar 0.94 with Ubuntu-11.10</s>:
+=== Sweets Desktop session ===
-<!--
-  SV=0.94
-  UV=11.10
-  SD=http://download.sugarlabs.org/packages/SweetsDistribution:
-  sudo apt-add-repository "deb $SD/$SV/Ubuntu-$UV/ ./" && \
-  wget -qO- $SD/$SV/Ubuntu-$UV/Release.key | sudo apt-key add -
--->
-:*not yet released, known to not work, see [[Community/Distributions/Ubuntu/Tests|latest test results]]
-*Sugar 0.94 with Ubuntu-11.04 or Trisquel-5.0:
-  SV=0.94
-  UV=11.04
-  SD=http://download.sugarlabs.org/packages/SweetsDistribution:
-  sudo apt-add-repository "deb $SD/$SV/Ubuntu-$UV/ ./" && \
-  wget -qO- $SD/$SV/Ubuntu-$UV/Release.key | sudo apt-key add -
-:*Unmet dependency, Depends on sweets-write but is not going to be installed
-:**Cause is incorrect Depends on python-abiword, an Ubuntu package,
-:**Workaround is: <code>apt-get source python-abiword && apt-get build-dep python-abiword && cd pyabiword-0.8.0 && dpkg-buildpackage && cd .. && dpkg -i python-abiword_*.deb && apt-get install sweets-distribution</code>
-*Sugar 0.94 with Ubuntu-10.04.4 or Trisquel-4.1
-  SV=0.94
-  UV=10.04
-  SD=http://download.sugarlabs.org/packages/SweetsDistribution:
-  sudo apt-add-repository "deb $SD/$SV/Ubuntu-$UV/ ./" && \
-  wget -qO- $SD/$SV/Ubuntu-$UV/Release.key | sudo apt-key add -
-:*see [[Community/Distributions/Ubuntu/Tests|latest test results]]
-*Sugar 0.88 with Ubuntu-10.10 or Trisquel-4.5:
-  SV=0.88
-  UV=10.10
-  SD=http://download.sugarlabs.org/packages/SweetsDistribution:
-  sudo apt-add-repository "deb $SD/$SV/Ubuntu-$UV/ ./" && \
-  wget -qO- $SD/$SV/Ubuntu-$UV/Release.key | sudo apt-key add -
-*Sugar 0.88 with Ubuntu-10.04 or Trisquel-4.1:
-  SV=0.88
-  UV=10.04
-  SD=http://download.sugarlabs.org/packages/SweetsDistribution:
-  sudo apt-add-repository "deb $SD/$SV/Ubuntu-$UV/ ./" && \
-  wget -qO- $SD/$SV/Ubuntu-$UV/Release.key | sudo apt-key add -
-Or check [http://download.sugarlabs.org/packages/SweetsDistribution%3a the downloads directory] for other combinations.
+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.
-Refresh the package list:
+=== 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
+=== [[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''
+ sweets-sugar-emulator -f, --fullscreen
-Install the full Sweets Distribution, i.e., Sugar Shell and Fructose activities:
+=== Sugar Activities ===
- sudo apt-get install sweets-distribution
+For stable 0.94 and 0.88 repositories, the following points are assumed:
-Or, install only the Sugar Shell:
+* 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.
- sudo apt-get install sweets-sugar
+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.
-== Usage ==
+== Testing ==
+* Latest [[Community/Distributions/Sweets_Distribution/Testing|Test results for Sweets Distribution]] on various platforms, such as Ubuntu, Trisquel, and Fedora 14.
-To run Sugar in emulator mode, select the ''Education/Sugar'' application menu item or enter the following in a terminal:
+* Older [[Community/Distributions/Ubuntu/Tests|Test results for Sweets Distribution on Ubuntu]].
- sweets-sugar-emulator
-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}}