Creating a collection

Overview

The OLPC Library is the repository all content shipped with the XO laptop. In order to add your content to this repository, you must create a self-contained bundle for your content. This page gives you the information you need to select, format, and package your content bundle.

Selecting Content

The first step to creating your content bundle is to determine what content should be included. In some cases, this is easy: everything! In other cases, however, there are additional considerations:

Size. How big is your collection? If the size of your entire collection is between 5-20MB, you're all set. Otherwise, you'll need to make two bundles-- one bundle of 5-20MB for use on individual laptops, and a second bundle of unlimited (but reasonable) size for inclusion on each school's library server.

Quality. Does your collection have a rating system in place? If so, consider including only top-rated material in your content bundle. Otherwise, think about "curating" a selection of high quality material to be included in your bundle (or bundles).

Relevance.' Is your entire collection relevant to children? If so, terrific! If not, consider including only material that will help children learn, explore, and expand their worlds.

Language issues. Does your collection contain material in multiple languages? We hope it does! To the greatest extent possible, please give preference to materials that exist in multiple languages, or that can be easily translated by our localization team.

Licensing issues. What kind of copyright exists on the material in your collection? Do you have legal permission to archive and distribute it? Please be sure to review the licensing terms of your collection. For guidance on licensing, see: http://creativecommons.org/about/licenses/.

Formatting Content

Once you've determined the material you'd like to include in your content bundle (or, again, bundles-- since in many cases, you'll have to make two), you'll need to format it for use on the XO.

The first step of this process is to make sure that your collection is stored in a supported file format. The following is a list of supported file formats:

Text

• .txt, .doc, .abw : These formats can be read by AbiWord and will launch it from the browser. AbiWord will write .abw files.
• .pdf : This can be ready by xbook, which launches automatically from the browser when following a link to a pdf.

Multimedia document with layout

• .html : Parsed by the browser. Source will soon be viewable.
• .pdf : Read by xbook.

Formatted text

• .xml, .rss : Read by the browser and by penguinTV (as feeds).

Images

• .jpeg, .gif, .png: These can be viewed by many applications, including the browser.
• .svg - 99% supported.

Music

• .csound : This will be playable by TamTam... currently its XO build doesn't provide a way to save or load sound files, however.
• .ogg : See other common audio formats below; can be played by Helix or Gstreamer, not part of the current build.
• .mp3, .wav : These can be played by Helix or Gstreamer, standalone or as a browser plugin, when they are installed.
• .rm, .ra : This can be played by the Helix plugin when installed with a RealAudio codec.

  Currently, audio files selected in the browser will launch a player if it is present.

Video

• .ogg : Can be played by Helix or Gstreamer, standalone or as a plugin. These activities aren't in the current build, but there is a good Helix activity that you can download in a few steps. To play video, please download this activity along with some videos (see for instance this video).
• .mpeg, .mov, .wmv, .rm : See above.

Helix

• The Helix Media Activity has more information about media activity

Python

• The Develop activity will provide one way to view python files; the 'view source key' another.

Javascript

• This will viewable the same way page source can be viewed through the browser.

Etoys projects

• .pr files automatically launch etoys from the browser.

If you have a question about a file format that is not listed above, ask it on the talk page.

The second step of the formatting process is to make sure that your collection looks nice.