Cutlery/calibre
1
0
Fork 0
mirror of https://github.com/kovidgoyal/calibre.git synced 2025-07-09 03:04:10 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add a section on searching to the viewer section in the manual

Browse Source
This commit is contained in:
Kovid Goyal 2022-08-08 13:44:00 +05:30
parent b474ba82b0
commit 5b59008313
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
manual/viewer.rst
View File

@ -159,6 +159,38 @@ behavior`.
make all voices visible
<https://www.mobileread.com/forums/showpost.php?p=4084051&postcount=108>`_.
Searching the text
--------------------------
The viewer has very powerful search capabilities. Press the :kbd:`Ctrl+F` key
or access the viewer controls and click search. The simplest form of searching is
to just search for whatever text you enter in the text box. The different forms
of searching are chosen by the search mode box below the search input.
Available modes are:
#. :guilabel:`Contains` - The simplest default mode. The text entered in the search box
is searched for anywhere. All punctuation, accents and spaces are ignored.
For example, the search: ``Pena`` will match all of the following:
``penal, pen a, pen.a and Peña``. If you select the :guilabel:`Case sensitive` box
then accents, spaces and punctuation are no longer ignored.
#. :guilabel:`Whole words` - Searches for whole words. So for example, the search
``pena`` will patch the word ``Peña`` but not the word ``Penal``. As with,
:guilabel:`Contains` searches above, accents and punctuation are ignored
unless the :guilabel:`Case sensitive` box is checked.
#. :guilabel:`Nearby words` - Searches for whole words that are near each other. So for example,
the search ``calibre cool`` will match places where the words ``calibre``
and ``cool`` occur within sixty characters of each other. To change the
number of charcters add the new number to the end of the list of words. For
instance, ``calibre cool awesome 120`` will match places where the three
words occur within 120 characters of each other.
#. :guilabel:`Regex` - Interprets the search text as a *regular expression*.
To learn more about using regular expressions, see :doc:`the tutorial
<regexp>`.
Following links using only the keyboard
-----------------------------------------------