Clarify %if template behavior

Closes #4991
This commit is contained in:
Emil Hammarberg 2026-02-27 17:37:58 +01:00 committed by Šarūnas Nejus
parent 6ef2a8cb0d
commit 654b76190c

View file

@ -64,7 +64,9 @@ These functions are built in to beets:
- ``%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).
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".
- ``%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.