Exclude copy button from notebook cell numbers (#1811)

* Exclude copy button from notebook cell numbers

* Update docs/conf.py

* Add note in docs about Sphinx-copybutton and nbsphinx

Author: gabalafou

docs/conf.py

@@ -94,6 +94,11 @@
 togglebutton_hint = str(_("Click to expand"))
 togglebutton_hint_hide = str(_("Click to collapse"))
 
+# -- Sphinx-copybutton options ---------------------------------------------
+# Exclude copy button from appearing over notebook cell numbers by using :not()
+# The default copybutton selector is `div.highlight pre`
+# https://github.com/executablebooks/sphinx-copybutton/blob/master/sphinx_copybutton/__init__.py#L82
+copybutton_selector = ":not(.prompt) > div.highlight pre"
 
 # -- Options for HTML output -------------------------------------------------
 

docs/user_guide/web-components.rst

@@ -263,6 +263,17 @@ You can see it in action by hovering over the code cell below:
 
     print("A copybutton in the top-right!")
 
+.. admonition:: nbsphinx
+
+    If your documentation site uses both nbsphinx and Sphinx-copybutton, you
+    will want to add the following line to your ``conf.py`` file to prevent the
+    copy button from appearing on top of notebook cell numbers:
+
+    .. code-block:: python
+        :caption: conf.py
+
+        copybutton_selector = ":not(.prompt) > div.highlight pre"
+
 Toggle buttons
 ==============