.\" 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" "1" "May 26, 2022" "0.10" "lesana"
.SH NAME
lesana \- manages collection inventories
.SH SYNOPSIS
.sp
lesana [–help] <command>
.SH DESCRIPTION
.sp
lesana is a tool to organize collections of various kinds.  It is
designed to have a data storage / serialization format that is friendly
to git and other VCSs, but decent performances.
.sp
To reach this aim it uses \fI\%yaml\fP as its serialization format, which is
easy to store in a VCS, share between people and synchronize between
different computers, but it also keeps an index of this data in a local
\fI\%xapian\fP database in order to allow for fast searches.
.sp
lesana supports collections of any kind, as long as their entries can be
described with a mostly flat dictionary of fields of the types described
in the documentation file \fBfield_types\fP\&.
.sp
Some example collection schemas are provided, but one big strength of
lesana is the ability to customize your collection with custom fields
either by simply writing a personalized \fBsettings.yaml\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
Prints an help message and exits.
.UNINDENT
.SH COMMANDS
.INDENT 0.0
.TP
.B new(1)
Creates a new entry.
.TP
.B edit(1)
Edits an existing entry.
.TP
.B show(1)
Shows an existing entry.
.TP
.B index(1)
Index some entries in the xapian cache.
.TP
.B search(1)
Searches for entries in the xapian cache.
.TP
.B export(1)
Exports entries from one lesana collection to another
.TP
.B init(1)
Initialize a new lesana collection
.TP
.B rm(1)
Removes an entry.
.UNINDENT
.SH TEXT EDITOR
.sp
Many lesana subcommands will try to open files in a text editor chosen
as follows:
.INDENT 0.0
.IP \(bu 2
first, the value of $EDITOR is tried
.IP \(bu 2
then the command \fBsensible\-editor\fP, as available under e.g. Debian
and its derivatives
.IP \(bu 2
lastly, it will try to fallback to \fBvi\fP, which should be available
under any posix system.
.UNINDENT
.SH AUTHOR
valhalla@trueelena.org
.SH COPYRIGHT
2020-2022, Elena Grandi
.\" Generated by docutils manpage writer.
.