Read Etexts: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
(use the template)
 
(112 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Activity migrated to sl.o
{{Translations}}
| download=http://activities.sugarlabs.org/sugar/addon/4035

| git=http://git.sugarlabs.org/projects/readetexts
{{Olpcboxtop|toptext=[[{{PAGENAME}}|Read Etexts]]}}
| homepage=http://wiki.sugarlabs.org/go/Activities/Read_Etexts
{{ OBX activity |[[Image:readetexts.svg]]||2=extra|Version 1 }}
{{ OBX source dev|activities/readetexts}}
| icon=[[Image:readetexts.png]]
}}
{{ OBX test |[[Tests/ReadEtexts|Read ETexts]]<!--|2007-09-18--> }}
{{ OBX devtickets |readetexts}}
{{ OBX pootle|}}
{{ OBX team |[[User:Jdsimmons|James Simmons]]}}
{{ OBX mimetypes |text|plain|application|zip }}
<small>see more [[:Category:OBX templates|templates]] or [[OBX proposals|propose new]]</small>
{{Olpcboxbottom}}


==Description & Goals==
{{Users}}

===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 [[:Image:Read-42.xo|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 [http://wiki.laptop.org/go/Journal#External_storage_devices external storage device].

A selection of out-of-copyright books in PDF format is available at [http://www.gutenberg.org/catalog/world/results?lang=en&filetype=pdf&pageno=1 Project Gutenberg with this search].

Other Project Gutenberg texts can be converted to PDFs and downloaded at [http://manybooks.net/ ManyBooks.net].

{{Developers}}
===Source===

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

===Executable .xo files===

* [[media:ReadEtexts-1.xo|ReadEtexts.xo]] v.1

===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.

[[Category:Software]]
[[Category:Developers]]
[[Category:Sugar]]

Latest revision as of 07:16, 19 June 2009

?Sugar icon}}    This activity is now hosted at the Sugar Activity Library.

The information here is likely to be out-of-date. Consult the new pages for "Read Etexts" first: