User:Wade/Unified Bundles - Revision history

Wade: moved Unified Bundles to User:Wade/Unified Bundles: Archiving this idea until it can be reconstituted as a feature request, if it still makes sense.

2009-09-20T01:44:21Z

moved Unified Bundles to User:Wade/Unified Bundles: Archiving this idea until it can be reconstituted as a feature request, if it still makes sense.

← Older revision	Revision as of 21:44, 19 September 2009
(No difference)

Bert: /* Etoys Content Viewer */ minor technical correction

2009-04-07T06:28:39Z

Etoys Content Viewer: minor technical correction

← Older revision		Revision as of 02:28, 7 April 2009
Line 85:		Line 85:
	This package contains some of the source code to the Etoys activity, plus the sugar-etoys-activity launcher script.		This package contains some of the source code to the Etoys activity, plus the sugar-etoys-activity launcher script.

	Etoys-based Unified content bundles are made up of a Squeak VM. The activity.info file contains the line:		Etoys-based Unified content bundles are made up of a Squeak script or Etoys project. The activity.info file contains the line:

	exec sugar-etoys-activity [options] <~~squeak_vm_file~~>		exec sugar-etoys-activity [options] <squeak_file>

	==Content Viewer implementation==		==Content Viewer implementation==

Bert: /* Etoys Content Viewer */ correct spelling (EToys - Etoys)

2009-04-07T06:27:04Z

Etoys Content Viewer: correct spelling (EToys - Etoys)

← Older revision		Revision as of 02:27, 7 April 2009
Line 78:		Line 78:
	exec sugar-etext-activity [options] <etext_file>		exec sugar-etext-activity [options] <etext_file>

	===~~EToys~~ Content Viewer===		===Etoys Content Viewer===
	The Sugar ~~EToys~~ Content Viewer is packaged as sugar-etoys-content-viewer. Package dependences are not known at this time.		The Sugar Etoys Content Viewer is packaged as sugar-etoys-content-viewer. Package dependences are not known at this time.

	The purpose of having a separate content viewer for Etoys is that the content viewer wrapper script launches Etoys in a mode which bypasses the home screen, and seamlessly launches into the Etoys content. [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] is an example of this idea.		The purpose of having a separate content viewer for Etoys is that the content viewer wrapper script launches Etoys in a mode which bypasses the home screen, and seamlessly launches into the Etoys content. [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] is an example of this idea.

	This package contains some of the source code to the ~~EToys~~ activity, plus the sugar-etoys-activity launcher script.		This package contains some of the source code to the Etoys activity, plus the sugar-etoys-activity launcher script.

	~~EToys~~-based Unified content bundles are made up of a Squeak VM. The activity.info file contains the line:		Etoys-based Unified content bundles are made up of a Squeak VM. The activity.info file contains the line:

	exec sugar-etoys-activity [options] <squeak_vm_file>		exec sugar-etoys-activity [options] <squeak_vm_file>

FGrose at 00:29, 7 April 2009

2009-04-07T00:29:32Z

← Older revision		Revision as of 20:29, 6 April 2009
Line 1:		Line 1:
			<noinclude>{{ GoogleTrans-en \| es =show \| bg =show \| zh-CN =show \| zh-TW =show \| hr =show \| cs =show \| da =show \| nl =show \| fi =show \| fr =show \| de =show \| el =show \| hi =show \| it =show \| ja =show \| ko =show \| no =show \| pl =show \| pt =show \| ro =show \| ru =show \| sv =show }}{{TOCright}}
	==Goal==		==Goal==
	To describe a new Sugar bundle which supports equally Activity software and prepared Content.		To describe a new Sugar bundle which supports equally Activity software and prepared Content.

Wade: /* Sugar changes */

2009-04-06T22:49:58Z

Sugar changes

