LESANA-SEARCH(1)

📦
version 0.10.1 · 5 versions
, in debian trixie, ubuntu questing

💖 NAME 💖

lesana-search — bestie, this is the one that lets you search inside a lesana collection. That's it. That's the whole job. And it slays at it. ✨

🎀 SYNOPSIS 🎀

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

🦋 DESCRIPTION 🦋

Okay so. lesana search is literally how you go digging through your collection and then render the results. Search + pretty output. Chef's kiss. 👑

The whole query syntax situation? That's broken down in detail in the Search syntax section of the full documentation. You can find it online right here:

https://lesana.trueelena.org/user/search.html

…or it might already be installed on your system. For example, on Debian and its derivatives, you'll find it at:

/usr/share/doc/lesana/html/user/search.html

So no excuses, the docs are right there. 💅

By default, entries get printed according to the entry_label from your settings.yaml file. But — plot twist — you can also render them through a jinja2 template instead. Fancy. We love options. 🌸

And if you don't give it a query at all? It defaults to '*', which means search everything. So:

  • lesana search --all → prints all the entries, the whole collection, the entire buffet 🍓
  • lesana search → prints just the first 12 entries, possibly following whatever relevant sorting options you threw in there

✨ OPTIONS ✨

  • -h, --help — prints a help message and then dips out. Exit stage left. 🚪
  • --collection COLLECTION, -c COLLECTION — the collection you wanna work on. Default is . (yes, just a dot, the current directory, it's giving "right here, bestie"). 📍
  • --template TEMPLATE, -t TEMPLATE — the template to use when showing off your results. ✨
  • --offset OFFSET — . (that's all the manpage gives us, bestie, we're keeping it 100 — literally a period) 🙈
  • --pagesize PAGESIZE — . (again, a whole period. iconic of it, honestly) 💀
  • --all — returns all available results. The full haul. No crumbs left behind. 🔥
  • --sort — sorts the results by a sortable field.

You can stack this option multiple times, go off 👯. And if you prefix the field name with -, it reverses the results — like this, for example: --sort='-date'. Backwards but make it fashion. 💅

  • --expand-query-template — renders search_aliases in the query as a jinja2 template. 🧚

👑 AUTHOR 👑

valhalla@trueelena.org
2020-2021, Elena Grandi

And that's the whole page, bestie! This manual page is from version 0.10, and it was dated Jan 29, 2025 — so if you're reading this way later, maybe go check for a glow-up. Mwah! 💖✨🎀

📦 where this page comes from