WIP Doc 2.0

source/_static/css/custom.css

@@ -0,0 +1,234 @@
+/* Custom styling for the Pydata Sphinx Theme */
+/* See https://pydata-sphinx-theme.readthedocs.io/en/stable/user_guide/styling.html. */
+
+html {
+    /*****************************************************************************
+     * Font features used in this theme
+     */
+
+    /* base font size - applied at body/html level */
+    --pst-font-size-base: 1rem;
+
+    /* heading font sizes based on a medium contrast type scale */
+    /* - see: https://github.com/Quansight-Labs/czi-scientific-python-mgmt/issues/97#issuecomment-2310531483 */
+    --pst-font-size-h1: 2.625rem;
+    --pst-font-size-h2: 2.125rem;
+    --pst-font-size-h3: 1.75rem;
+    --pst-font-size-h4: 1.5rem;
+    --pst-font-size-h5: 1.25rem;
+    --pst-font-size-h6: 1rem;
+
+    /* smaller than heading font sizes */
+    --pst-font-size-milli: 0.9rem;
+
+    /* Sidebar styles */
+    --pst-sidebar-font-size: 0.9rem;
+    --pst-sidebar-font-size-mobile: 1.1rem;
+    --pst-sidebar-header-font-size: 1.2rem;
+    --pst-sidebar-header-font-weight: 600;
+
+    /* Admonition styles */
+    --pst-admonition-font-weight-heading: 600;
+
+    /* Font weights */
+    --pst-font-weight-caption: 300;
+    --pst-font-weight-heading: 600;
+
+    /* Font family */
+    /* These are adapted from https://systemfontstack.com/ */
+    --pst-font-family-base-system: 'IBM Plex Sans', 'Helvetica Neue', Arial, sans-serif;
+    --pst-font-family-monospace-system: 'IBM Plex Mono', 'Menlo', 'DejaVu Sans Mono',
+                                        'Bitstream Vera Sans Mono', Courier, monospace;
+    --pst-font-family-base: var(--pst-font-family-base-system);
+    --pst-font-family-heading: var(--pst-font-family-base-system);
+    --pst-font-family-monospace: var(--pst-font-family-monospace-system);
+
+
+    /*****************************************************************************
+     * Colors
+     **/
+
+    /* specified with RGB or hexcodes */
+    --pst-color-primary: #48A2AE;
+    --pst-color-primary-text: #333333;
+    --pst-color-secondary: #052535;
+    --pst-color-link: #48A2AE;
+    --pst-color-link-hover: #48A2AE;
+    --pst-color-inline-code: 178, 34, 34;
+    --pst-color-sidebar-link-hover: #48A2AE;
+    --pst-color-toc-link-hover: #48A2AE;
+    --pst-color-toc-link-active: #48A2AE;
+    --pst-color-headerlink: #48A2AE;
+    --pst-color-headerlink-hover: #48A2AE;
+    --bg-color: #ffffff;
+    --heading-color: #333333;
+    --font-color: #333333;
+
+    /*****************************************************************************
+     * Admonitions
+     **/
+
+    --pst-icon-admonition-default: var(--pst-icon-bell);
+    --pst-icon-admonition-note: var(--pst-icon-info-circle);
+    --pst-icon-admonition-attention: var(--pst-icon-exclamation-circle);
+    --pst-icon-admonition-caution: var(--pst-icon-exclamation-triangle);
+    --pst-icon-admonition-warning: var(--pst-icon-exclamation-triangle);
+    --pst-icon-admonition-danger: var(--pst-icon-exclamation-triangle);
+    --pst-icon-admonition-error: var(--pst-icon-times-circle);
+    --pst-icon-admonition-hint: var(--pst-icon-lightbulb);
+    --pst-icon-admonition-tip: var(--pst-icon-lightbulb);
+    --pst-icon-admonition-important: var(--pst-icon-exclamation-circle);
+    --pst-icon-admonition-seealso: var(--pst-icon-share);
+    --pst-icon-admonition-todo: var(--pst-icon-pencil);
+}
+
+
+
+
+/* Consent dialog */
+.consent {
+    position: fixed;
+    right: 0;
+    bottom: 0;
+    max-width: 530px;
+    padding: 30px 45px 25px;
+    background: linear-gradient(157deg, #005A78 -18.68%, #2E8894 95.63%);
+    color: #fff;
+}
+.consent p {
+    margin-bottom: 0.5em;
+    color: #fff;
+    font-size: 14px;
+    font-weight: 300;
+}
+.consent button {
+    padding-left: 1em;
+    padding-right: 1em;
+    margin-left: .5em;
+    margin-right: .5em;
+    background-color: #48A2AE;
+    border-radius: 12px;
+    border-width: 0;
+    color: #fff;
+}
+.consent a:link {
+    margin-left: .5em;
+    color: #ffffff;
+}
+.consent a:visited {
+    color: lightgrey;
+}
+.consent   a:hover {
+    color: lightgrey;
+}
+.consent a:active {
+    color: #d9d9d9;
+}
+
+.bd-links__title {
+    display: none !important;
+}
+
+/* Tutorial page styling */
+.tutorial-section {
+    background-color: #edf2f7;    /* Slightly darker background */
+    padding: 25px 25px 25px 40px !important;    /* top right bottom left - more padding on left */
+    margin: 20px 0;
+    border-radius: 8px;
+    border: 1px solid #cbd5e0;    /* More visible border */
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);  /* Subtle shadow */
+}
+/* Blue container */
+.tutorial-section-blue {
+    background-color: #edf2f7 !important;
+    border: 1px solid #cbd5e0 !important;
+}
+
+/* Green container */
+.tutorial-section-green {
+    background-color: #f0fdf4 !important;    /* Light green */
+    border: 1px solid #dcfce7 !important;
+}
+
+/* Purple container */
+.tutorial-section-purple {
+    background-color: #faf5ff !important;    /* Light purple */
+    border: 1px solid #f3e8ff !important;
+}
+/* Yellow container */
+.tutorial-section-yellow {
+    background-color: #fefce8 !important;    /* Light yellow */
+    border: 1px solid #fef9c3 !important;
+}
+/* Main layout fixes - these were working well */
+.bd-container__inner.bd-page-width {
+    max-width: none;
+    width: 100%;
+}
+
+.bd-main .bd-content {
+    max-width: none;
+    padding: 0 3rem;
+}
+
+.three-columns {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(300px, 1fr));
+    gap: 2.5rem;
+    margin-top: 3rem;
+    margin-bottom: 2rem;
+}
+/* Sidebar max width */
+.bd-sidebar-primary {
+    min-width: 250px;
+    max-width: 20%;
+    flex: 0 0 auto;
+}
+/* Prevent text selection in sidebar navigation */
+.bd-sidebar-primary .bd-links .bd-links__item,
+.bd-sidebar-primary .bd-links .bd-links__item *,
+.bd-sidebar-primary .current,
+.bd-sidebar-primary .toctree-l1,
+.bd-sidebar-primary .toctree-l2,
+.bd-sidebar-primary .reference.internal,
+.bd-sidebar-primary .nav-link {
+    user-select: none;
+    -webkit-user-select: none;
+    -moz-user-select: none;
+    -ms-user-select: none;
+}
+/* Logo positioning */
+.navbar-header-items__start {
+    position: relative;
+    left: 0;
+    padding-left: 1rem;
+    z-index: 1;  /* Reduced z-index */
+    background: white;
+    max-width: 167px; /* Match logo's natural width*/
+}
+
+/* Menu positioning */
+.navbar-header-items:not(.navbar-header-items__start) {
+    margin-left: 200px;
+    position: relative;
+    z-index: 2;  /* Higher than logo */
+    background: white;
+}
+
+img.logo {
+    max-height: 35px;
+    width: auto;
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+    .navbar-header-items__start{
+        max-width: 120px; /* Smaller width on mobile */
+        margin-left: 3rem; /* Make space for menu button */
+    }
+
+    img.logo{
+        width: 100%;
+        height: auto;
+    }
+}

source/_templates/layout.html

@@ -5,11 +5,9 @@
 {# Adds extra headers to the template, such as custom styling #}
 {% block extrahead %}
   <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital,wght@0,400;0,700;1,400;1,700&family=IBM+Plex+Sans:ital,wght@0,400;0,700;1,400;1,700&display=swap" />
-
 {% endblock %}
 
 {% block footer %}
-  {% include "sidenav.html" %}
   {% include "copyright.html" %}
   {% include "footer.html" %}
   {% include "analytics.html" %}

source/academy/custom-errors.rst

@@ -1,5 +1,5 @@
 :orphan:
 
-.. include:: ../mainnet/smart-contracts/guides/custom-errors.rst
+.. include:: ../mainnet/docs/smart-contracts/guides/custom-errors.rst
 
 .. include:: ../mainnet/variables.rst

source/academy/tutorials/counter-contract.rst

@@ -1,2 +1,2 @@
-.. include:: ../../mainnet/smart-contracts/tutorials/counter/counter-contract.rst
+.. include:: ../../mainnet/tutorials/counter/counter-contract.rst
 .. include:: ../../mainnet/variables.rst