DOC remove top bar of juypterlite in try examples (#178)

Author: MatthewSZhang

doc/conf.py

@@ -69,9 +69,9 @@
 
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
-# Third-party theme: pip install furo
-html_theme = "furo"
+html_theme = "pydata_sphinx_theme"
 html_static_path = ["images", "css"]
+html_css_files = ["fastcan.css"]
 
 
 # intersphinx configuration

doc/css/fastcan.css

@@ -1,21 +1,38 @@
+/* Buttons for JupyterLite-enabled interactive examples */
+
 .try_examples_button {
-    color: white;
-    background-color: #0054a6;
-    border: none;
-    padding: 5px 10px;
-    border-radius: 10px;
-    margin-bottom: 5px;
-    box-shadow: 0 2px 5px rgba(108,108,108,0.2);
+  color: white;
+  background-color: var(--pst-color-info);
+  border: none;
+  padding: 5px 10px;
+  border-radius: 0.25rem;
+  margin-top: 3px;  /* better alignment under admonitions */
+  margin-bottom: 5px !important; /* fix uneven button sizes under admonitions */
+  box-shadow: 0 2px 5px rgba(108, 108, 108, 0.2);
+  font-weight: bold;
+  font-size: small;
+}
+
+/* Use more accessible colours for text in dark mode */
+[data-theme=dark] .try_examples_button {
+  color: black;
 }
 
 .try_examples_button:hover {
-    background-color: #0066cc;
-    transform: scale(1.02);
-    box-shadow: 0 2px 5px rgba(0, 0, 0, 0.2);
-    cursor: pointer;
+  transform: scale(1.02);
+  box-shadow: 0 2px 5px rgba(0, 0, 0, 0.2);
+  cursor: pointer;
 }
 
 .try_examples_button_container {
-    display: flex;
-    justify-content: flex-end;
+  display: flex;
+  justify-content: flex-start;
+  gap: 10px;
+  margin-bottom: 20px;
+}
+
+/* Better gaps for examples buttons under admonitions */
+
+.try_examples_outer_iframe {
+  margin-top: 0.4em;
 }

doc/index.rst

@@ -1,11 +1,24 @@
-+-----------------------------------------+-----------------------------------------+-----------------------------------------+-----------------------------------------+
-| .. figure:: images/tongji-logo.jpg      | .. figure:: images/sheffield-logo.svg   | .. figure:: images/shmc.png             | .. figure:: images/DRG-logo.png         |
-|   :target: https://www.tongji.edu.cn/   |   :target: https://www.sheffield.ac.uk/ |   :target: https://shmc.tongji.edu.cn/  |   :target: https://drg.ac.uk/           |
-|   :figwidth: 70pt                       |   :figwidth: 70pt                       |   :figwidth: 70pt                       |   :figwidth: 70pt                       |
-|   :alt: Tongji                          |   :alt: Sheffield                       |   :alt: SHMC                            |   :alt: DRG                             |
-|                                         |                                         |                                         |                                         |
-|                                         |                                         |                                         |                                         |
-+-----------------------------------------+-----------------------------------------+-----------------------------------------+-----------------------------------------+
+.. |tongji| image:: images/tongji-logo.jpg
+   :target: https://www.tongji.edu.cn/
+   :width: 70pt
+   :alt: Tongji
+
+.. |sheffield| image:: images/sheffield-logo.svg
+   :target: https://www.sheffield.ac.uk/
+   :width: 70pt
+   :alt: Sheffield
+
+.. |shmc| image:: images/shmc.png
+   :target: https://shmc.tongji.edu.cn/
+   :width: 70pt
+   :alt: SHMC
+
+.. |drg| image:: images/DRG-logo.png
+   :target: https://drg.ac.uk/
+   :width: 70pt
+   :alt: DRG
+
+.. centered:: |tongji| |sheffield| |shmc| |drg|
 
 .. include:: ../README.rst
 

doc/jupyter_lite_config.json

@@ -0,0 +1,5 @@
+{
+  "LiteBuildConfig": {
+    "no_sourcemaps": true
+  }
+}