Read Etexts: Difference between revisions
Jump to navigation
Jump to search
(use the template) |
|||
| (111 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 }} |
|||
| 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 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. |
|||
[[http://www.gutenberg.org/wiki/Main_Page 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. |
|||
== 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: |