We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Create URL links to actual PRs rather than simply referencing the PR number
The change log is immensely useful, however it makes reference to specific Github PRs and only mentions the PR number without actually linking to the issue.

I would like for the changelog to actually include links to the issue. It would be of great help to readers to be able to see the contextual discussion for a change, particularly for style changes.

https://black.readthedocs.io/en/stable/change_log.html


--- END ISSUE ---

Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
--- BEGIN FILES ---
Path: `docs/conf.py`
Content:
```
1 #
2 # Configuration file for the Sphinx documentation builder.
3 #
4 # This file does only contain a selection of the most common options. For a
5 # full list see the documentation:
6 # http://www.sphinx-doc.org/en/stable/config
7 
8 # -- Path setup --------------------------------------------------------------
9 
10 # If extensions (or modules to document with autodoc) are in another directory,
11 # add these directories to sys.path here. If the directory is relative to the
12 # documentation root, use os.path.abspath to make it absolute, like shown here.
13 #
14 
15 import os
16 import string
17 from importlib.metadata import version
18 from pathlib import Path
19 
20 CURRENT_DIR = Path(__file__).parent
21 
22 
23 def make_pypi_svg(version: str) -> None:
24     template: Path = CURRENT_DIR / "_static" / "pypi_template.svg"
25     target: Path = CURRENT_DIR / "_static" / "pypi.svg"
26     with open(str(template), encoding="utf8") as f:
27         svg: str = string.Template(f.read()).substitute(version=version)
28     with open(str(target), "w", encoding="utf8") as f:
29         f.write(svg)
30 
31 
32 # Necessary so Click doesn't hit an encode error when called by
33 # sphinxcontrib-programoutput on Windows.
34 os.putenv("pythonioencoding", "utf-8")
35 
36 # -- Project information -----------------------------------------------------
37 
38 project = "Black"
39 copyright = "2018-Present, Łukasz Langa and contributors to Black"
40 author = "Łukasz Langa and contributors to Black"
41 
42 # Autopopulate version
43 # The version, including alpha/beta/rc tags, but not commit hash and datestamps
44 release = version("black").split("+")[0]
45 # The short X.Y version.
46 version = release
47 for sp in "abcfr":
48     version = version.split(sp)[0]
49 
50 make_pypi_svg(release)
51 
52 
53 # -- General configuration ---------------------------------------------------
54 
55 # If your documentation needs a minimal Sphinx version, state it here.
56 needs_sphinx = "4.4"
57 
58 # Add any Sphinx extension module names here, as strings. They can be
59 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
60 # ones.
61 extensions = [
62     "sphinx.ext.autodoc",
63     "sphinx.ext.intersphinx",
64     "sphinx.ext.napoleon",
65     "myst_parser",
66     "sphinxcontrib.programoutput",
67     "sphinx_copybutton",
68 ]
69 
70 # If you need extensions of a certain version or higher, list them here.
71 needs_extensions = {"myst_parser": "0.13.7"}
72 
73 # Add any paths that contain templates here, relative to this directory.
74 templates_path = ["_templates"]
75 
76 # The suffix(es) of source filenames.
77 # You can specify multiple suffix as a list of string:
78 source_suffix = [".rst", ".md"]
79 
80 # The master toctree document.
81 master_doc = "index"
82 
83 # The language for content autogenerated by Sphinx. Refer to documentation
84 # for a list of supported languages.
85 #
86 # This is also used if you do content translation via gettext catalogs.
87 # Usually you set "language" from the command line for these cases.
88 language = "en"
89 
90 # List of patterns, relative to source directory, that match files and
91 # directories to ignore when looking for source files.
92 # This pattern also affects html_static_path and html_extra_path .
93 
94 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
95 
96 # The name of the Pygments (syntax highlighting) style to use.
97 pygments_style = "sphinx"
98 
99 # We need headers to be linkable to so ask MyST-Parser to autogenerate anchor IDs for
100 # headers up to and including level 3.
101 myst_heading_anchors = 3
102 
103 # Prettier support formatting some MyST syntax but not all, so let's disable the
104 # unsupported yet still enabled by default ones.
105 myst_disable_syntax = [
106     "colon_fence",
107     "myst_block_break",
108     "myst_line_comment",
109     "math_block",
110 ]
111 
112 # Optional MyST Syntaxes
113 myst_enable_extensions = []
114 
115 # -- Options for HTML output -------------------------------------------------
116 
117 # The theme to use for HTML and HTML Help pages.  See the documentation for
118 # a list of builtin themes.
119 #
120 html_theme = "furo"
121 html_logo = "_static/logo2-readme.png"
122 
123 # Add any paths that contain custom static files (such as style sheets) here,
124 # relative to this directory. They are copied after the builtin static files,
125 # so a file named "default.css" will overwrite the builtin "default.css".
126 html_static_path = ["_static"]
127 
128 # Custom sidebar templates, must be a dictionary that maps document names
129 # to template names.
130 #
131 # The default sidebars (for documents that don't match any pattern) are
132 # defined by theme itself.  Builtin themes are using these templates by
133 # default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
134 # 'searchbox.html']``.
135 #
136 # html_sidebars = {}
137 
138 
139 # -- Options for HTMLHelp output ---------------------------------------------
140 
141 # Output file base name for HTML help builder.
142 htmlhelp_basename = "blackdoc"
143 
144 
145 # -- Options for LaTeX output ------------------------------------------------
146 
147 # Grouping the document tree into LaTeX files. List of tuples
148 # (source start file, target name, title,
149 #  author, documentclass [howto, manual, or own class]).
150 latex_documents = [(
151     master_doc,
152     "black.tex",
153     "Documentation for Black",
154     "Łukasz Langa and contributors to Black",
155     "manual",
156 )]
157 
158 
159 # -- Options for manual page output ------------------------------------------
160 
161 # One entry per manual page. List of tuples
162 # (source start file, name, description, authors, manual section).
163 man_pages = [(master_doc, "black", "Documentation for Black", [author], 1)]
164 
165 
166 # -- Options for Texinfo output ----------------------------------------------
167 
168 # Grouping the document tree into Texinfo files. List of tuples
169 # (source start file, target name, title, author,
170 #  dir menu entry, description, category)
171 texinfo_documents = [(
172     master_doc,
173     "Black",
174     "Documentation for Black",
175     author,
176     "Black",
177     "The uncompromising Python code formatter",
178     "Miscellaneous",
179 )]
180 
181 
182 # -- Options for Epub output -------------------------------------------------
183 
184 # Bibliographic Dublin Core info.
185 epub_title = project
186 epub_author = author
187 epub_publisher = author
188 epub_copyright = copyright
189 
190 # The unique identifier of the text. This can be a ISBN number
191 # or the project homepage.
192 #
193 # epub_identifier = ''
194 
195 # A unique identification for the text.
196 #
197 # epub_uid = ''
198 
199 # A list of files that should not be packed into the epub file.
200 epub_exclude_files = ["search.html"]
201 
202 
203 # -- Extension configuration -------------------------------------------------
204 
205 autodoc_member_order = "bysource"
206 
207 #  -- sphinx-copybutton configuration ----------------------------------------
208 copybutton_prompt_text = (
209     r">>> |\.\.\. |> |\$ |\# | In \[\d*\]: | {2,5}\.\.\.: | {5,8}: "
210 )
211 copybutton_prompt_is_regexp = True
212 copybutton_remove_prompts = True
213 
214 # -- Options for intersphinx extension ---------------------------------------
215 
216 # Example configuration for intersphinx: refer to the Python standard library.
217 intersphinx_mapping = {"<name>": ("https://docs.python.org/3/", None)}
218
```
--- 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
@@ -13,10 +13,13 @@
 #
 
 import os
