aboutsummaryrefslogtreecommitdiff
path: root/docs/source/man/lesana-show.rst
diff options
context:
space:
mode:
authorElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2020-10-01 23:30:04 +0200
committerElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2020-10-01 23:30:04 +0200
commitea9af6f5521c86a8529d75db91455e8982e1d77f (patch)
treecb21c405b0ca6d425a966660be5b02a0c3c97469 /docs/source/man/lesana-show.rst
parent5e045d665f5057d3111939c1fa13133e53d7fb8d (diff)
parente3e1aac99ff15ef99ac6d3fd8539492a2c4801be (diff)
Merge branch 'master' into types
Diffstat (limited to 'docs/source/man/lesana-show.rst')
-rw-r--r--docs/source/man/lesana-show.rst45
1 files changed, 45 insertions, 0 deletions
diff --git a/docs/source/man/lesana-show.rst b/docs/source/man/lesana-show.rst
new file mode 100644
index 0000000..516f9de
--- /dev/null
+++ b/docs/source/man/lesana-show.rst
@@ -0,0 +1,45 @@
+===========
+lesana-show
+===========
+
+-------------------
+show a lesana entry
+-------------------
+
+:Author: valhalla@trueelena.org
+:Manual section: 1
+
+SYNOPSIS
+========
+
+lesana show [--help] [--collection COLLECTION] [--template TEMPLATE] <entry>
+
+DESCRIPTION
+===========
+
+``lesana show`` will print an entry (specified by id or partial id) to
+stdout.
+
+A template can be specified with ``--template <template>`` to pretty
+print entries.
+
+OPTIONS
+=======
+
+-h, --help
+ Prints an help message and exits.
+--collection COLLECTION, -c COLLECTION
+ The collection to work on. Default is ``.``
+--template TEMPLATE, -t TEMPLATE
+ Use the specified template to display results.
+
+TEMPLATES
+=========
+
+The templates used by ``lesana show`` are jinja2 templates.
+
+The entry fields are available as variables, and the full entry is
+available as the variable ``entry`` and can be used to give access to
+fields with names that aren't valid jinja2 variables e.g. as
+``entry.data[<field-name>]``.
+