Journal: Difference between revisions

Latest revision as of 21:34, 2 December 2010

This page is monitored by the OLPC team.

Please copy/paste "{{Translationlist | xx | origlang=en | translated={{{translated}}}}}" (where xx is ISO 639 language code for your translation) to Journal/translations HowTo [ID# 249478] +/-

Journal

This activity was core

sources in journal-activity

TST

Journal

Tickets all - active - new

Pootle — POT

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. Activities that the user has stopped will show in the journal view with a timer showing how long ago they were stopped.

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

USB sticks or SD cards appear at the bottom of the Journal's list of activities. You can drag-and-drop a document name from the journal to copy it to the storage device.

To view the contents of the storage device, click on its icon and wait for the content list to appear in a Journal-style list. If the device has many non-XO files, the process may take some time.

For Developers

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

The Journal Activity pages have a complete overview of the journal and its use.

Development

For Developers

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?

Activity Summary

Icon:	Sugar icon::Image:Activity-journal.svg
Genre:	Activity genre::General Search and Discovery
Activity group:	,\|x\|Activity group::x}}
Short description:	Short description::The Journal activity is an automated diary of everything a child does with his or her laptop. It is the equivalent of a file browser.
Description:	[[Description::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. Activities that the user has stopped will show in the journal view with a timer showing how long ago they were stopped. The Journal is also used to access external storage media (USB sticks, etc.); delete files; and access the backup system (for those of you connected to a School Server).]]
Maintainers:	,\|x\|Contact person::x}}
Repository URL:	Source code::http://dev.laptop.org/git?p=journal-activity
Available languages:	,\|x\|Available languages::x}}
Available languages (codes):	,\|x\|Language code::x}}
Pootle URL:	Localization URL::https://dev.laptop.org/translate/projects/xo_core
Related projects:	Related projects,\|x\|Related projects::x}}
Contributors:	,\|x\|Team member::x}}
URL from which to download the latest .xo bundle	Activity bundle::
Last tested version number:
The releases with which this version of the activity has been tested.	,\|x\|Software release::x}}
Development status:	Devel status::4. Beta
Ready for testing (development has progressed to the point where testers should try it out):	,\|x\|Ready for testing::x}}
smoke tested :
test plan available :
test plan executed :
developer response to testing :

URL from which to download the last .xo bundle that works with old releases	Activity bundle::http://dev.laptop.org/~erikos/journal/Journal-86.xo
Activity version number:	Activity version::86
The releases with which this version of the activity has been tested.	,\|x\|Software release::x}}
Development status:

@@ Line 1: / Line 1: @@
 {{OLPC}}
+{{Translations}}
 __TOC__
 {{Olpcboxtop|toptext=[[{{PAGENAME}}|Journal]]}}
@@ Line 15: / Line 16: @@
 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 activity provides an intuitive interface for viewing projects and files saved by the XO user. Activities that the user has stopped will show in the journal view with a timer showing how long ago they were stopped.
-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 used to access external storage media (USB sticks, etc.); delete files; and access the backup system (for those of you connected to a School Server).
+USB sticks or SD cards appear at the bottom of the Journal's list of activities. You can drag-and-drop a document name from the journal to copy it to the storage device.
+To view the contents of the storage device, click on its icon and wait for the content list to appear in a Journal-style list. If the device has many non-XO files, the process may take some time.
 {{Developers}}
@@ Line 25: / Line 30: @@
 ==Using the Journal==
-{{Users}}
+The [[Journal Activity]] pages have a complete overview of the journal and its use.
-===Basics===
-[[Image: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.
-[[Image: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.
-[[Image:Journal-download.gif]]
-Whenever you download a file, it is stored as a Journal entry. You open the file by resuming the
-===Detail view===
-[[Image:Journal-detail-view.gif]]
-From the detail view, entries can be renamed, tagged, or removed; activities can be resumed.
-The detail menu, from left to right:
-* go back to main view (on the far left);
-* remove entry;
-* copy to clipboard;
-* resume.
-Hovering over the resume button will bring up the resume options for the entry.
-The entry can be "starred" or renamed. A description and tags can also be added. These text fields are searchable.
-===Search and sorting===
-[[Image:Journal-search.gif]]
-From the main menu, you can search for keywords and tags or sort by entry type or date.
-===External storage devices===
-[[Image:Journal-USB.gif]]
-External storage devices are automatically mounted. They appear as icons at the bottom of the Journal. They are accessed by clicking on the icon; files can be opened directly from the external device or dragged to (or from) the Journal.
-[[Image:Journal-USB-unmount.gif]]
-Unmount the device by selecting ''unmount'' from the hover menu.
-===Installing activities===
-[[Image: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 screen shots===
-[[Image:Journal-turtle-art.png|thumb|none]]
-[[Image:Journal-camera.png|thumb|none]]
 ==Development==
@@ Line 106: / Line 55: @@
 *Journals are properly archived and can be restored from the school server.
 *Sharing?
+{{Activity page
+|icon=Image:Activity-journal.svg
+|genre=General Search and Discovery
+|short description=The Journal activity is an automated diary of everything a child does with his or her laptop. It is the equivalent of a file browser.
+|long description=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. Activities that the user has stopped will show in the journal view with a timer showing how long ago they were stopped.
+The Journal is also used to access external storage media (USB sticks, etc.); delete files; and access the backup system (for those of you connected to a School Server).
+|contact person=user:Tomeu
+|activity source=http://dev.laptop.org/git?p=journal-activity
+|devel status=4. Beta
+|language=English, Spanish
+|i18n=https://dev.laptop.org/translate/projects/xo_core
+}}
+{{Activity bundle
+|bundle URL=http://dev.laptop.org/~erikos/journal/Journal-86.xo
+|activity version=86
+}}
+[[Category:Journal]]