Journal

From OLPC
Revision as of 18:35, 30 December 2007 by 66.97.98.214 (talk) (completed a sentence with 'entry')
Jump to: navigation, search
  This page is monitored by the OLPC team.
Journal-icon.png This activity was core
TST Journal
Trac print.png Tickets all - active - new
OlpcProject.png OLPC Core

see more templates or propose new

Description & Goals

  For the general public

The Journal activity is an automated diary of everything a child does with his or her laptop. The Journal can be used by children to organize work or revisit a past project, and by teachers and parents to assess a child's progress.

The Journal activity provides an intuitive interface for viewing projects and files saved by the XO user.

The Journal is also used to access external media (USB sticks, etc.); delete files; and access the backup system (for those of you connected to a School Server).


The Journal is also a key component of the Bitfrost security specification. The document Journal and Overlays discusses one possible implementation strategy for the Journal and auto-population while using (particularly legacy) activities.

See the Human Interface Guidelines for theoretical discussion.

Using the Journal

  For the general public

Basics

Journal-main-view.gif

Every time you run an activity, it creates an entry in the Journal. The main view can be searched or sorted; clicking on an entry takes you to the detail view.

There are six fields for each entry (some of which may be empty): the star; the entry icon; the entry name; the friends list; the entry date; and a resume button.

Clicking on the entry icon (or the resume button) will resume the activity. Clicking on the entry name will bring up the detail view of the entry.

Journal-data.gif

Many activities store data in the Journal. For example, the Record activity stores an individual entry in the Journal for each picture you take.

Journal-download.gif

Whenever you download a file, it is stored as a Journal entry. You open the file by resuming the entry.

Detail view

Journal-detail-view.gif

The entry can be "starred" or renamed. A description and tags can also be added. These text fields are searchable.

From the menu, entries can be removed or resumed.

Journal-goback.gif

  • go back to main view

Journal-erase.gif

  • erase an entry

Journal-clipboard.gif

  • copy entry to clipboard

Journal-resume.gif

  • resume entry

Hovering over the resume button will bring up the resume options for the entry.

Search and sorting

Journal-search.gif

From the main menu, you can search for keywords and tags or sort by entry type or date.

External storage devices

Journal-USB.gif

External storage devices are automatically mounted. They appear as icons at the bottom of the Journal.

Journal-USB-view.gif

An external storage device is accessed by clicking on the icon; files can be opened directly from the external device or dragged to (or from) the Journal.

Journal-USB-unmount.gif

Unmount the device by selecting unmount from the hover menu.

Installing activities

Journal-install.gif

.xo bundles that are downloaded from the Browse activity are stored in the Journal (in the figure above, there is an entry for the Stopwatch.xo bundle). By resuming the activity from the Journal entry will both launch it and install it on the taskbar.

To uninstall an activity, delete the entry from the Journal. It will be removed from the taskbar the next time you start your XO.

Additional notes

  • The Journal is always available on the Activity Circle in the Home View.

System-search.png

  • The "magnifying glass" key on the top row of the keyboard can be used to open the Journal.
  • You can take a screen shot by typing ALT+1. The screen shot is stored as an entry in the Journal.
  • The Journal stores files in:
/home/olpc/.sugar/defaults/datastore
One way to determine the underlying filesystem name of a saved activity is to locate it in Journal, click its name, hover over Run until Browse appears, choose Browse, then in Browse click the location field.
  • It is not yet possible to write directly to external storage, e.g., save photos from the Record activity to an SD card. This is a future feature.

Development

Source

RPMs

  • none available

Resources

Functional Test

Basic

  • The Journal comes up running when the XO is powered on.
  • The basic functional test is to create an Abiword document and Paint file, exit, then ensure that they show up in the journal.
  • From the journal interface you should be able to resume these activities right where you left off.

Secondary

  • Journals are properly archived and can be restored from the school server.
  • Sharing?