Read Etexts

From OLPC
Revision as of 11:07, 6 March 2008 by Jdsimmons (talk | contribs) (New page: {{Translations}} {{Olpcboxtop|toptext=[[{{PAGENAME}}|Read Etexts]]}} {{ OBX activity |Image:readetexts.svg||Version 1 }} {{ OBX source dev|projects/read-activity}} {{ OBX test |[[T...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  english | español한국어 HowTo [ID# 115109]  +/-  


Readetexts.svg This activity was [[:Category:|]]
Version 1
[[Category:|Read Etexts]]
TST Read
Trac print.png Tickets all - active - new
OlpcProject.png Manusheel Gupta, Marco Gritti, Tomeu Vizoso, Walter Bender (Adviser), Dan Williams, Eben Eliason, Reinier Heeres
mime pdf

see more templates or propose new


Description & Goals

  For the general public

Summary

The Read activity allows the laptop to act as a book reader. It has a simple interface, and will view many kinds of text and image based book-like materials (PDF files work currently). It will have particular strengths in handheld mode, with extremely low power consumption and simple navigation controls.

Read can read PDF files successfully. Read v42, which is in Build joyride-1606, can also read DJVU dejaVu files. You can download the updated Read here.

How to use

The Read activity does not have an icon in the dock at the bottom of the screen. It is launched by opening the [Journal], choosing a PDF document, and "resuming" it. This will cause the Read activity to open automatically. PDFs downloaded from [Browse] can be opened in this way, as can PDFs on an external storage device.

A selection of out-of-copyright books in PDF format is available at Project Gutenberg with this search.

Other Project Gutenberg texts can be converted to PDFs and downloaded at ManyBooks.net.


Source

http://dev.laptop.org/git.do?p=projects/read-activity

Executable .xo files

How to install the Read activity

  • To use the reader, download the .xo file shown above, using the Browse activity.
  • When it has downloaded, save it to your Journal.
  • Go to your Journal, click on the Read.xo activity, and choose "Resume".
  • The read activity should now be installed.

Media to try on the reader

  • To read a document, download the document to your Journal, then Resume it using the Read activity.

Screenshots

Coming soon

Development

Functional Test

Basic

  • Open the browser window and go to the library or content url (not sure exactly how this will work yet).
  • Double click on a book from the library directory.
  • Ensure that the file scrolls properly using the scroll keys and the up/down arrow keys.
  • Ensure that the image rotates with the rotate button and continues to scroll with the gamepad keys.
  • Ensure that zoom works: change the zoom 'Zoom to fit', 'Zoom to width' and 'Actual size', use the zoom controls to zoom to 95% and then 150%
  • Ensure next/previous page work; stay on a page other than page 1.
  • Close the activity; ensure that it closes properly.
  • Resume the activity from the Journal
  • Check that the page number and the zoom level are still what they were before closing (The page position may not be exactly the same as before, but should be on the same page number).

Secondary

  • Share the book with another XO.
  • Ensure that both people can read the book.