WebOS Internals - User contributions [en]

EBook-Reader

2009-09-11T13:13:52Z

Stickywhipit: /* Data Issues */

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons: [[Image: Scene1.png|thumb|right]]

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
## .lit
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
## page turn on screen tap option
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented
# Support for rotation
## Portrait and Landscape views (at least for the reading screen)
## Auto adjust gesture orientation to match view
## Include a rotation "lock" to prevent unwanted rotations (or just ignore the accelerometer and make it a button or gesture controlled rotation)

===Data Structure===

'''Table: Catalog'''
* catalogId: (globally unique ID - a system generated number)
* Title: string
* Author: string
* Genre: string
* catalogType: (B,S - book or series)
* ShelfId:
* CoverImage: Filename
* Encrypted: boolean
* Format: string (book format)

'''Table: BookSeries'''
* bookseriesId: (globally unique ID - a system generated number)
* catSeriesId: (must be present in book table and the catType must be 'S')
* catBookId: (must be present in book table and the catType must be 'B')

'''Table: Bookmarks'''
* bkmkId:
* bookId: (must be present in book table)
* Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: BookShelf'''
* shelfId:
* ShelfName:
* ShelfOrder: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
* shelfId:
* bookId:
* position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
* BookId:
* BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?
** Correct me if i am wrong, but the current SDK does not allow for writing files to the file system, so the database would be the best and sort-of only way to do it. Also, the ajax request is a little slow, the database might show better performance loading.

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
** '''No.'''
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
** '''Perhaps.''' plucker decoding sources in JAVA at http://www.fbreader.org/downloads.php
** Possible ePub since it's basically XHTML?
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?
** on pc app
** some scripts found so far:
*** ereader2html -- python app, same as plucker converters.
*** pdbshred -- Binary app for unencrypting secure palm reader pdb's. Sorry.
*** (include others as you find them)
* Has anyone found a free and open source method to unzip files or data streams in javascript??
** all i have found is a page that refers to the huffman compression technique (http://rumkin.com/tools/compression/compress_huff.php), but i don't know if that is how epub files are zipped and i don't know if we can get our hands on the source.
**: note that this page says that compressing 15K takes MINUTES... ooops. :-( Not going to work

EBook-Reader

2009-08-14T16:49:27Z

Stickywhipit: /* Data Structure */

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons:

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented

===Data Structure===

'''Table: Catalog'''
* catalogId: (globally unique ID - a system generated number)
* Title: string
* Author: string
* Genre: string
* catalogType: (B,S - book or series)
* ShelfId:
* CoverImage: Filename

'''Table: BookSeries'''
* bookseriesId: (globally unique ID - a system generated number)
* catSeriesId: (must be present in book table and the catType must be 'S')
* catBookId: (must be present in book table and the catType must be 'B')

'''Table: Bookmarks'''
* bkmkId:
* bookId: (must be present in book table)
* Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: BookShelf'''
* shelfId:
* ShelfName:
* ShelfOrder: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
* shelfId:
* bookId:
* position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
* BookId:
* BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
** '''No.'''
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
** '''Perhaps.''' plucker decoding sources in JAVA at http://www.fbreader.org/downloads.php
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?
** on pc app
* Has anyone found a free and open source method to unzip files or data streams in javascript??
** all i have found is a page that refers to the huffman compression technique (http://rumkin.com/tools/compression/compress_huff.php), but i don't know if that is how epub files are zipped and i don't know if we can get our hands on the source.

EBook-Reader

2009-08-14T16:47:53Z

Stickywhipit: /* Data Structure */

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons:

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented

===Data Structure===

'''Table: Catalog'''
* catalogId: (globally unique ID - a system generated number)
* Title: string
* Author: string
* Genre: string
* catalogType: (B,S - book or series)
* ShelfId:
* CoverImage: Filename

'''Table: BookSeries'''
* bookseriesId: (globally unique ID - a system generated number)
* catSeriesId: (must be present in book table and the catType must be 'S')
* catBookId: (must be present in book table and the catType must be 'B')

'''Table: Bookmarks'''
* bkmkId:
* bookId: (must be present in book table)
* Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: ShelfList'''
* shelfListId:
* ShelfName:
* ShelfOrder: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
* shelfid:
* bookguid:
* position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
* BookGuid:
* BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
** '''No.'''
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
** '''Perhaps.''' plucker decoding sources in JAVA at http://www.fbreader.org/downloads.php
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?
** on pc app
* Has anyone found a free and open source method to unzip files or data streams in javascript??
** all i have found is a page that refers to the huffman compression technique (http://rumkin.com/tools/compression/compress_huff.php), but i don't know if that is how epub files are zipped and i don't know if we can get our hands on the source.

EBook-Reader

2009-08-14T16:47:07Z

Stickywhipit: /* Book Format Issues */

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons:

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented

===Data Structure===

'''Table: Catalog'''
* catalogId: (globally unique ID - a system generated number)
* Title: string
* Author: string
* Genre: string
* catalogType: (B,S - book or series)
* ShelfId:
* CoverImage: Filename

'''Table: BookSeries'''
* bookseriesId: (globally unique ID - a system generated number)
* catSeriesId: (must be present in book table)
* catBookId: (must be present in book table and the catType )

'''Table: Bookmarks'''
* bkmkId:
* bookId: (must be present in book table)
* Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: ShelfList'''
* shelfListId:
* ShelfName:
* ShelfOrder: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
* shelfid:
* bookguid:
* position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
* BookGuid:
* BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
** '''No.'''
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
** '''Perhaps.''' plucker decoding sources in JAVA at http://www.fbreader.org/downloads.php
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?
** on pc app
* Has anyone found a free and open source method to unzip files or data streams in javascript??
** all i have found is a page that refers to the huffman compression technique (http://rumkin.com/tools/compression/compress_huff.php), but i don't know if that is how epub files are zipped and i don't know if we can get our hands on the source.

EBook-Reader

2009-08-14T16:46:40Z

Stickywhipit: /* Data Structure */

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons:

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented

===Data Structure===

'''Table: Catalog'''
* catalogId: (globally unique ID - a system generated number)
* Title: string
* Author: string
* Genre: string
* catalogType: (B,S - book or series)
* ShelfId:
* CoverImage: Filename

'''Table: BookSeries'''
* bookseriesId: (globally unique ID - a system generated number)
* catSeriesId: (must be present in book table)
* catBookId: (must be present in book table and the catType )

'''Table: Bookmarks'''
* bkmkId:
* bookId: (must be present in book table)
* Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: ShelfList'''
* shelfListId:
* ShelfName:
* ShelfOrder: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
* shelfid:
* bookguid:
* position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
* BookGuid:
* BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
** '''No.'''
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
** '''Perhaps.''' plucker decoding sources in JAVA at http://www.fbreader.org/downloads.php
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?
** on pc app
* !! has anyone found a free and open source method to unzip files or data streams in javascript??
** all i have found is a page that refers to the huffman compression technique (http://rumkin.com/tools/compression/compress_huff.php), but i don't know if that is how epub files are zipped and i don't know if we can get our hands on the source.

EBook-Reader

2009-08-14T14:22:18Z

Stickywhipit: /* Data Structure */

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons:

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented

===Data Structure===

'''Table: Book'''
* bookId: (globally unique ID - a system generated number)
* Title: string
* Author: string
* Genre: string
* ShelfId:
* CoverImage: Filename

'''Table: BookSeries'''
* seriesId: (globally unique ID - a system generated number)
* bookId: (must be present in book table)

'''Table: Bookmarks'''
* bkmkId:
* bookId: (must be present in book table)
* Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: ShelfList'''
* shelfListId:
* ShelfName:
* ShelfOrder: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
* shelfid:
* bookguid:
* position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
* BookGuid:
* BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
** '''No.'''
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
** '''Perhaps.''' plucker decoding sources in JAVA at http://www.fbreader.org/downloads.php
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?
** on pc app
* !! has anyone found a free and open source method to unzip files or data streams in javascript??
** all i have found is a page that refers to the huffman compression technique (http://rumkin.com/tools/compression/compress_huff.php), but i don't know if that is how epub files are zipped and i don't know if we can get our hands on the source.

EBook-Reader

2009-08-13T14:35:41Z

Stickywhipit:

===Application description from a users perspective ===
Scene 1: Splash image and 3 buttons:

.. Where I left off ... -- Opens the last book you read at the place you stopped.

.. Bookmarks ... -- opens a list of the books you have bookmarks in and lets you open them to there. -- previews 2 lines above and below bookmark.

... Library ... -- opens a scrollable page of "shelves" Each shelf has a label which is user defined, and each shelf presents the books on it as a coverflow. Books can be moved between shelves by dragging and dropping. Each shelf has a context menu to control order, title, author or user defined. If user defined menu will present shelf as a draggable list instead of a coverflow when you want to re-order books. backswipe returns to coverflow.

in either the bookmarks view, tapping a book takes you to either the bookmark or the title page. upswipe downswipe provide smooth scrolling. Left and right swipe provide page at a time scrolling. Back swipe in gesture offers to bookmark with a dialog and returns to the shelf you came from.

When on a book, top left menu presents presentation options, which can be set book by book or globally. Type face (if I can figure out how), size, leading, justification, colors etc..

Images default to no larger than 1/4 screen, but touch results in lightbox like zoom.

Menu at splash or library offers import, and delete of books. When in a shelf, books can be deleted by dragging them to the recycle.

===Features Wish List===
# on-pc conversion of various formats to pre-compatible format -probably using plucker distiller. Should support
## html
## rde
## doc
## m4b
## pdb (palm-doc)
## pdb (isilo), prc (unencrypted mobipocket)
## prc (encrypted) # lots of people with a ton of fictionwise books want this
## epub [http://en.wikipedia.org/wiki/EPUB]
## plain text
## plucker
# on Pre conversion of html and text docs by download from the cloud.
# Library supports user definable catagories for sorting and shelving
#: Shelves can be user defined to hold any collection of books a reader cares to:
#* By author
#* By Genre
#* By Geography
#* By cover color
#* By Series # very useful to group books in a series together
#: The ''user'' should define the sorting catagories. Shelf design can initially be a scroll list like the Contacts app.
# Book display page is minimally invasive making the most space available to read on as possible
# Typography is bifocal friendly. User definable print sizes, and if possible type faces.
# user defined foreground/background colors for text.
## Sepia
## Night mode
## Adjust screen brightness
# multiple bookmarks per doc.
# shallow menus
# smooth scrolling or page-at-a-time scrolling by gestures.
## plucker style button-based scrolling
## swipe gesture based scrolling
## auto-scrolling with user adjustable speed
### Pause auto-scrolling by tapping gesture area
# support for covers.
# coverflow view of shelves.
# easy rapid sorting of books onto shelves.
# Change text size
# Possibly be able to add books over Wi-Fi
# Copy & Paste words
## Dictionary search implemented

===Data Structure===

'''Table: Catalog'''
Title: string
Author: string
Shelfguid:
CoverImage: Filename
guid: (globally unique ID - a system generated number)

'''Table: Bookmarks'''
guid:
Position: ( an integer, refering to the character in the file at the top of the screen.)

'''Table: Shelves'''
guid:
ShelfName:
Shelving Order: (A, T, or U) Representing Author, Title or User Set

'''Table ShelfOrder'''
Shelfguid:
Bookguid:
Position: (integer representing the position of this book on this shelf)

'''Table: BookText'''
BookGuid:
BookText:

====Data Issues====

* This structure does not provide for books stored as chapters. This structure presumes a book is a single document. That document might have internal chapter indicators, but this structure does not divide the book up.
* This structure makes no provision for the internal storage of images.
* Should we actually store the text of the book in the DB or do we leave the book on the file system and just store a link to it?

There is some point, therefore to consider if in booktext, we want to simply store a plucker file, which CAN contain images and text intermingled.

====Book Format Issues====
* Can javascript on the device natively parse/navigate all of the above list formats?
* Can javascript on the device effectively parse/navigate the plucker format (if we settle on this one), or do we need our own format?
* Once we settle on a format, will the device be powerful enough to convert other formats to this one, or will we need a PC app to do the converting?

Patch Phone Show Call Duration in the Call Log

2009-07-27T04:32:49Z

Stickywhipit: /* Show call duration in the call log */

This page details ways to enable hidden functionality in on the palm pre. You will need root shell access to perform these changes. Follow these instructions at your own risk, if you make an error (or perhaps even if you do it correctly) you risk bricking your phone, voiding your warranty, etc. These instructions assume a working knowledge of unix. Also, note that these changes require rebooting the phone to take effect.

==== Show call duration in the call log ====
Sprint always customizes their phones to conceal call duration information. This avoids angry phone calls from confused customers who are surprised when their 1:01 phone call results in 2:00 minutes charged to their account. I can sympathize. However, I won't call complain, and I occasionally want to know how long a call was after the fact.

There is now a shell script for executing the commands below if you do not feel comfortable doing the steps below manually. See http://gitorious.org/webos-internals/modifications/commit/3b2e55a22e64b5302b5d45521ccf94fe28db3595

There is a system preference <tt>phoneAppHideCallDuration</tt> which appears to control this, but it merely provides a default value. The phone app caches the value and saves it as a cookie. As an exercise, I'll show you how to set the preference as well.

To set the <tt>phoneAppHideCallDuration</tt> preference:

<source lang="text">
[user@linuxhost]$ ssh -p 222 palm-pre
user@castle:~$ su
root@castle:/home/user# luna-send -n 1 palm://com.palm.systemservice/setPreferences '{"phoneAppHideCallDuration": false}'
** Message: serviceResponse Handling: 2, { "returnValue": true }
</source>

Here we've used <tt>luna-send</tt> to broadcast a message requesting the <tt>systemservice</tt> to set a preference (I believe you can actually specify multiple preferences at once, the payload format is a json hashtable). Unfortunately, that only sets the default, so to actually see the change we need to update a cookie stored in the phone app. We'll do that now:

<source lang="text">
root@castle:/home/user# cd /var/palm/data/
root@castle:/var/palm/data# sqlite3 cookies.db
SQLite version 3.6.1
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
sqlite> update Cookies set value = "%220%22" where domain_head = ".usr.palm.applications.com.palm." and domain_tail = "app.phone" and path = "/usr/palm/applications/com.palm.app.phone" and "name" = "mojo_cookie_hidecalllogduration";
sqlite> .exit
root@castle:/var/palm/data# exit
user@castle:~$ exit
Connection to palm-pre closed.
</source>

This time we've used <tt>sqlite3</tt> to update the cookies database directly. The primary key of the Cookies table (in the cookies database) is (domain_head, domain_tail, path, name), we specify the full key, and update the value. Note the value field is always ''percent-encoded'' and in this case represents the string <tt>"0"</tt> (including the quotes). To see your changes, reboot your phone. I've been doing this by holding the power key and turning it off, though presumably a <tt>shutdown -r</tt> would work as well (I have not tried it though).

''Note: if you are typing in the sql by hand, take care you get it correct. If you make a typo and the where portion does not match any records you will not get any feedback. To verify that your update was successful run the following SQL after your issue the update:'' <tt>select * from Cookies where domain_tail = "app.phone"</tt>

==== Enable adding / removing pages in the Launcher app ====

Please see this page for a tutorial: [[Tutorials_webOS_Add_Or_Delete_Pages_In_The_Launcher|Add Or Delete Pages In The Launcher]]

I'm guessing this was disabled due to usability concerns. Especially with the limited number of apps available right now, there's not a huge need for multiple screens, and deleting a page would result in shifting around icons, which can be a frustrating experience. I'm guessing this will be enabled in the future (perhaps on an "advanced mode" switch, or through a different UI). This time the disabling is directly in the code, there are two bits of commented-out code which we simply need to uncomment. I have intentionally not included the file here out of respect for palm's intellectual property.

<source lang="text">
[user@linuxhost]$ ssh -p 222 palm-pre
user@castle:~$ su
root@castle:/home/user# vi /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js
</source>

Once you have that file open, uncomment the two items in the <tt>items</tt> array defined on line 30. Then scroll down to line 125 in the <tt>handleCommand</tt> function and uncomment the two commented out cases in the switch statement. Save the file, and reboot. You should have two new menu options, "New Page" and "Delete Page". It looks like the code will not let you delete your last page, but I wouldn't try it.

Verified to run as written by optik678.