Stubs: preserve blank line between attributes and methods (#2736)

[etc/vim.git] / docs / conf.py

diff --git a/docs/conf.py b/docs/conf.py
index d56737384525537a4c0edda56f8ef57bb30fb203..55d0fa99dc6c2ce290fe0c7ec9b1b31ae7590bf5 100644 (file)
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -12,8 +12,10 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #

-from pathlib import Path
+
+import os

 import string
 import string

+from pathlib import Path

 
 from pkg_resources import get_distribution
 
 
 from pkg_resources import get_distribution
 


@@ -29,6 +31,10 @@ def make_pypi_svg(version: str) -> None:
         f.write(svg)
 
 
         f.write(svg)
 
 

+# Necessary so Click doesn't hit an encode error when called by
+# sphinxcontrib-programoutput on Windows.
+os.putenv("pythonioencoding", "utf-8")
+

 # -- Project information -----------------------------------------------------
 
 project = "Black"
 # -- Project information -----------------------------------------------------
 
 project = "Black"


@@ -59,6 +65,8 @@ extensions = [
     "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
     "myst_parser",
     "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
     "myst_parser",

+    "sphinxcontrib.programoutput",
+    "sphinx_copybutton",

 ]
 
 # If you need extensions of a certain version or higher, list them here.
 ]
 
 # If you need extensions of a certain version or higher, list them here.