Talk:Creating a collection

From OLPC
Revision as of 22:23, 8 January 2008 by Ericvh (talk | contribs) (Experiences trying to create a content bundle)
Jump to navigation Jump to search

Feedback, questions, comments, observations, thoughts, etc, are most welcome.


I've been trying to create a content bundle. The selecting content information was great, but I would find more specific information on the packaging very helpful. Here are some of the specific questions I have;
1. I've got a audiobook which has each chapter as a separate file. Is there anyway to display them all as just one book instead of adding titles, descriptions etc to each separate entry in the xml file and then having them display as separate items.
2. The entry url in the xml file. Do we just enter /file Or do we need to enter something along the lines of /home/olpc/library/yourfolderhere/file etc.
3. It says that you can create new catagories but I assume you don't want too many of them. So it would be nice to have more guidelines on what you should name them and when you should create them
4. Should I use the same name in the .info file as the library name in the .xml file?

Thanks for your help Crazybus 07:23, 28 July 2007 (EDT)

TurtleArt file format

TurtleArt samples should probably be content bundled. TurtleArt data files are a .ta file with associated .png image, usually with the same name. How should these be packaged so that TurtleArt can find the .png, if it exists? --Lincolnquirk

Packaging an activity as a content bundle

What are the semantics for this? Does a hybrid activity/content bundle get installed as both an activity and a content bundle (so it appears on the launcher, etc.)? --Lincolnquirk Sat Aug 25

Library server?

"... and a second bundle of unlimited (but reasonable) size for inclusion on each school's library server." How does this work? Is it as if the bundle on the server is installed locally, or does it just link off to the server on an item-by-item basis like any other web page? If it acts like more "local" storage, can this mechanism be extended to include specially formatted SD cards? (And if not, I think that's a good idea that they should implement anyway. Just pop in a card and it's like your XO has a few extra gigs of general storage...) I ask because apparently content bundles are installed in internal flash, which could fill up quickly if any significant audio or video content is included that a student is expected to study off site.

Content bundles have a lot of potential for organizing items that otherwise would just be random things scattered in the Journal. This year's textbooks can be published as PDF, a small HTML file can describe which PDF is what book, and the whole thing can be bundled together and installed easily. Name it (in the Browser) after the current grade and classroom etc. Whether to keep old book bundles for reference depends on flash space constraints and licensing agreements. Bouncey 10:54, 6 January 2008 (EST)

Experiences trying to create a content bundle

I had issues with trying to create content bundles for my OLPC (a stock G1G1 laptop). To assist others who may be having similar problems I'm putting the list here for reference. I was following instructions found in this wiki: Creating a content bundle and Library grid.

Web server mime types

The first problem I had was that it didn't seem like when I downloaded the .xol file (or .xo files for that matter) from my web-server that the content (or activity) would be installed. This was because my web server didn't know about the OLPC mime types. You need to add the following to your web-server configuration (/etc/apache/mime.types or just /etc/mime.types on Ubuntu systems)

  application/vnd.olpc-sugar      xo
  application/vnd.olpc-content    xol

If you can't change the web-server configuration, you'll have to manually create a Library directory and unzip your content there

  mkdir /home/olpc/Library
  cd /home/olpc/Library
  unzip <path-to-xol-bundle>
  /usr/share/library-common/make_index.py

indexing content

I tried using the library/library.xml method to generate an index for the content. This did not work. I ended up sticking to just writing my own index.html file

relative paths

It seemed from the various instructions that you could use relative paths to your content data files (in my case pdfs). However, when the index.html gets installed, it gets installed to /home/olpc/.library/<content-name>/bundle_index.html, but the rest of your content stays in /home/olpc/Library -- so relative paths don't work. I just changed the relative paths to prefix /home/olpc/Library/<bundle-name> and things seemed to work fine.