summaryrefslogtreecommitdiff
path: root/docs/source/man/lesana-search.rst
blob: 0f2861cfb5bec454cde0bba54b49eb7ff7ceb9b4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
=============
lesana-search
=============

SYNOPSIS
========

lesana search [--help] [--collection COLLECTION] [--template TEMPLATE] \
  [--offset OFFSET] [--pagesize PAGESIZE] [--all] \
  [--sort FIELD1 [--sort FIELD2 ...]] query [query ...]

DESCRIPTION
===========

Lesana search allows one to make searches in the collection and render
the results.

The section :doc:`/user/search` in the full documentation describes
the query syntax in more detail; it is available online at
https://lesana.trueelena.org/user/search.html or it may be installed on
your system (e.g. in Debian and derivatives it will be at
``/usr/share/doc/lesana/html/user/search.html``).

By default entries are printed according to the ``entry_label`` from the
``settings.yaml`` file, but they can be rendered according to a jinja2
template.

OPTIONS
=======

-h, --help
   Prints an help message and exits.
--collection COLLECTION, -c COLLECTION
   The collection to work on. Default is ``.``
--template TEMPLATE, -t TEMPLATE
   Template to use when displaying results
--offset OFFSET
   .
--pagesize PAGESIZE
   .
--all
   Return all available results
--sort
   Sort the results by a sortable field.

   This option can be added multiple times; prefix the name of the field
   with ``-`` to reverse the results (e.g. ``--sort='-date'``).