Man page - lesana(1)

Packages contas this manual

Manual

LESANA(1) lesana LESANA(1)

lesana - manages collection inventories

lesana [–help] <command>

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.

To reach this aim it uses yaml 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 xapian database in order to allow for fast searches.

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 field_types.

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 settings.yaml.

Prints an help message and exits.

Creates a new entry.
Edits an existing entry.
Shows an existing entry.
Index some entries in the xapian cache.
Searches for entries in the xapian cache.
Exports entries from one lesana collection to another
Initialize a new lesana collection
Removes an entry.

Many lesana subcommands will try to open files in a text editor chosen as follows:

  • first, the value of $EDITOR is tried
  • then the command sensible-editor, as available under e.g. Debian and its derivatives
  • lastly, it will try to fallback to vi, which should be available under any posix system.

valhalla@trueelena.org

2020-2021, Elena Grandi

January 29, 2025 0.10