Add basthon support

Co-authored-by: Chris Holdgraf <[email protected]>
Co-authored-by: Angus Hollands <[email protected]>

Author: 3 people

docs/conf.py

@@ -113,6 +113,7 @@
         "binderhub_url": "https://mybinder.org",
         "colab_url": "https://colab.research.google.com/",
         "deepnote_url": "https://deepnote.com/",
+        "basthon_url": "https://notebook.basthon.fr/",
         "notebook_interface": "jupyterlab",
         "thebe": True,
         # "jupyterhub_url": "https://datahub.berkeley.edu",  # For testing

docs/content/launch.md

@@ -67,6 +67,7 @@ html_theme_options = {
     ...
 }
 ```
+
 ## Deepnote
 
 To add [Deepnote](https://deepnote.com) links to your page, add the following configuration:
@@ -85,6 +86,23 @@ html_theme_options = {
 This will create a new Deepnote project every time you click the launch button.
 ```
 
+## Basthon
+
+To add [Basthon](https://basthon.fr/) links to your page, add the following configuration:
+
+```python
+html_theme_options = {
+    ...
+    "launch_buttons": {
+        "basthon_url": "https://notebook.basthon.fr"
+    },
+    ...
+}
+```
+
+```{tip}
+By default, a Python kernel is used. You can add "/sql" or "/ocaml" to basthon_url to run a notebook with another language.
+```
 
 ## Live code cells with Thebe
 

src/sphinx_book_theme/header_buttons/launch.py

@@ -114,6 +114,7 @@ def add_launch_buttons(
     jupyterhub_url = launch_buttons.get("jupyterhub_url", "").strip("/")
     binderhub_url = launch_buttons.get("binderhub_url", "").strip("/")
     colab_url = launch_buttons.get("colab_url", "").strip("/")
+    basthon_url = launch_buttons.get("basthon_url", "").strip("/")
     deepnote_url = launch_buttons.get("deepnote_url", "").strip("/")
 
     # Loop through each provider and add a button for it if needed
@@ -188,6 +189,19 @@ def add_launch_buttons(
                 }
             )
 
+    if basthon_url:
+        gh = "https://raw.githubusercontent.com"
+        url = f"{basthon_url}/?from={gh}/{org}/{repo}/{branch}/{path_rel_repo}"
+        launch_buttons_list.append(
+            {
+                "type": "link",
+                "text": "Basthon",
+                "tooltip": "Launch on Basthon",
+                "icon": "_static/images/logo_basthon.png",
+                "url": url,
+            }
+        )
+
     # Add thebe flag in context
     if launch_buttons.get("thebe", False):
         launch_buttons_list.append(

src/sphinx_book_theme/theme/sphinx_book_theme/static/images/logo_basthon.png

@@ -27,6 +27,7 @@
         "jupyterhub_url": "https://datahub.berkeley.edu",
         "colab_url": "https://colab.research.google.com",
         "deepnote_url": "https://deepnote.com",
+        "basthon_url": "https://notebook.basthon.fr",
         "notebook_interface": "jupyterlab",
         "thebe": True,
     },

tests/sites/base/conf.py

@@ -57,6 +57,16 @@
          </span>
         </a>
        </li>
+       <li>
+        <a class="btn btn-sm dropdown-item" data-bs-placement="left" data-bs-toggle="tooltip" href="https://notebook.basthon.fr/?from=https://raw.githubusercontent.com/executablebooks/sphinx-book-theme/master/TESTPATH/section1/ntbk.ipynb" target="_blank" title="Launch on Basthon">
+         <span class="btn__icon-container">
+          <img src="../_static/images/logo_basthon.png"/>
+         </span>
+         <span class="btn__text-container">
+          Basthon
+         </span>
+        </a>
+       </li>
        <li>
         <button class="btn btn-sm btn-launch-thebe dropdown-item" data-bs-placement="left" data-bs-toggle="tooltip" onclick="initThebeSBT()" title="Launch Thebe">
          <span class="btn__icon-container">

tests/test_build/build__header-article.html

@@ -44,6 +44,16 @@
     </span>
    </a>
   </li>
+  <li>
+   <a class="btn btn-sm dropdown-item" data-bs-placement="left" data-bs-toggle="tooltip" href="https://notebook.basthon.fr/?from=https://raw.githubusercontent.com/executablebooks/sphinx-book-theme/master/TESTPATH/section1/ntbk.ipynb" target="_blank" title="Launch on Basthon">
+    <span class="btn__icon-container">
+     <img src="../_static/images/logo_basthon.png"/>
+    </span>
+    <span class="btn__text-container">
+     Basthon
+    </span>
+   </a>
+  </li>
   <li>
    <button class="btn btn-sm btn-launch-thebe dropdown-item" data-bs-placement="left" data-bs-toggle="tooltip" onclick="initThebeSBT()" title="Launch Thebe">
     <span class="btn__icon-container">