We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Sidebar scrolling in docs not working and general adjustment ideas
I was too lazy for a PR but I a quickfixed the sidebar in Alabaster. It did not stay "in place" like we had it before. More adjustments might come in proper PR.

**_~Well, the fix does not work in master but it does work on my local docs build!~_**

Update: Actually the sidebar scrolling did work, probably there was some caching issue with my local browser, so that is [x] DONE

Anyway, we should take care of docs build and customization. Some ideas:

- Explicitely state Alabaster as the theme to use.
- Set the pic we have for the beetbox organization as the logo in the docs. (Or do we have a logo or does someone want to design one?
- Default to "latest" version of the docs
- ...I might add some more ideas here...

Might be related: https://github.com/beetbox/beets/issues/4912

_Originally posted by @JOJ0 in https://github.com/beetbox/beets/issues/4644#issuecomment-1728881928_
            

--- END ISSUE ---

Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
--- BEGIN FILES ---
Path: `setup.py`
Content:
```
1 #!/usr/bin/env python
2 
3 # This file is part of beets.
4 # Copyright 2016, Adrian Sampson.
5 #
6 # Permission is hereby granted, free of charge, to any person obtaining
7 # a copy of this software and associated documentation files (the
8 # "Software"), to deal in the Software without restriction, including
9 # without limitation the rights to use, copy, modify, merge, publish,
10 # distribute, sublicense, and/or sell copies of the Software, and to
11 # permit persons to whom the Software is furnished to do so, subject to
12 # the following conditions:
13 #
14 # The above copyright notice and this permission notice shall be
15 # included in all copies or substantial portions of the Software.
16 
17 
18 import os
19 import shutil
20 import subprocess
21 import sys
22 
23 from setuptools import setup
24 
25 
26 def _read(fn):
27     path = os.path.join(os.path.dirname(__file__), fn)
28     return open(path).read()
29 
30 
31 def build_manpages():
32     # Go into the docs directory and build the manpage.
33     docdir = os.path.join(os.path.dirname(__file__), "docs")
34     curdir = os.getcwd()
35     os.chdir(docdir)
36     try:
37         subprocess.check_call(["make", "man"])
38     except OSError:
39         print("Could not build manpages (make man failed)!", file=sys.stderr)
40         return
41     finally:
42         os.chdir(curdir)
43 
44     # Copy resulting manpages.
45     mandir = os.path.join(os.path.dirname(__file__), "man")
46     if os.path.exists(mandir):
47         shutil.rmtree(mandir)
48     shutil.copytree(os.path.join(docdir, "_build", "man"), mandir)
49 
50 
51 # Build manpages if we're making a source distribution tarball.
52 if "sdist" in sys.argv:
53     build_manpages()
54 
55 
56 setup(
57     name="beets",
58     version="1.6.1",
59     description="music tagger and library organizer",
60     author="Adrian Sampson",
61     author_email="adrian@radbox.org",
62     url="https://beets.io/",
63     license="MIT",
64     platforms="ALL",
65     long_description=_read("README.rst"),
66     test_suite="test.testall.suite",
67     zip_safe=False,
68     include_package_data=True,  # Install plugin resources.
69     packages=[
70         "beets",
71         "beets.ui",
72         "beets.autotag",
73         "beets.util",
74         "beets.dbcore",
75         "beetsplug",
76         "beetsplug.bpd",
77         "beetsplug.web",
78         "beetsplug.lastgenre",
79         "beetsplug.metasync",
80     ],
81     entry_points={
82         "console_scripts": [
83             "beet = beets.ui:main",
84         ],
85     },
86     install_requires=[
87         "unidecode>=1.3.6",
88         "musicbrainzngs>=0.4",
89         "pyyaml",
90         "mediafile>=0.12.0",
91         "confuse>=1.5.0",
92         "munkres>=1.0.0",
93         "jellyfish",
94         "typing_extensions",
95     ]
96     + (
97         # Support for ANSI console colors on Windows.
98         ["colorama"]
99         if (sys.platform == "win32")
100         else []
101     ),
102     extras_require={
103         "test": [
104             "beautifulsoup4",
105             "coverage",
106             "flask",
107             "mock",
108             "pylast",
109             "pytest",
110             "python-mpd2",
111             "pyxdg",
112             "responses>=0.3.0",
113             "requests_oauthlib",
114             "reflink",
115             "rarfile",
116             "python3-discogs-client>=2.3.15",
117             "py7zr",
118         ],
119         "lint": [
120             "flake8",
121             "flake8-docstrings",
122             "pep8-naming",
123         ],
124         "mypy": [
125             "mypy",
126             "types-Pillow",
127             "types-urllib3",
128             "types-beautifulsoup4",
129             "types-PyYAML",
130             "types-requests",
131             "types-Flask-Cors",
132         ],
133         "docs": [
134             "sphinx",
135             "sphinx_rtd_theme",
136         ],
137         # Plugin (optional) dependencies:
138         "absubmit": ["requests"],
139         "fetchart": ["requests", "Pillow", "beautifulsoup4"],
140         "embedart": ["Pillow"],
141         "embyupdate": ["requests"],
142         "chroma": ["pyacoustid"],
143         "discogs": ["python3-discogs-client>=2.3.15"],
144         "beatport": ["requests-oauthlib>=0.6.1"],
145         "kodiupdate": ["requests"],
146         "lastgenre": ["pylast"],
147         "lastimport": ["pylast"],
148         "lyrics": ["requests", "beautifulsoup4", "langdetect"],
149         "mpdstats": ["python-mpd2>=0.4.2"],
150         "plexupdate": ["requests"],
151         "web": ["flask", "flask-cors"],
152         "import": ["rarfile", "py7zr"],
153         "thumbnails": ["pyxdg", "Pillow"],
154         "metasync": ["dbus-python"],
155         "sonosupdate": ["soco"],
156         "scrub": ["mutagen>=1.33"],
157         "bpd": ["PyGObject"],
158         "replaygain": ["PyGObject"],
159         "reflink": ["reflink"],
160     },
161     # Non-Python/non-PyPI plugin dependencies:
162     #   chroma: chromaprint or fpcalc
163     #   convert: ffmpeg
164     #   badfiles: mp3val and flac
165     #   bpd: python-gi and GStreamer 1.0+
166     #   embedart: ImageMagick
167     #   absubmit: extractor binary from https://acousticbrainz.org/download
168     #   keyfinder: KeyFinder
169     #   replaygain: python-gi and GStreamer 1.0+
170     #               or mp3gain/aacgain
171     #               or Python Audio Tools
172     #               or ffmpeg
173     #   ipfs: go-ipfs
174     classifiers=[
175         "Topic :: Multimedia :: Sound/Audio",
176         "Topic :: Multimedia :: Sound/Audio :: Players :: MP3",
177         "License :: OSI Approved :: MIT License",
178         "Environment :: Console",
179         "Environment :: Web Environment",
180         "Programming Language :: Python",
181         "Programming Language :: Python :: 3",
182         "Programming Language :: Python :: 3.7",
183         "Programming Language :: Python :: 3.8",
184         "Programming Language :: Python :: 3.9",
185         "Programming Language :: Python :: 3.10",
186         "Programming Language :: Python :: Implementation :: CPython",
187     ],
188 )
189
```

Path: `docs/conf.py`
Content:
```
1 AUTHOR = "Adrian Sampson"
2 
3 # General configuration
4 
5 extensions = ["sphinx.ext.autodoc", "sphinx.ext.extlinks"]
6 
7 exclude_patterns = ["_build"]
8 source_suffix = ".rst"
9 master_doc = "index"
10 
11 project = "beets"
12 copyright = "2016, Adrian Sampson"
13 
14 version = "1.6"
15 release = "1.6.1"
16 
17 pygments_style = "sphinx"
18 
19 # External links to the bug tracker and other sites.
20 extlinks = {
21     "bug": ("https://github.com/beetbox/beets/issues/%s", "#%s"),
22     "user": ("https://github.com/%s", "%s"),
23     "pypi": ("https://pypi.org/project/%s/", "%s"),
24     "stdlib": ("https://docs.python.org/3/library/%s.html", "%s"),
25 }
26 
27 linkcheck_ignore = [
28     r"https://github.com/beetbox/beets/issues/",
29     r"https://github.com/[^/]+$",  # ignore user pages
30     r".*localhost.*",
31     r"https?://127\.0\.0\.1",
32     r"https://www.musixmatch.com/",  # blocks requests
33     r"https://genius.com/",  # blocks requests
34 ]
35 
36 # Options for HTML output
37 htmlhelp_basename = "beetsdoc"
38 
39 # Options for LaTeX output
40 latex_documents = [
41     ("index", "beets.tex", "beets Documentation", AUTHOR, "manual"),
42 ]
43 
44 # Options for manual page output
45 man_pages = [
46     (
47         "reference/cli",
48         "beet",
49         "music tagger and library organizer",
50         [AUTHOR],
51         1,
52     ),
53     (
54         "reference/config",
55         "beetsconfig",
56         "beets configuration file",
57         [AUTHOR],
58         5,
59     ),
60 ]
61 
62 # Options for Alabaster theme
63 html_theme_options = {"fixed_sidebar": True}
64
```
--- END FILES ---

Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.

Here is an example:

```diff
diff --git a/examples/server_async.py b/examples/server_async.py
--- a/examples/server_async.py
+++ b/examples/server_async.py
@@ -313,4 +313,4 @@
 
 
 if __name__ == "__main__":
-    asyncio.run(run_async_server("."), debug=True)
+    asyncio.run(run_async_server(), debug=True)
diff --git a/examples/server_sync.py b/examples/server_sync.py
--- a/examples/server_sync.py
+++ b/examples/server_sync.py
@@ -313,5 +313,5 @@
 
 
 if __name__ == "__main__":
-    server = run_sync_server(".")
+    server = run_sync_server()
     server.shutdown()

```

diff --git a/docs/conf.py b/docs/conf.py
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -59,5 +59,16 @@
     ),
 ]
 