← Older revision		Revision as of 18:49, 6 April 2009
Line 107:		Line 107:
	With the SWF content viewer to base on, a Flash developer can develop a game in Flash but use Python to add toolbars and GTK widgets. They would package their Python code and SWF file in a Unified bundle, and subclass the sugar-swf-activity classes in their Python code.		With the SWF content viewer to base on, a Flash developer can develop a game in Flash but use Python to add toolbars and GTK widgets. They would package their Python code and SWF file in a Unified bundle, and subclass the sugar-swf-activity classes in their Python code.

	==~~Sugar changes~~==		==Implementation==
	The primary change to Sugar is that it should gracefully handle failure to find the program specified by the 'exec' line in activity.info, displaying a friendly error message on the launcher screen to the effect of "You do not have the required software to view this content.".		The primary change to Sugar is that it should gracefully handle failure to find the program specified by the 'exec' line in activity.info, displaying a friendly error message on the launcher screen to the effect of "You do not have the required software to view this content.".

	There is also the new hidden=true line in activity.info to prevent Content Viewers from appearing in the Home view.		There is also the new hidden=true line in activity.info to prevent Content Viewers from appearing in the Home view.

			Most of the work is in converting existing activities to Content Viewer packages, packaging them and writing the sugar-xxx-activity wrapper scripts. Fortunately, this work can be done one content viewer at a time and the old and new systems can coexist.

			For example, you can have Read and sugar-pdf-content-viewer installed simultaneously. The user will be allowed to open a PDF file with either, and sugar-pdf-content-viewer will only come into play when a Unified bundle is opened.

Wade: /* Content Viewer based Activities */

2009-04-06T22:48:02Z

Content Viewer based Activities

← Older revision		Revision as of 18:48, 6 April 2009
Line 99:		Line 99:

	==Content Viewer based Activities==		==Content Viewer based Activities==
	~~One advantage of~~ Sugar ~~providing~~ the content viewers ~~versus packaging~~ them as individual activities is that they can be extended by developers to create new activities.		Making Sugar provide the content viewers instead of releasing them as individual activities is that they can be extended by developers to create new activities.

	For example, the WikiBrowse activity is based on the Browse classes. If Browse, is not installed, WikiBrowse cannot launch. With the source code to Browse part of Sugar, web-based activities can be built on top of the Content Viewer classes and extended with additional Python code such as a custom server or PyXPCom code.		For example, the WikiBrowse activity is based on the Browse classes. If Browse, is not installed, WikiBrowse cannot launch. With the source code to Browse part of Sugar, web-based activities can be built on top of the Content Viewer classes and extended with additional Python code such as a custom server or PyXPCom code.

	Or, a Flash developer can develop a game in Flash but use Python to ~~manage the~~ toolbars. They would package their Python code and SWF file in a Unified bundle, and ~~reference~~ the sugar-swf-activity classes ~~from~~ their Python code.		As another example, the Gmail activity is a customized copy of an older (now broken) version of the Browse source code. With the content viewer source available, this would no longer be needed.

			With the SWF content viewer to base on, a Flash developer can develop a game in Flash but use Python to add toolbars and GTK widgets. They would package their Python code and SWF file in a Unified bundle, and subclass the sugar-swf-activity classes in their Python code.

	==Sugar changes==		==Sugar changes==

Wade: /* Content Viewer implementation */

2009-04-06T22:44:59Z

Content Viewer implementation

← Older revision		Revision as of 18:44, 6 April 2009
Line 91:		Line 91:
	Content Viewers require very small changes to Sugar. This is because they are really a special case of Activities.		Content Viewers require very small changes to Sugar. This is because they are really a special case of Activities.

	Content viewers are distributed as distro packages. Their activity files are installed into /usr/share/sugar/activities. Their wrapper scripts are installed into /usr/bin. Their activity.info files include a new line "hidden=true" which prevents them from being visible in any of the Home views, which prevents them from being launched directly by the user.		Content viewers are distributed as distro packages. Their activity class files are installed into /usr/share/sugar/activities. Their wrapper scripts are installed into /usr/bin. Their activity.info files include a new line "hidden=true" which prevents them from being visible in any of the Home views, which prevents them from being launched directly by the user.

	==Content Viewers and MIME Types==		==Content Viewers and MIME Types==

