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

Documentation for the vl: search location

Browse Source
This commit is contained in:
Charles Haley 2017-08-19 22:09:12 +02:00
parent 622833eb05
commit da46a3c438
2 changed files with 24 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
manual/gui.rst
View File

@ -359,7 +359,7 @@ You can build advanced search queries easily using the :guilabel:`Advanced searc
clicking the button |sbi|. clicking the button |sbi|.
Available fields for searching are: ``tag, title, author, publisher, series, series_index, rating, cover, Available fields for searching are: ``tag, title, author, publisher, series, series_index, rating, cover,
comments, format, identifiers, date, pubdate, search, size`` and custom columns. If a device is plugged in, the ``ondevice`` field becomes available, when searching the calibre library view. To find the search name (actually called the `lookup name`) for a custom column, hover your mouse over the column header in the library view. comments, format, identifiers, date, pubdate, search, size, vl`` and custom columns. If a device is plugged in, the ``ondevice`` field becomes available, when searching the calibre library view. To find the search name (actually called the `lookup name`) for a custom column, hover your mouse over the column header in the library view.
The syntax for searching for dates is:: The syntax for searching for dates is::
@ -400,6 +400,12 @@ The special field ``search`` is used for saved searches. So if you save a search
"My spouse's books" you can enter ``search:"My spouse's books"`` in the Search bar to reuse the saved "My spouse's books" you can enter ``search:"My spouse's books"`` in the Search bar to reuse the saved
search. More about saving searches below. search. More about saving searches below.
The special field ``vl`` is used to search for books in a virtual library. For
example, ``vl:Read`` will find all the books in the Read virtual library. The search
``vl:Read and vl:"Science Fiction"`` will find all the books that are in both the Read and
Science Fiction virtual libraries. The value following ``vl:`` must be the name of a
virtual library. If the virtual library name contains spaces then surround it with quotes.
You can search for the absence or presence of a field using the special "true" and "false" values. For example:: You can search for the absence or presence of a field using the special "true" and "false" values. For example::
cover:false will give you all books without a cover cover:false will give you all books without a cover

17
manual/virtual_libraries.rst
View File

@ -95,6 +95,23 @@ virtual libraries as tabs`. You can re-arrange the tabs by drag and drop and
close ones you do not want to see. Closed tabs can be restored by close ones you do not want to see. Closed tabs can be restored by
right-clicking on the tab bar. right-clicking on the tab bar.
Using Virtual libraries in searches
-------------------------------------
You can search for books that are in a virtual library using the ``vl:`` prefix. For
example, ``vl:Read`` will find all the books in the Read virtual library. The search
``vl:Read and vl:"Science Fiction"`` will find all the books that are in both the Read and
Science Fiction virtual libraries.
The value following ``vl:`` must be the name of a virtual library. If the virtual library name
contains spaces then surround it with quotes.
One use for a virtual library search is in the content server. In
:guilabel:`Preferences->Sharing over the net->Require username/password` you can limit the
calibre libraries visible to a user. For each visible library you can specify
a search expression to further limit which books are seen. Use ``vl:...`` to limit the books
to those in a virtual library.
Using additional restrictions Using additional restrictions
------------------------------- -------------------------------