Update d/changelog for release 2.5.3-1
[pkg-a11y/ebook-speaker.git] / debian / README.testing
1 This document describes how one could quickly test if a new package works
2 resonably well. The idea was posted on
3 http://lists.debian.org/debian-accessibility/2013/10/msg00026.html
4
5 eBook-speaker actually can read you any text (including OCR). So far, I
6 only test it with real ebook. I suggest to download a legally free book,
7 e.g. some work from Edgar Allan Poe:
8 http://www.gutenberg.org/ebooks/32037
9 http://openlibrary.org/books/OL7044543M/The_works_of_Edgar_Allan_Poe.
10
11 eBook-speaker needs a console, so start it in a terminal window. You can
12 run eBook-speaker straight without input and it should show you your
13 current directory listing. Moving up and down should allow you to select
14 any file. eBook-speaker is made for 24 lines x 80 chars, if your window
15 is smaller, text might appear funny. Also, I try to keep the packaging
16 such that both ebook-speaker and eBook-speaker work. The former form is
17 preferred by me, the latter by the author of eBook-speaker.
18
19 paul@wollumbin ~/ $ ebook-speaker
20
21 - You should get a screen with two info lines of eBook-speaker and then
22   the content of directory where you started eBook-speaker.
23 - Pressing h should bring you the help, then pressing any key should
24   return you to the normal screen.
25 - Pressing Cursor Down should scroll down to the next file
26 - Pressing enter should start the reading and you should be able to hear
27   the text.
28 - Hitting q should quite gracefully.
29
30 paul@wollumbin ~/ $ ebook-speaker Old_World_Romances.epub
31
32 - You should get a screen with the content of the book. You will only
33   see at maximum the first 22 chapters of the book even if there are more.
34 - Hitting q should quite gracefully.
35 - Restarting eBook-speaker as before should start where you were the last
36   time you "read" this book.
37
38 eBook-speaker stores it's current configuration in ~/.eBook-speaker.xml
39 and places bookmarks in ~/.eBook-speaker/ You might want to backup/remove
40 those to restore default settings. (Don't edit while eBook-speaker is
41 running or it will be overwritten.)
42
43 Lastly, testing if the translations still work is also nice:
44 paul@wollumbin ~/ $ LANGUAGE=nl_NL eBook-speaker