-# Options for Alabaster theme
-html_theme_options = {"fixed_sidebar": True}
+# Options for pydata theme
+html_theme = 'pydata_sphinx_theme'
+html_theme_options = {
+    'collapse_navigation': True,
+    "logo": {
+        "text": "beets",
+    },
+    "pygment_light_style": "bw",
+}
+html_title = "beets"
+html_logo = "_static/beets_logo.png"
+html_static_path = ['_static']
+html_css_files = ['beets.css']
diff --git a/setup.py b/setup.py
--- a/setup.py
+++ b/setup.py
@@ -132,7 +132,7 @@
         ],
         "docs": [
             "sphinx",
-            "sphinx_rtd_theme",
+            "pydata_sphinx_theme",
         ],
         # Plugin (optional) dependencies:
         "absubmit": ["requests"],

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -59,5 +59,16 @@\n     ),\n ]\n \n-# Options for Alabaster theme\n-html_theme_options = {\"fixed_sidebar\": True}\n+# Options for pydata theme\n+html_theme = 'pydata_sphinx_theme'\n+html_theme_options = {\n+    'collapse_navigation': True,\n+    \"logo\": {\n+        \"text\": \"beets\",\n+    },\n+    \"pygment_light_style\": \"bw\",\n+}\n+html_title = \"beets\"\n+html_logo = \"_static/beets_logo.png\"\n+html_static_path = ['_static']\n+html_css_files = ['beets.css']\ndiff --git a/setup.py b/setup.py\n--- a/setup.py\n+++ b/setup.py\n@@ -132,7 +132,7 @@\n         ],\n         \"docs\": [\n             \"sphinx\",\n-            \"sphinx_rtd_theme\",\n+            \"pydata_sphinx_theme\",\n         ],\n         # Plugin (optional) dependencies:\n         \"absubmit\": [\"requests\"],\n", "issue": "Sidebar scrolling in docs not working and general adjustment ideas\nI was too lazy for a PR but I a quickfixed the sidebar in Alabaster. It did not stay \"in place\" like we had it before. More adjustments might come in proper PR.\r\n\r\n**_~Well, the fix does not work in master but it does work on my local docs build!~_**\r\n\r\nUpdate: Actually the sidebar scrolling did work, probably there was some caching issue with my local browser, so that is [x] DONE\r\n\r\nAnyway, we should take care of docs build and customization. Some ideas:\r\n\r\n- Explicitely state Alabaster as the theme to use.\r\n- Set the pic we have for the beetbox organization as the logo in the docs. (Or do we have a logo or does someone want to design one?\r\n- Default to \"latest\" version of the docs\r\n- ...I might add some more ideas here...\r\n\r\nMight be related: https://github.com/beetbox/beets/issues/4912\r\n\r\n_Originally posted by @JOJ0 in https://github.com/beetbox/beets/issues/4644#issuecomment-1728881928_\r\n            \n", "before_files": [{"content": "#!/usr/bin/env python\n\n# This file is part of beets.\n# Copyright 2016, Adrian Sampson.\n#\n# Permission is hereby granted, free of charge, to any person obtaining\n# a copy of this software and associated documentation files (the\n# \"Software\"), to deal in the Software without restriction, including\n# without limitation the rights to use, copy, modify, merge, publish,\n# distribute, sublicense, and/or sell copies of the Software, and to\n# permit persons to whom the Software is furnished to do so, subject to\n# the following conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n\n\nimport os\nimport shutil\nimport subprocess\nimport sys\n\nfrom setuptools import setup\n\n\ndef _read(fn):\n    path = os.path.join(os.path.dirname(__file__), fn)\n    return open(path).read()\n\n\ndef build_manpages():\n    # Go into the docs directory and build the manpage.\n    docdir = os.path.join(os.path.dirname(__file__), \"docs\")\n    curdir = os.getcwd()\n    os.chdir(docdir)\n    try:\n        subprocess.check_call([\"make\", \"man\"])\n    except OSError:\n        print(\"Could not build manpages (make man failed)!\", file=sys.stderr)\n        return\n    finally:\n        os.chdir(curdir)\n\n    # Copy resulting manpages.\n    mandir = os.path.join(os.path.dirname(__file__), \"man\")\n    if os.path.exists(mandir):\n        shutil.rmtree(mandir)\n    shutil.copytree(os.path.join(docdir, \"_build\", \"man\"), mandir)\n\n\n# Build manpages if we're making a source distribution tarball.\nif \"sdist\" in sys.argv:\n    build_manpages()\n\n\nsetup(\n    name=\"beets\",\n    version=\"1.6.1\",\n    description=\"music tagger and library organizer\",\n    author=\"Adrian Sampson\",\n    author_email=\"adrian@radbox.org\",\n    url=\"https://beets.io/\",\n    license=\"MIT\",\n    platforms=\"ALL\",\n    long_description=_read(\"README.rst\"),\n    test_suite=\"test.testall.suite\",\n    zip_safe=False,\n    include_package_data=True,  # Install plugin resources.\n    packages=[\n        \"beets\",\n        \"beets.ui\",\n        \"beets.autotag\",\n        \"beets.util\",\n        \"beets.dbcore\",\n        \"beetsplug\",\n        \"beetsplug.bpd\",\n        \"beetsplug.web\",\n        \"beetsplug.lastgenre\",\n        \"beetsplug.metasync\",\n    ],\n    entry_points={\n        \"console_scripts\": [\n            \"beet = beets.ui:main\",\n        ],\n    },\n    install_requires=[\n        \"unidecode>=1.3.6\",\n        \"musicbrainzngs>=0.4\",\n        \"pyyaml\",\n        \"mediafile>=0.12.0\",\n        \"confuse>=1.5.0\",\n        \"munkres>=1.0.0\",\n        \"jellyfish\",\n        \"typing_extensions\",\n    ]\n    + (\n        # Support for ANSI console colors on Windows.\n        [\"colorama\"]\n        if (sys.platform == \"win32\")\n        else []\n    ),\n    extras_require={\n        \"test\": [\n            \"beautifulsoup4\",\n            \"coverage\",\n            \"flask\",\n            \"mock\",\n            \"pylast\",\n            \"pytest\",\n            \"python-mpd2\",\n            \"pyxdg\",\n            \"responses>=0.3.0\",\n            \"requests_oauthlib\",\n            \"reflink\",\n            \"rarfile\",\n            \"python3-discogs-client>=2.3.15\",\n            \"py7zr\",\n        ],\n        \"lint\": [\n            \"flake8\",\n            \"flake8-docstrings\",\n            \"pep8-naming\",\n        ],\n        \"mypy\": [\n            \"mypy\",\n            \"types-Pillow\",\n            \"types-urllib3\",\n            \"types-beautifulsoup4\",\n            \"types-PyYAML\",\n            \"types-requests\",\n            \"types-Flask-Cors\",\n        ],\n        \"docs\": [\n            \"sphinx\",\n            \"sphinx_rtd_theme\",\n        ],\n        # Plugin (optional) dependencies:\n        \"absubmit\": [\"requests\"],\n        \"fetchart\": [\"requests\", \"Pillow\", \"beautifulsoup4\"],\n        \"embedart\": [\"Pillow\"],\n        \"embyupdate\": [\"requests\"],\n        \"chroma\": [\"pyacoustid\"],\n        \"discogs\": [\"python3-discogs-client>=2.3.15\"],\n        \"beatport\": [\"requests-oauthlib>=0.6.1\"],\n        \"kodiupdate\": [\"requests\"],\n        \"lastgenre\": [\"pylast\"],\n        \"lastimport\": [\"pylast\"],\n        \"lyrics\": [\"requests\", \"beautifulsoup4\", \"langdetect\"],\n        \"mpdstats\": [\"python-mpd2>=0.4.2\"],\n        \"plexupdate\": [\"requests\"],\n        \"web\": [\"flask\", \"flask-cors\"],\n        \"import\": [\"rarfile\", \"py7zr\"],\n        \"thumbnails\": [\"pyxdg\", \"Pillow\"],\n        \"metasync\": [\"dbus-python\"],\n        \"sonosupdate\": [\"soco\"],\n        \"scrub\": [\"mutagen>=1.33\"],\n        \"bpd\": [\"PyGObject\"],\n        \"replaygain\": [\"PyGObject\"],\n        \"reflink\": [\"reflink\"],\n    },\n    # Non-Python/non-PyPI plugin dependencies:\n    #   chroma: chromaprint or fpcalc\n    #   convert: ffmpeg\n    #   badfiles: mp3val and flac\n    #   bpd: python-gi and GStreamer 1.0+\n    #   embedart: ImageMagick\n    #   absubmit: extractor binary from https://acousticbrainz.org/download\n    #   keyfinder: KeyFinder\n    #   replaygain: python-gi and GStreamer 1.0+\n    #               or mp3gain/aacgain\n    #               or Python Audio Tools\n    #               or ffmpeg\n    #   ipfs: go-ipfs\n    classifiers=[\n        \"Topic :: Multimedia :: Sound/Audio\",\n        \"Topic :: Multimedia :: Sound/Audio :: Players :: MP3\",\n        \"License :: OSI Approved :: MIT License\",\n        \"Environment :: Console\",\n        \"Environment :: Web Environment\",\n        \"Programming Language :: Python\",\n        \"Programming Language :: Python :: 3\",\n        \"Programming Language :: Python :: 3.7\",\n        \"Programming Language :: Python :: 3.8\",\n        \"Programming Language :: Python :: 3.9\",\n        \"Programming Language :: Python :: 3.10\",\n        \"Programming Language :: Python :: Implementation :: CPython\",\n    ],\n)\n", "path": "setup.py"}, {"content": "AUTHOR = \"Adrian Sampson\"\n\n# General configuration\n\nextensions = [\"sphinx.ext.autodoc\", \"sphinx.ext.extlinks\"]\n\nexclude_patterns = [\"_build\"]\nsource_suffix = \".rst\"\nmaster_doc = \"index\"\n\nproject = \"beets\"\ncopyright = \"2016, Adrian Sampson\"\n\nversion = \"1.6\"\nrelease = \"1.6.1\"\n\npygments_style = \"sphinx\"\n\n# External links to the bug tracker and other sites.\nextlinks = {\n    \"bug\": (\"https://github.com/beetbox/beets/issues/%s\", \"#%s\"),\n    \"user\": (\"https://github.com/%s\", \"%s\"),\n    \"pypi\": (\"https://pypi.org/project/%s/\", \"%s\"),\n    \"stdlib\": (\"https://docs.python.org/3/library/%s.html\", \"%s\"),\n}\n\nlinkcheck_ignore = [\n    r\"https://github.com/beetbox/beets/issues/\",\n    r\"https://github.com/[^/]+$\",  # ignore user pages\n    r\".*localhost.*\",\n    r\"https?://127\\.0\\.0\\.1\",\n    r\"https://www.musixmatch.com/\",  # blocks requests\n    r\"https://genius.com/\",  # blocks requests\n]\n\n# Options for HTML output\nhtmlhelp_basename = \"beetsdoc\"\n\n# Options for LaTeX output\nlatex_documents = [\n    (\"index\", \"beets.tex\", \"beets Documentation\", AUTHOR, \"manual\"),\n]\n\n# Options for manual page output\nman_pages = [\n    (\n        \"reference/cli\",\n        \"beet\",\n        \"music tagger and library organizer\",\n        [AUTHOR],\n        1,\n    ),\n    (\n        \"reference/config\",\n        \"beetsconfig\",\n        \"beets configuration file\",\n        [AUTHOR],\n        5,\n    ),\n]\n\n# Options for Alabaster theme\nhtml_theme_options = {\"fixed_sidebar\": True}\n", "path": "docs/conf.py"}], "after_files": [{"content": "#!/usr/bin/env python\n\n# This file is part of beets.\n# Copyright 2016, Adrian Sampson.\n#\n# Permission is hereby granted, free of charge, to any person obtaining\n# a copy of this software and associated documentation files (the\n# \"Software\"), to deal in the Software without restriction, including\n# without limitation the rights to use, copy, modify, merge, publish,\n# distribute, sublicense, and/or sell copies of the Software, and to\n# permit persons to whom the Software is furnished to do so, subject to\n# the following conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n\n\nimport os\nimport shutil\nimport subprocess\nimport sys\n\nfrom setuptools import setup\n\n\ndef _read(fn):\n    path = os.path.join(os.path.dirname(__file__), fn)\n    return open(path).read()\n\n\ndef build_manpages():\n    # Go into the docs directory and build the manpage.\n    docdir = os.path.join(os.path.dirname(__file__), \"docs\")\n    curdir = os.getcwd()\n    os.chdir(docdir)\n    try:\n        subprocess.check_call([\"make\", \"man\"])\n    except OSError:\n        print(\"Could not build manpages (make man failed)!\", file=sys.stderr)\n        return\n    finally:\n        os.chdir(curdir)\n\n    # Copy resulting manpages.\n    mandir = os.path.join(os.path.dirname(__file__), \"man\")\n    if os.path.exists(mandir):\n        shutil.rmtree(mandir)\n    shutil.copytree(os.path.join(docdir, \"_build\", \"man\"), mandir)\n\n\n# Build manpages if we're making a source distribution tarball.\nif \"sdist\" in sys.argv:\n    build_manpages()\n\n\nsetup(\n    name=\"beets\",\n    version=\"1.6.1\",\n    description=\"music tagger and library organizer\",\n    author=\"Adrian Sampson\",\n    author_email=\"adrian@radbox.org\",\n    url=\"https://beets.io/\",\n    license=\"MIT\",\n    platforms=\"ALL\",\n    long_description=_read(\"README.rst\"),\n    test_suite=\"test.testall.suite\",\n    zip_safe=False,\n    include_package_data=True,  # Install plugin resources.\n    packages=[\n        \"beets\",\n        \"beets.ui\",\n        \"beets.autotag\",\n        \"beets.util\",\n        \"beets.dbcore\",\n        \"beetsplug\",\n        \"beetsplug.bpd\",\n        \"beetsplug.web\",\n        \"beetsplug.lastgenre\",\n        \"beetsplug.metasync\",\n    ],\n    entry_points={\n        \"console_scripts\": [\n            \"beet = beets.ui:main\",\n        ],\n    },\n    install_requires=[\n        \"unidecode>=1.3.6\",\n        \"musicbrainzngs>=0.4\",\n        \"pyyaml\",\n        \"mediafile>=0.12.0\",\n        \"confuse>=1.5.0\",\n        \"munkres>=1.0.0\",\n        \"jellyfish\",\n        \"typing_extensions\",\n    ]\n    + (\n        # Support for ANSI console colors on Windows.\n        [\"colorama\"]\n        if (sys.platform == \"win32\")\n        else []\n    ),\n    extras_require={\n        \"test\": [\n            \"beautifulsoup4\",\n            \"coverage\",\n            \"flask\",\n            \"mock\",\n            \"pylast\",\n            \"pytest\",\n            \"python-mpd2\",\n            \"pyxdg\",\n            \"responses>=0.3.0\",\n            \"requests_oauthlib\",\n            \"reflink\",\n            \"rarfile\",\n            \"python3-discogs-client>=2.3.15\",\n            \"py7zr\",\n        ],\n        \"lint\": [\n            \"flake8\",\n            \"flake8-docstrings\",\n            \"pep8-naming\",\n        ],\n        \"mypy\": [\n            \"mypy\",\n            \"types-Pillow\",\n            \"types-urllib3\",\n            \"types-beautifulsoup4\",\n            \"types-PyYAML\",\n            \"types-requests\",\n            \"types-Flask-Cors\",\n        ],\n        \"docs\": [\n            \"sphinx\",\n            \"pydata_sphinx_theme\",\n        ],\n        # Plugin (optional) dependencies:\n        \"absubmit\": [\"requests\"],\n        \"fetchart\": [\"requests\", \"Pillow\", \"beautifulsoup4\"],\n        \"embedart\": [\"Pillow\"],\n        \"embyupdate\": [\"requests\"],\n        \"chroma\": [\"pyacoustid\"],\n        \"discogs\": [\"python3-discogs-client>=2.3.15\"],\n        \"beatport\": [\"requests-oauthlib>=0.6.1\"],\n        \"kodiupdate\": [\"requests\"],\n        \"lastgenre\": [\"pylast\"],\n        \"lastimport\": [\"pylast\"],\n        \"lyrics\": [\"requests\", \"beautifulsoup4\", \"langdetect\"],\n        \"mpdstats\": [\"python-mpd2>=0.4.2\"],\n        \"plexupdate\": [\"requests\"],\n        \"web\": [\"flask\", \"flask-cors\"],\n        \"import\": [\"rarfile\", \"py7zr\"],\n        \"thumbnails\": [\"pyxdg\", \"Pillow\"],\n        \"metasync\": [\"dbus-python\"],\n        \"sonosupdate\": [\"soco\"],\n        \"scrub\": [\"mutagen>=1.33\"],\n        \"bpd\": [\"PyGObject\"],\n        \"replaygain\": [\"PyGObject\"],\n        \"reflink\": [\"reflink\"],\n    },\n    # Non-Python/non-PyPI plugin dependencies:\n    #   chroma: chromaprint or fpcalc\n    #   convert: ffmpeg\n    #   badfiles: mp3val and flac\n    #   bpd: python-gi and GStreamer 1.0+\n    #   embedart: ImageMagick\n    #   absubmit: extractor binary from https://acousticbrainz.org/download\n    #   keyfinder: KeyFinder\n    #   replaygain: python-gi and GStreamer 1.0+\n    #               or mp3gain/aacgain\n    #               or Python Audio Tools\n    #               or ffmpeg\n    #   ipfs: go-ipfs\n    classifiers=[\n        \"Topic :: Multimedia :: Sound/Audio\",\n        \"Topic :: Multimedia :: Sound/Audio :: Players :: MP3\",\n        \"License :: OSI Approved :: MIT License\",\n        \"Environment :: Console\",\n        \"Environment :: Web Environment\",\n        \"Programming Language :: Python\",\n        \"Programming Language :: Python :: 3\",\n        \"Programming Language :: Python :: 3.7\",\n        \"Programming Language :: Python :: 3.8\",\n        \"Programming Language :: Python :: 3.9\",\n        \"Programming Language :: Python :: 3.10\",\n        \"Programming Language :: Python :: Implementation :: CPython\",\n    ],\n)\n", "path": "setup.py"}, {"content": "AUTHOR = \"Adrian Sampson\"\n\n# General configuration\n\nextensions = [\"sphinx.ext.autodoc\", \"sphinx.ext.extlinks\"]\n\nexclude_patterns = [\"_build\"]\nsource_suffix = \".rst\"\nmaster_doc = \"index\"\n\nproject = \"beets\"\ncopyright = \"2016, Adrian Sampson\"\n\nversion = \"1.6\"\nrelease = \"1.6.1\"\n\npygments_style = \"sphinx\"\n\n# External links to the bug tracker and other sites.\nextlinks = {\n    \"bug\": (\"https://github.com/beetbox/beets/issues/%s\", \"#%s\"),\n    \"user\": (\"https://github.com/%s\", \"%s\"),\n    \"pypi\": (\"https://pypi.org/project/%s/\", \"%s\"),\n    \"stdlib\": (\"https://docs.python.org/3/library/%s.html\", \"%s\"),\n}\n\nlinkcheck_ignore = [\n    r\"https://github.com/beetbox/beets/issues/\",\n    r\"https://github.com/[^/]+$\",  # ignore user pages\n    r\".*localhost.*\",\n    r\"https?://127\\.0\\.0\\.1\",\n    r\"https://www.musixmatch.com/\",  # blocks requests\n    r\"https://genius.com/\",  # blocks requests\n]\n\n# Options for HTML output\nhtmlhelp_basename = \"beetsdoc\"\n\n# Options for LaTeX output\nlatex_documents = [\n    (\"index\", \"beets.tex\", \"beets Documentation\", AUTHOR, \"manual\"),\n]\n\n# Options for manual page output\nman_pages = [\n    (\n        \"reference/cli\",\n        \"beet\",\n        \"music tagger and library organizer\",\n        [AUTHOR],\n        1,\n    ),\n    (\n        \"reference/config\",\n        \"beetsconfig\",\n        \"beets configuration file\",\n        [AUTHOR],\n        5,\n    ),\n]\n\n# Options for pydata theme\nhtml_theme = 'pydata_sphinx_theme'\nhtml_theme_options = {\n    'collapse_navigation': True,\n    \"logo\": {\n        \"text\": \"beets\",\n    },\n    \"pygment_light_style\": \"bw\",\n}\nhtml_title = \"beets\"\nhtml_logo = \"_static/beets_logo.png\"\nhtml_static_path = ['_static']\nhtml_css_files = ['beets.css']\n", "path": "docs/conf.py"}]}