Merge pull request #946 from meowmeowmeowcat/copy-button

Author: webknjaz

requirements.txt

@@ -2,4 +2,5 @@ sphinx==4.0.3
 sphinx-autobuild==0.7.1
 sphinx-inline-tabs==2021.4.11b9
 python-docs-theme==2021.5
+sphinx-copybutton==0.4.0
 git+https://github.com/pypa/pypa-docs-theme.git#egg=pypa-docs-theme

source/_static/overrides.css

@@ -0,0 +1,8 @@
+/* Overrides for theme and plugin styles */
+
+/* https://github.com/executablebooks/sphinx-copybutton/blob/v0.4.0/sphinx_copybutton/_static/copybutton.css */
+
+button.copybtn img {
+    /* Fix alignment for pypa_theme */
+    padding: 0;
+}

source/conf.py

@@ -35,8 +35,13 @@
     'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
     'sphinx_inline_tabs',
+    'sphinx_copybutton',
 ]
 
+# config for copy button
+copybutton_prompt_text = r">>> |\.\.\. |\$ |> "
+copybutton_prompt_is_regexp = True
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -176,7 +181,9 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-# html_static_path = ['_static']
+html_static_path = ['_static']
+
+html_css_files = ['overrides.css']
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied