Update the viewer section of the User Manual

This commit is contained in:
Kovid Goyal 2019-10-25 21:29:22 +05:30
parent 99ce8f9876
commit a33fe3f671
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
10 changed files with 73 additions and 59 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 959 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.5 KiB

View File

@ -3,8 +3,8 @@
The E-book viewer The E-book viewer
============================= =============================
calibre includes a built-in E-book viewer that can view all the major e-book formats. calibre includes a built-in E-book viewer that can view all the major e-book formats.
The E-book viewer is highly customizable and has many advanced features. The E-book viewer is highly customizable and has many advanced features.
.. contents:: .. contents::
:depth: 1 :depth: 1
@ -13,97 +13,111 @@ The E-book viewer is highly customizable and has many advanced features.
Starting the E-book viewer Starting the E-book viewer
----------------------------- -----------------------------
You can view any of the books in your calibre library by selecting the book and pressing the :guilabel:`View` button. This You can view any of the books in your calibre library by selecting the book and
will open up the book in the E-book viewer. You can also launch the E-book viewer by itself from the Start menu in Windows pressing the :guilabel:`View` button. This will open up the book in the E-book
or using the command :command:`ebook-viewer` in Linux and macOS (you have to install the command line tools on macOS viewer. You can also launch the E-book viewer by itself from the Start menu in
first by going to :guilabel:`Preferences->Advanced->Miscellaneous`). Windows. On macOS, you can pin it to the dock and launch it from there. On
Linux you can use its launcher in the desktop menus or run the command
:command:`ebook-viewer`.
Navigating around an e-book Navigating around an e-book
----------------------------- -----------------------------
.. |prev| image:: images/previous.png You can "turn pages" in a book by either:
.. |next| image:: images/next.png - Clicking in the left or right margin or the page with the mouse
- Pressing the :kbd:`spacebar`, :kbd:`page up`, :kbd:`page down` or arrow keys
.. |scroll| image:: images/scroll.png - On a touchscreen tapping on the text or swiping left and right
.. |bookmi| image:: images/bookmark.png
.. |toci| image:: images/toc.png
.. |navposi| image:: images/nav_pos.png
.. |refmi| image:: images/ref_mode_button.png
You can "turn pages" in a book by using the :guilabel:`Page previous` |prev| and :guilabel:`Page next` |next| buttons, or by pressing You can access the viewer controls by either:
the :guilabel:`Page down`/:guilabel:`Page up` keys. Unlike most e-book viewers, calibre does not force you to view books in paged mode.
You can switch to flow mode by clicking on the scroll mode button |scroll| at the top right. You can then scroll by amounts less than a page - Right clicking on the text
by using the scroll bar or various customizable keyboard shortcuts. - Pressing the :kbd:`Esc` or :kbd:`Menu` keys
- On a touchscreen by tapping the top 1/3rd or the screen
The viewer has two modes, "paged" and "flow". In paged mode the book content
is presented as pages, similar to a paper book. In flow mode the text is
presented continuously, like in a web browser. You can switch between them
using the viewer Preferences under :guilabel:`Page layout` or by pressing the
:kbd:`ctrl+m` key.
Bookmarks Bookmarks
^^^^^^^^^^^^ ^^^^^^^^^^^^
When you are in the middle of a book and close the viewer, it will remember where you stopped reading and return there When you are in the middle of a book and close the viewer, it will remember
the next time you open the book. You can also set bookmarks in the book by using the :guilabel:`Bookmark` button |bookmi|. When viewing EPUB format where you stopped reading and return there the next time you open the book. You
books, these bookmarks are actually saved in the EPUB file itself. You can add bookmarks, then send the file to a friend. can also set bookmarks in the book by using the :guilabel:`Bookmarks` button in
When they open the file, they will be able to see your bookmarks. the viewer controls or pressing :kbd:`ctrl+b`. When viewing EPUB format books,
these bookmarks are actually saved in the EPUB file itself. You can add
bookmarks, then send the file to a friend. When they open the file, they will
be able to see your bookmarks. You can turn off this behavior in the
:guilabel:`Miscellaneous` section of the viewer preferences.
Table of Contents Table of Contents
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
If the book you are reading defines a Table of Contents, you can access it by pressing the :guilabel:`Table of Contents` button |toci|. If the book you are reading defines a Table of Contents, you can access it by
This will bring up a list of sections in the book. You can click on any of them to jump to that portion of the book. pressing the :guilabel:`Table of Contents` button. This will bring up a list
of sections in the book. You can click on any of them to jump to that portion
of the book.
Navigating by location Navigating by location
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
E-books, unlike paper books, have no concept of pages. Instead, E-books, unlike paper books, have no concept of pages. You can refer to precise
as you read through the book, you will notice that your position in the book is displayed in the upper left corner in a box locations in e-books using the :guilabel:`Go to->Location` functionality in the
like this |navposi|. This is both your current position and the total length of the book. These numbers are independent of the screen size and font viewer controls.
size you are viewing the book at, and they play a similar role to page numbers in paper books.
You can enter any number you like to go to the corresponding location in the book.
calibre also has a very handy You can use this location information to unambiguously refer to parts of the
reference mode. You can turn it on by clicking the :guilabel:`Reference mode` button |refmi|. Once you do this, every time you move your books when discussing it with friends or referring to it in other works. You
mouse over a paragraph, calibre will display a unique number made up of the section and paragraph numbers. can enter these locations under :guilabel:`Go to->Location` in the viewer
controls.
.. image:: images/ref_mode.png If you click on links inside the e-book to take you to different parts of the
:align: center book, such as an endnote, you can use the :guilabel:`Back` and
:guilabel:`Forward` buttons in the top left corner of the viewer controls.
You can use this number to unambiguously refer to parts of the books when discussing it with friends or referring to it These buttons behave just like those in a web browser.
in other works. You can enter these numbers in the box marked Go to at the top of the window to go to a particular
reference location.
If you click on links inside the e-book to take you to different parts of the book, such as an endnote, you can use the :guilabel:`Back` and :guilabel:`Forward` buttons
in the top left corner to return to where you were. These buttons behave just like those in a web browser.
Customizing the look and feel of your reading experience Customizing the look and feel of your reading experience
------------------------------------------------------------ ------------------------------------------------------------
.. |fontsizei| image:: images/font_size.png You can change font sizes on the fly by using :guilabel:`Font size` in the viewer controls or
:kbd:`Ctrl++` or :kbd:`Ctrl+-` or holding the :kbd:`Ctrl` key and using the
mouse wheel.
.. |fsi| image:: images/full_screen.png Colors can be changed in the :guilabel:`Colors` section of the viewer
preferences.
.. |prefbi| image:: images/pref_button.png You can change the number of pages displayed on the screen as well as page
margins in :guilabel:`Page layout` in the viewer preferences.
You can change font sizes on the fly by using the font size buttons |fontsizei|. You can also make the viewer full screen You can display custom headers and footers such as time left to read, current
by pressing the Full Screen button |fsi|. By clicking the Preferences button |prefbi|, you can change the default fonts used chapter title, book position, etc. via the :guilabel:`Headers and footers`
by the viewer to ones you like as well as the default font size when the viewer starts up. section of the viewer preferences.
More advanced customization can be achieved by the :guilabel:`User stylesheet` setting. This is a stylesheet you can set that will be applied More advanced customization can be achieved by the :guilabel:`Styles` settings.
to every book. Using it you can do things like have white text on a black background, change paragraph styles, text justification, etc. Here you can specify a background image to display under the text and also a
For examples of custom stylesheets used by calibre's users, see `the forums <https://www.mobileread.com/forums/showthread.php?t=51500>`_. stylesheet you can set that will be applied to every book. Using it you can do
things like change paragraph styles, text justification, etc. For examples of
custom stylesheets used by calibre's users, see `the forums
<https://www.mobileread.com/forums/showthread.php?t=51500>`_.
Dictionary lookup Dictionary lookup
------------------- -------------------
You can look up the meaning of words in the current book by right clicking on a word. calibre uses the publicly available dictionary You can look up the meaning of words in the current book by opening the
server at ``dict.org`` to look up words. The definition is displayed in a small box at the bottom of the screen. :guilabel:`Lookup/search panel` via the viewer controls. Then simply double
click on any word and its definition will be displayed in the lookup panel.
Copying text and images Copying text and images
------------------------- -------------------------
You can select text and images by dragging the content with your mouse and then right clicking to copy to the clipboard. You can select text and images by dragging the content with your mouse and then
The copied material can be pasted into another application as plain text and images. right clicking and selecting "Copy" to copy to the clipboard. The copied
material can be pasted into another application as plain text and images.