From 372d21728ef9c94c07c24887cbbe5de012195a73 Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Wed, 28 Oct 2020 16:14:23 +0100 Subject: Basic search documentation --- docs/source/user/search.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/source/user/search.rst (limited to 'docs/source/user/search.rst') diff --git a/docs/source/user/search.rst b/docs/source/user/search.rst new file mode 100644 index 0000000..41746a3 --- /dev/null +++ b/docs/source/user/search.rst @@ -0,0 +1,24 @@ +*************** + Search syntax +*************** + +Searches in lesana use the human readable query string format defined by +xapian. + +The simplest search is just a list of terms: e.g. searching for +``thing object`` will find entries where either ``thing`` or ``object`` +is present in one of the fields with ``free`` indexing. + +It is also possible to specify that a term must be in one specific +field: the syntax for this is the name of the field follwed by ``:`` and +the term, e.g. ``name:object`` will search for entries with the term +``object`` in the ``name`` field. + +Search queries can of course include the usual logical operators +``AND``, ``OR`` and ``NOT``. + +More modifiers are available; see the `Query Parser`_ documentation from +xapian for details. + +.. _`Query Parser`: https://getting-started-with-xapian.readthedocs.io/en/latest/concepts/search/queryparser.html + -- cgit v1.2.3