diff --git a/docs/reference/pathformat.rst b/docs/reference/pathformat.rst index 0108bcc56..730885035 100644 --- a/docs/reference/pathformat.rst +++ b/docs/reference/pathformat.rst @@ -80,7 +80,7 @@ These functions are built in to beets: .. _strftime: http://docs.python.org/2/library/time.html#time.strftime Plugins can extend beets with more template functions (see -:ref:`writing-plugins`). +:ref:`templ_plugins`). .. _aunique: @@ -158,7 +158,7 @@ Available Values Here's a list of the different values available to path formats. The current list can be found definitively by running the command ``beet fields``. Note that plugins can add new (or replace existing) template values (see -:ref:`writing-plugins`). +:ref:`templ_plugins`). Ordinary metadata: @@ -227,3 +227,22 @@ Library metadata: * mtime: The modification time of the audio file. * added: The date and time that the music was added to your library. + +.. _templ_plugins: + +Template functions and values provided by plugins +------------------------------------------------- + +Remember to activate corresponding plugin before using one of those additional +fields/functions : + +* missing by :doc:`/plugins/missing`: number of missing tracks per album +* ``%the{text}`` by :doc:`/plugins/the`: moves english articles to end of + strings + +In case you would need a field not mentioned hereabove, +:doc:`/plugins/inline` lets you define template fields in your beets +configuration file using python snippets. +And for more advanced processing, you can go all-in and write a dedicated +plugin to register your own fields/functions (see +:ref:`writing-plugins`).