Read Etexts

From OLPC
Revision as of 11:51, 6 March 2008 by Jdsimmons (talk | contribs) (Source)
Jump to: navigation, search
  english | español한국어 HowTo [ID# 115132]  +/-  


Readetexts.svg
Version 1
Trac print.png Tickets all - active - new
Translate-icon-55px.svg Pootle Localization
.POT file NEEDED
mime plain, zip

see more templates or propose new


Description & Goals

  For the general public

The Read Etexts activity is meant to allow the XO laptop to read Project Gutenberg ETexts, which are plain text files. The core Read activity will eventually support this, so you can consider this activity to be a useful stopgap.

The interface to Read Etexts is very similar to the core Read activity, which should not be surprising as the toolbar code was adapted from Read's toolbar.

[Project Gutenberg] is a website where you can download thousands of public domain books for free. There are books for every interest: classics, history, childen's novels, science fiction, and much, much more.

Read ETexts can read books in plain text format or in Zip format. These are by far the most popular formats on the Gutenberg website. If you are downloading books using the Browse activity you should download one of the Zip file formats. This can be encoded as us-ascii text or as iso-8859-1; Read Etexts can handle either one. The iso-8859-1 encoding is used for books that need accent marks, etc. Save the Zip file to the Journal, change the Journal entry name to match the title of the book, and then resume it using the Read Etexts option on the Resume menu.


Source

http://dev.laptop.org/git?p=activities/readetexts

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.