Wade: /* Content Viewers and MIME Types */

2009-04-06T22:44:27Z

Content Viewers and MIME Types

← Older revision		Revision as of 18:44, 6 April 2009
Line 94:		Line 94:

	==Content Viewers and MIME Types==		==Content Viewers and MIME Types==
	~~Tthe content~~ viewer activities will be registered as MIME type handlers for their respective types.		Content viewer "base" activities installed in /usr/share/sugar/activities will be registered as the primary MIME type handlers for their respective types.

	So, when a .html file is opened from the Journal, the sugar-web-content-viewer activity will be launched and a Journal entry will be recorded as "Web Content".		So, when a .html file is opened from the Journal, the sugar-web-content-viewer activity will be launched and a Journal entry will be recorded as "Web Content".

Wade: /* Goal */

2009-04-06T22:42:51Z

Goal

← Older revision		Revision as of 18:42, 6 April 2009
Line 1:		Line 1:
	==Goal==		==Goal==
	To describe a new Sugar bundle which supports equally Activity software and prepared Content.		To describe a new Sugar bundle which supports equally Activity software and prepared Content.

			To describe the changes to Sugar and activities required to support such a bundle.

	==Problems Addressed==		==Problems Addressed==

Wade at 22:41, 6 April 2009

2009-04-06T22:41:10Z