+import re
 import string
 from importlib.metadata import version
 from pathlib import Path
 
+from sphinx.application import Sphinx
+
 CURRENT_DIR = Path(__file__).parent
 
 
@@ -29,6 +32,36 @@
         f.write(svg)
 
 
+def replace_pr_numbers_with_links(content: str) -> str:
+    """Replaces all PR numbers with the corresponding GitHub link."""
+
+    base_url = "https://github.com/psf/black/pull/"
+    pr_num_regex = re.compile(r"\(#(\d+)\)")
+
+    def num_to_link(match: re.Match[str]) -> str:
+        number = match.group(1)
+        url = f"{base_url}{number}"
+        return f"([#{number}]({url}))"
+
+    return pr_num_regex.sub(num_to_link, content)
+
+
+def handle_include_read(
+    app: Sphinx,
+    relative_path: Path,
+    parent_docname: str,
+    content: list[str],
+) -> None:
+    """Handler for the include-read sphinx event."""
+    if parent_docname == "change_log":
+        content[0] = replace_pr_numbers_with_links(content[0])
+
+
+def setup(app: Sphinx) -> None:
+    """Sets up a minimal sphinx extension."""
+    app.connect("include-read", handle_include_read)
+
+
 # Necessary so Click doesn't hit an encode error when called by
 # sphinxcontrib-programoutput on Windows.
 os.putenv("pythonioencoding", "utf-8")

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -13,10 +13,13 @@\n #\n \n import os\n+import re\n import string\n from importlib.metadata import version\n from pathlib import Path\n \n+from sphinx.application import Sphinx\n+\n CURRENT_DIR = Path(__file__).parent\n \n \n@@ -29,6 +32,36 @@\n         f.write(svg)\n \n \n+def replace_pr_numbers_with_links(content: str) -> str:\n+    \"\"\"Replaces all PR numbers with the corresponding GitHub link.\"\"\"\n+\n+    base_url = \"https://github.com/psf/black/pull/\"\n+    pr_num_regex = re.compile(r\"\\(#(\\d+)\\)\")\n+\n+    def num_to_link(match: re.Match[str]) -> str:\n+        number = match.group(1)\n+        url = f\"{base_url}{number}\"\n+        return f\"([#{number}]({url}))\"\n+\n+    return pr_num_regex.sub(num_to_link, content)\n+\n+\n+def handle_include_read(\n+    app: Sphinx,\n+    relative_path: Path,\n+    parent_docname: str,\n+    content: list[str],\n+) -> None:\n+    \"\"\"Handler for the include-read sphinx event.\"\"\"\n+    if parent_docname == \"change_log\":\n+        content[0] = replace_pr_numbers_with_links(content[0])\n+\n+\n+def setup(app: Sphinx) -> None:\n+    \"\"\"Sets up a minimal sphinx extension.\"\"\"\n+    app.connect(\"include-read\", handle_include_read)\n+\n+\n # Necessary so Click doesn't hit an encode error when called by\n # sphinxcontrib-programoutput on Windows.\n os.putenv(\"pythonioencoding\", \"utf-8\")\n", "issue": "Create URL links to actual PRs rather than simply referencing the PR number\nThe change log is immensely useful, however it makes reference to specific Github PRs and only mentions the PR number without actually linking to the issue.\r\n\r\nI would like for the changelog to actually include links to the issue. It would be of great help to readers to be able to see the contextual discussion for a change, particularly for style changes.\r\n\r\nhttps://black.readthedocs.io/en/stable/change_log.html\r\n\n", "before_files": [{"content": "#\n# Configuration file for the Sphinx documentation builder.\n#\n# This file does only contain a selection of the most common options. For a\n# full list see the documentation:\n# http://www.sphinx-doc.org/en/stable/config\n\n# -- Path setup --------------------------------------------------------------\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\n\nimport os\nimport string\nfrom importlib.metadata import version\nfrom pathlib import Path\n\nCURRENT_DIR = Path(__file__).parent\n\n\ndef make_pypi_svg(version: str) -> None:\n    template: Path = CURRENT_DIR / \"_static\" / \"pypi_template.svg\"\n    target: Path = CURRENT_DIR / \"_static\" / \"pypi.svg\"\n    with open(str(template), encoding=\"utf8\") as f:\n        svg: str = string.Template(f.read()).substitute(version=version)\n    with open(str(target), \"w\", encoding=\"utf8\") as f:\n        f.write(svg)\n\n\n# Necessary so Click doesn't hit an encode error when called by\n# sphinxcontrib-programoutput on Windows.\nos.putenv(\"pythonioencoding\", \"utf-8\")\n\n# -- Project information -----------------------------------------------------\n\nproject = \"Black\"\ncopyright = \"2018-Present, \u0141ukasz Langa and contributors to Black\"\nauthor = \"\u0141ukasz Langa and contributors to Black\"\n\n# Autopopulate version\n# The version, including alpha/beta/rc tags, but not commit hash and datestamps\nrelease = version(\"black\").split(\"+\")[0]\n# The short X.Y version.\nversion = release\nfor sp in \"abcfr\":\n    version = version.split(sp)[0]\n\nmake_pypi_svg(release)\n\n\n# -- General configuration ---------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\nneeds_sphinx = \"4.4\"\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n    \"sphinx.ext.autodoc\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.napoleon\",\n    \"myst_parser\",\n    \"sphinxcontrib.programoutput\",\n    \"sphinx_copybutton\",\n]\n\n# If you need extensions of a certain version or higher, list them here.\nneeds_extensions = {\"myst_parser\": \"0.13.7\"}\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\nsource_suffix = [\".rst\", \".md\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = \"en\"\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This pattern also affects html_static_path and html_extra_path .\n\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# We need headers to be linkable to so ask MyST-Parser to autogenerate anchor IDs for\n# headers up to and including level 3.\nmyst_heading_anchors = 3\n\n# Prettier support formatting some MyST syntax but not all, so let's disable the\n# unsupported yet still enabled by default ones.\nmyst_disable_syntax = [\n    \"colon_fence\",\n    \"myst_block_break\",\n    \"myst_line_comment\",\n    \"math_block\",\n]\n\n# Optional MyST Syntaxes\nmyst_enable_extensions = []\n\n# -- Options for HTML output -------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = \"furo\"\nhtml_logo = \"_static/logo2-readme.png\"\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\n# Custom sidebar templates, must be a dictionary that maps document names\n# to template names.\n#\n# The default sidebars (for documents that don't match any pattern) are\n# defined by theme itself.  Builtin themes are using these templates by\n# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',\n# 'searchbox.html']``.\n#\n# html_sidebars = {}\n\n\n# -- Options for HTMLHelp output ---------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"blackdoc\"\n\n\n# -- Options for LaTeX output ------------------------------------------------\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [(\n    master_doc,\n    \"black.tex\",\n    \"Documentation for Black\",\n    \"\u0141ukasz Langa and contributors to Black\",\n    \"manual\",\n)]\n\n\n# -- Options for manual page output ------------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(master_doc, \"black\", \"Documentation for Black\", [author], 1)]\n\n\n# -- Options for Texinfo output ----------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [(\n    master_doc,\n    \"Black\",\n    \"Documentation for Black\",\n    author,\n    \"Black\",\n    \"The uncompromising Python code formatter\",\n    \"Miscellaneous\",\n)]\n\n\n# -- Options for Epub output -------------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = project\nepub_author = author\nepub_publisher = author\nepub_copyright = copyright\n\n# The unique identifier of the text. This can be a ISBN number\n# or the project homepage.\n#\n# epub_identifier = ''\n\n# A unique identification for the text.\n#\n# epub_uid = ''\n\n# A list of files that should not be packed into the epub file.\nepub_exclude_files = [\"search.html\"]\n\n\n# -- Extension configuration -------------------------------------------------\n\nautodoc_member_order = \"bysource\"\n\n#  -- sphinx-copybutton configuration ----------------------------------------\ncopybutton_prompt_text = (\n    r\">>> |\\.\\.\\. |> |\\$ |\\# | In \\[\\d*\\]: | {2,5}\\.\\.\\.: | {5,8}: \"\n)\ncopybutton_prompt_is_regexp = True\ncopybutton_remove_prompts = True\n\n# -- Options for intersphinx extension ---------------------------------------\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\"<name>\": (\"https://docs.python.org/3/\", None)}\n", "path": "docs/conf.py"}], "after_files": [{"content": "#\n# Configuration file for the Sphinx documentation builder.\n#\n# This file does only contain a selection of the most common options. For a\n# full list see the documentation:\n# http://www.sphinx-doc.org/en/stable/config\n\n# -- Path setup --------------------------------------------------------------\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\n\nimport os\nimport re\nimport string\nfrom importlib.metadata import version\nfrom pathlib import Path\n\nfrom sphinx.application import Sphinx\n\nCURRENT_DIR = Path(__file__).parent\n\n\ndef make_pypi_svg(version: str) -> None:\n    template: Path = CURRENT_DIR / \"_static\" / \"pypi_template.svg\"\n    target: Path = CURRENT_DIR / \"_static\" / \"pypi.svg\"\n    with open(str(template), encoding=\"utf8\") as f:\n        svg: str = string.Template(f.read()).substitute(version=version)\n    with open(str(target), \"w\", encoding=\"utf8\") as f:\n        f.write(svg)\n\n\ndef replace_pr_numbers_with_links(content: str) -> str:\n    \"\"\"Replaces all PR numbers with the corresponding GitHub link.\"\"\"\n\n    base_url = \"https://github.com/psf/black/pull/\"\n    pr_num_regex = re.compile(r\"\\(#(\\d+)\\)\")\n\n    def num_to_link(match: re.Match[str]) -> str:\n        number = match.group(1)\n        url = f\"{base_url}{number}\"\n        return f\"([#{number}]({url}))\"\n\n    return pr_num_regex.sub(num_to_link, content)\n\n\ndef handle_include_read(\n    app: Sphinx,\n    relative_path: Path,\n    parent_docname: str,\n    content: list[str],\n) -> None:\n    \"\"\"Handler for the include-read sphinx event.\"\"\"\n    if parent_docname == \"change_log\":\n        content[0] = replace_pr_numbers_with_links(content[0])\n\n\ndef setup(app: Sphinx) -> None:\n    \"\"\"Sets up a minimal sphinx extension.\"\"\"\n    app.connect(\"include-read\", handle_include_read)\n\n\n# Necessary so Click doesn't hit an encode error when called by\n# sphinxcontrib-programoutput on Windows.\nos.putenv(\"pythonioencoding\", \"utf-8\")\n\n# -- Project information -----------------------------------------------------\n\nproject = \"Black\"\ncopyright = \"2018-Present, \u0141ukasz Langa and contributors to Black\"\nauthor = \"\u0141ukasz Langa and contributors to Black\"\n\n# Autopopulate version\n# The version, including alpha/beta/rc tags, but not commit hash and datestamps\nrelease = version(\"black\").split(\"+\")[0]\n# The short X.Y version.\nversion = release\nfor sp in \"abcfr\":\n    version = version.split(sp)[0]\n\nmake_pypi_svg(release)\n\n\n# -- General configuration ---------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\nneeds_sphinx = \"4.4\"\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n    \"sphinx.ext.autodoc\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.napoleon\",\n    \"myst_parser\",\n    \"sphinxcontrib.programoutput\",\n    \"sphinx_copybutton\",\n]\n\n# If you need extensions of a certain version or higher, list them here.\nneeds_extensions = {\"myst_parser\": \"0.13.7\"}\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\nsource_suffix = [\".rst\", \".md\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = \"en\"\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This pattern also affects html_static_path and html_extra_path .\n\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# We need headers to be linkable to so ask MyST-Parser to autogenerate anchor IDs for\n# headers up to and including level 3.\nmyst_heading_anchors = 3\n\n# Prettier support formatting some MyST syntax but not all, so let's disable the\n# unsupported yet still enabled by default ones.\nmyst_disable_syntax = [\n    \"colon_fence\",\n    \"myst_block_break\",\n    \"myst_line_comment\",\n    \"math_block\",\n]\n\n# Optional MyST Syntaxes\nmyst_enable_extensions = []\n\n# -- Options for HTML output -------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = \"furo\"\nhtml_logo = \"_static/logo2-readme.png\"\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\n# Custom sidebar templates, must be a dictionary that maps document names\n# to template names.\n#\n# The default sidebars (for documents that don't match any pattern) are\n# defined by theme itself.  Builtin themes are using these templates by\n# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',\n# 'searchbox.html']``.\n#\n# html_sidebars = {}\n\n\n# -- Options for HTMLHelp output ---------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"blackdoc\"\n\n\n# -- Options for LaTeX output ------------------------------------------------\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [(\n    master_doc,\n    \"black.tex\",\n    \"Documentation for Black\",\n    \"\u0141ukasz Langa and contributors to Black\",\n    \"manual\",\n)]\n\n\n# -- Options for manual page output ------------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(master_doc, \"black\", \"Documentation for Black\", [author], 1)]\n\n\n# -- Options for Texinfo output ----------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [(\n    master_doc,\n    \"Black\",\n    \"Documentation for Black\",\n    author,\n    \"Black\",\n    \"The uncompromising Python code formatter\",\n    \"Miscellaneous\",\n)]\n\n\n# -- Options for Epub output -------------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = project\nepub_author = author\nepub_publisher = author\nepub_copyright = copyright\n\n# The unique identifier of the text. This can be a ISBN number\n# or the project homepage.\n#\n# epub_identifier = ''\n\n# A unique identification for the text.\n#\n# epub_uid = ''\n\n# A list of files that should not be packed into the epub file.\nepub_exclude_files = [\"search.html\"]\n\n\n# -- Extension configuration -------------------------------------------------\n\nautodoc_member_order = \"bysource\"\n\n#  -- sphinx-copybutton configuration ----------------------------------------\ncopybutton_prompt_text = (\n    r\">>> |\\.\\.\\. |> |\\$ |\\# | In \\[\\d*\\]: | {2,5}\\.\\.\\.: | {5,8}: \"\n)\ncopybutton_prompt_is_regexp = True\ncopybutton_remove_prompts = True\n\n# -- Options for intersphinx extension ---------------------------------------\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\"<name>\": (\"https://docs.python.org/3/\", None)}\n", "path": "docs/conf.py"}]}