.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LESANA-SEARCH" "1" "May 26, 2022" "0.10" "lesana"
.SH NAME
lesana-search \- search inside a lesana collection
.SH SYNOPSIS
.INDENT 0.0
.TP
.B lesana search [–help] [–collection COLLECTION] [–template TEMPLATE] 
[–offset OFFSET] [–pagesize PAGESIZE] [–all] [–expand\-query\-template] [–sort FIELD1 [–sort FIELD2 …]] [query [query …]]
.UNINDENT
.SH DESCRIPTION
.sp
Lesana search allows one to make searches in the collection and render
the results.
.sp
The section \fI\%Search syntax\fP in the full documentation describes
the query syntax in more detail; it is available online at
\fI\%https://lesana.trueelena.org/user/search.html\fP or it may be installed on
your system (e.g. in Debian and derivatives it will be at
\fB/usr/share/doc/lesana/html/user/search.html\fP).
.sp
By default entries are printed according to the \fBentry_label\fP from the
\fBsettings.yaml\fP file, but they can be rendered according to a jinja2
template.
.sp
If no query is specified, it will default to \fB\(aq*\(aq\fP, i.e. search all
entries: thus \fBlesana search \-\-all\fP will print all entries, while just
\fBlesana search\fP will print the first 12 entries, possibly according to
the relevant sorting options.
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
Prints an help message and exits.
.TP
.BI \-\-collection \ COLLECTION\fR,\fB \ \-c \ COLLECTION
The collection to work on. Default is \fB\&.\fP
.TP
.BI \-\-template \ TEMPLATE\fR,\fB \ \-t \ TEMPLATE
Template to use when displaying results
.TP
.BI \-\-offset \ OFFSET
\&.
.TP
.BI \-\-pagesize \ PAGESIZE
\&.
.TP
.B  \-\-all
Return all available results
.TP
.B  \-\-sort
Sort the results by a sortable field.
.sp
This option can be added multiple times; prefix the name of the field
with \fB\-\fP to reverse the results (e.g. \fB\-\-sort=\(aq\-date\(aq\fP).
.UNINDENT
.INDENT 0.0
.TP
.B expand\-query\-template
Render search_aliases in the query as a jinja2 template
.UNINDENT
.SH AUTHOR
valhalla@trueelena.org
.SH COPYRIGHT
2020-2022, Elena Grandi
.\" Generated by docutils manpage writer.
.