This commit is contained in:
Emil Hammarberg 2026-03-03 12:43:27 +01:00 committed by Šarūnas Nejus
parent 654b76190c
commit 8a57472224

View file

@ -62,11 +62,9 @@ These functions are built in to beets:
- ``%left{text,n}``: Return the first ``n`` characters of ``text``.
- ``%right{text,n}``: Return the last ``n`` characters of ``text``.
- ``%if{condition,text}`` or ``%if{condition,truetext,falsetext}``: If
``condition`` is nonempty (or nonzero, if it's a number), then returns the
second argument. Otherwise, returns the third argument if specified (or
nothing if ``falsetext`` is left off). Note that beets doesn't distinguish
between different data types, so ``%if{album,album/}`` evaluates as false for
albums named exactly "0".
``condition`` is none of ```` (an empty string), ``0``, or ``false`` (case
insensitive), then returns the second argument. Otherwise, returns the third
argument if specified (or nothing if ``falsetext`` is left off).
- ``%asciify{text}``: Convert non-ASCII characters to their ASCII equivalents.
For example, "café" becomes "cafe". Uses the mapping provided by the
`unidecode module`_. See the :ref:`asciify-paths` configuration option.