← Older revision		Revision as of 18:41, 6 April 2009
Line 1:		Line 1:
	~~Merge~~ .xol bundles to .xo		==Goal==
			To describe a new Sugar bundle which supports equally Activity software and prepared Content.

			==Problems Addressed==
			The current .xol content bundle format hides its data in the home page of Browse. Prepared content is an important part of the learning experience and deserves a first class position in the interface.

			Further, the .xol format is not well supported in Sugar. It requires a parallel infrastructure for downloading, installing, updating and removing, and this infrastructure simply does not exist. Tools for creating content bundles are also weak, although this proposal does not specifically address this.

			Finally, there is a class of "Read-like" activities in Sugar which do not fit well with the notion of what an activity really is. Read, Jukebox, View Slides, Read Etexts and others do not allow creating any content, so when started they pose a Journal selector in a very Windows-like manner. The reality is that these "activities" are really just content viewers which have no meaning in the absence of content. They should not even be displayed on the Home view with other activities.

			==Overview==
			The Unified Bundles project aims to merge the .xol (Content Bundle) and .xo (Activity Bundle) formats into a single .xo (Sugar Bundle) format.

			The Unified Bundle format is exactly the same as the Activity Bundle format with one clarification. Activity Bundles are expected to contain an executable program, which is referenced by the exec line of activity.info. In Unified bundles, there no longer needs to be an executable program, and the exec line may refer to an external executable program provided by Sugar.

			Content bundles packaged as Unified bundles are .zip files (named .xo) which contain assets such as .html, .js, .jpeg, .swf files, a MANIFEST, and an activity directory containing activity.info. The activity.info file refers to the content viewer which opens the assets in its exec line.

			==Sugar Content Viewer Packages==
			The external programs referred to by content bundle activity.info files are provided by Sugar Content Viewers. They are packaged separately from Sugar and a core set can be dependencies of Sugar.

			===Web Content Viewer===
			The Sugar Web Content Viewer is packaged as sugar-web-content-viewer.

			This package contains the source code of the Browse activity, plus the sugar-web-activity launcher script. This launcher script provides extra command line arguments to control UI features such as which toolbars are available.

			Web-based Unified content bundles are made up of .html, .js, .jpeg, etc. files. The activity.info file contains the line:

			exec sugar-web-activity [options] <index_file>

			The Browse activity then becomes a tiny Unified bundle holding a static Sugar Labs welcome page.

			===SWF Content Viewer===
			The Sugar SWF (Flash) Content Viewer is packaged as sugar-swf-content-viewer. It depends on the Gnash package and Python bindings.

			This package contains a simple PyGTK wrapper sugar-swf-activity, which embeds Gnash as the activity canvas and manages saving the flash persistent data to the Journal. It may also provide some simple hooks for collaboration and localization.

			SWF-based Unified content bundles are made up of one or more .swf files and related assets. The activity.info file contains the line:

			exec sugar-swf-activity [options] <swf_file>

			===PDF Content Viewer===
			The Sugar PDF Content Viewer is packaged as sugar-pdf-content-viewer. It depends on the Evince package and Python bindings.

			This package contains the source code to the Read activity, plus the sugar-pdf-activity launcher script.

			PDF-based Unified content bundles are made up of one or more .pdf files. The activity.info file contains the line:

			exec sugar-pdf-activity [options] <pdf_file>

			===Slides Content Viewer===
			The Sugar PDF Content Viewer is packaged as sugar-slides-content-viewer.

			This package contains the source code to the View Slides activity, plus the sugar-slides-activity launcher script.

			PDF-based Unified content bundles are made up of one or more image files. The activity.info file contains the line:

			exec sugar-slides-activity [options]

			===Media Content Viewer===
			The Sugar Media Content Viewer is packaged as sugar-media-content-viewer.

			This package contains the source code to the Jukebox activity, plus the sugar-media-activity launcher script.

			Movie and/or audio-based Unified content bundles are made up of one or more media files. The activity.info file contains the line:

			exec sugar-media-activity [options]

			===Etext Content Viewer===
			The Sugar Etext Content Viewer is packaged as sugar-etext-content-viewer. Package dependences are not known at this time.

			This package contains the source code to the Read Etexts activity, plus the sugar-etext-activity launcher script.

			Etext-based Unified content bundles are made up of one or more etext files. The activity.info file contains the line:

			exec sugar-etext-activity [options] <etext_file>

			===EToys Content Viewer===
			The Sugar EToys Content Viewer is packaged as sugar-etoys-content-viewer. Package dependences are not known at this time.

			The purpose of having a separate content viewer for Etoys is that the content viewer wrapper script launches Etoys in a mode which bypasses the home screen, and seamlessly launches into the Etoys content. [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] is an example of this idea.

			This package contains some of the source code to the EToys activity, plus the sugar-etoys-activity launcher script.

			EToys-based Unified content bundles are made up of a Squeak VM. The activity.info file contains the line:

			exec sugar-etoys-activity [options] <squeak_vm_file>

			==Content Viewer implementation==
			Content Viewers require very small changes to Sugar. This is because they are really a special case of Activities.

			Content viewers are distributed as distro packages. Their activity files are installed into /usr/share/sugar/activities. Their wrapper scripts are installed into /usr/bin. Their activity.info files include a new line "hidden=true" which prevents them from being visible in any of the Home views, which prevents them from being launched directly by the user.

			==Content Viewers and MIME Types==
			Tthe content viewer activities will be registered as MIME type handlers for their respective types.

			So, when a .html file is opened from the Journal, the sugar-web-content-viewer activity will be launched and a Journal entry will be recorded as "Web Content".

			==Content Viewer based Activities==
			One advantage of Sugar providing the content viewers versus packaging them as individual activities is that they can be extended by developers to create new activities.

			For example, the WikiBrowse activity is based on the Browse classes. If Browse, is not installed, WikiBrowse cannot launch. With the source code to Browse part of Sugar, web-based activities can be built on top of the Content Viewer classes and extended with additional Python code such as a custom server or PyXPCom code.

			Or, a Flash developer can develop a game in Flash but use Python to manage the toolbars. They would package their Python code and SWF file in a Unified bundle, and reference the sugar-swf-activity classes from their Python code.

			==Sugar changes==
			The primary change to Sugar is that it should gracefully handle failure to find the program specified by the 'exec' line in activity.info, displaying a friendly error message on the launcher screen to the effect of "You do not have the required software to view this content.".

			There is also the new hidden=true line in activity.info to prevent Content Viewers from appearing in the Home view.