beets/docs
henry b902352139
New Plugin: Titlecase (#6133)
This plugin aims to address the shortcomings of the %title function, as
brought up in issues #152, #3298 and an initial look to improvement with
#3411. It supplies a new string format command, `%titlecase` which
doesn't interfere with any prior expected behavior of the `%title`
format command.

It also adds the ability to apply titlecase logic to metadata fields
that a user selects, which is useful if you, like me, are looking for
stylistic consistency and the minor stylistic differences between
Musizbrainz, Discogs, Deezer etc, with title case are slightly
infuriating.

This will add an optional dependency of
[titlecase](https://pypi.org/project/titlecase/), which allows the
titlecase core logic to be externally maintained.

If there's not enough draw to have this as a core plugin, I can also
spin this into an independent one, but it seemed like a recurring theme
that the %title string format didn't really behave as expected, and I
wanted my metadata to match too.

- [x] Documentation. (If you've added a new command-line flag, for
example, find the appropriate page under `docs/` to describe it.)
- [x] Changelog. (Add an entry to `docs/changelog.rst` to the bottom of
one of the lists near the top of the document.)
- [x] Tests. - Not 100% coverage, but didn't see a lot of other plugins
with testing for import stages.
2025-11-23 10:34:05 -08:00
..
_static Transparent background logo for docs 2023-10-29 10:30:33 +01:00
_templates/autosummary A number of smaller additions. 2025-09-04 12:49:43 +01:00
api Add index for API Reference 2025-09-04 12:49:48 +01:00
dev Update docs for mbpseudo plugin 2025-11-01 13:52:11 +01:00
extensions Add Sphinx extension for configuration value documentation 2025-10-19 01:34:32 +01:00
guides Update python version references 2025-11-08 12:09:52 +00:00
plugins New Plugin: Titlecase (#6133) 2025-11-23 10:34:05 -08:00
reference Add album template value in ftintitle plugin 2025-11-21 18:31:59 +01:00
.gitignore Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
changelog.rst New Plugin: Titlecase (#6133) 2025-11-23 10:34:05 -08:00
code_of_conduct.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
conf.py Add Sphinx extension for configuration value documentation 2025-10-19 01:34:32 +01:00
contributing.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
faq.rst Run formatter. 2025-10-11 13:52:35 +02:00
index.rst Re-added macport instructions. Removed mailing list ref. Added section 2025-10-11 13:52:35 +02:00
Makefile Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
modd.conf Switch to modd for live docs build 2017-12-21 11:39:08 -05:00
team.rst Reformat all docs using docstrfmt 2025-08-10 16:25:05 +01:00