change docs theme and simplify navigation back to theme provided navi…

…gation
siliconcompiler · Mar 25, 2024 · 56e0344 · 56e0344
1 parent b8f398c
commit 56e0344
Show file tree

Hide file tree

Showing 7 changed files with 28 additions and 98 deletions.
diff --git a/docs/conf.py b/docs/conf.py
@@ -45,7 +45,6 @@
     'sphinx.ext.napoleon',
     'sphinx.ext.imgconverter',
     'sphinx.ext.autosummary',
-    'sphinx_design',                                  # helps with grid views
     'siliconcompiler.sphinx_ext.dynamicgen',
     'schemagen',
     'clientservergen',
@@ -71,22 +70,13 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'pydata_sphinx_theme'
+html_theme = 'sphinx_rtd_theme'
 
 html_theme_options = {
     "collapse_navigation": True,
-    # 'logo_only': True,
-    # 'display_version': True,
-    # 'navigation_depth': 4,
-    "show_toc_level": 3,   # this automatically displays three levels
-    "logo": {
-        "image_light": 'sc_logo_with_text.png',
-        "image_dark": 'sc_logo_with_text.png',
-    },
-    "github_url": "https://github.com/siliconcompiler/siliconcompiler",  # these are top right
-
-    # Add light/dark mode and documentation version switcher:
-    "navbar_end": ["theme-switcher", "navbar-icon-links"],
+    'logo_only': True,
+    'display_version': True,
+    'navigation_depth': 4,
 }
 
 # Custom sidebar templates, must be a dictionary that maps document names
@@ -135,7 +125,7 @@
 _stdauthor = author
 
 latex_documents = [
-    ('index_pdf', 'siliconcompiler.tex', 'SiliconCompiler',
+    ('index', 'siliconcompiler.tex', 'SiliconCompiler',
         _stdauthor, 'manual'),
 ]
 

diff --git a/docs/index.rst b/docs/index.rst
@@ -1,12 +1,3 @@
-.. Silicon Compiler documentation master file, created by
-   sphinx-quickstart on Sun Apr 11 16:42:34 2021.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-.. This is not the full index page. This will taking to the landing page of docs.silicompiler.com
-   There is a index.rst file for each submenu
-   The content of this page will largely be ignored in pdf generation
-
 ##################################################
 Welcome to SiliconCompiler's Documentation!
 ##################################################
@@ -25,67 +16,26 @@ Welcome to SiliconCompiler's Documentation!
 **Useful Links**:
 :ref:`Installation <installation>` | `GitHub Repo <https://github.com/siliconcompiler/siliconcompiler>`_ | `File an Issue <https://github.com/siliconcompiler/siliconcompiler/issues>`_
 
-.. grid:: 2
-
-    .. grid-item-card::
-
-        The fastest way to get started, after installation, is to walk through a simple demo!
-
-        +++
-
-        .. button-ref:: user_guide/quickstart
-            :expand:
-            :color: secondary
-            :click-parent:
-
-            Quickstart Guide
-
-    .. grid-item-card::
-
-        A more complete introduction for new users, this
-	section is for those who want to use their own designs using pre-defined build flows.
-
-
-        +++
-
-        .. button-ref:: user_guide/index
-            :expand:
-            :color: secondary
-            :click-parent:
-
-            Introductory User Guide
-
-
-    .. grid-item-card::
-
-        This section contains useful lookup information, like flow building blocks, the schema and other API references.
-
-        +++
-
-        .. button-ref:: reference_manual/index
-            :expand:
-            :color: secondary
-            :click-parent:
-
-            Reference Manual
-
-    .. grid-item-card::
 
-        This section is for users who are already familiar with the basics in User Guide and would like to build their own flows or add additional functionality.
+.. include:: user_guide/what_is_sc.rst
 
 
-        +++
+###################################
+Getting started
+###################################
 
-        .. button-ref:: development_guide/index
-            :expand:
-            :color: secondary
-            :click-parent:
+The fastest way to get started, after :ref:`installation <installation>`, is to :ref:`walk through a simple demo! <Quickstart guide>`
 
-            Advanced Guide
+A more complete introduction for new users, the :ref:`Introductory User Guide <User Guide>`
+section is intended for those who want to use their own designs using pre-defined build flows.
 
+:ref:`Reference Manual <References>` section contains useful lookup information,
+like flow building blocks, the schema and other API references.
 
+:ref:`Advanced Guide <Advanced Guide>` is intended for users who are already familiar with the basics in User Guide and would like to build their own flows or add additional functionality.
 
-**Getting Help**
+Help
+----
 
 .. rst-class:: page-break
 

diff --git a/docs/index_pdf.rst b/docs/index_pdf.rst
diff --git a/docs/reference_manual/index.rst b/docs/reference_manual/index.rst
@@ -7,9 +7,9 @@ References
 The following sections provides details on the functions, modules and objects included in SiliconCompiler.
 To learn how to use SiliconCompiler, see the :ref:`user guide`.
 
-.. _building_blocks:
+Building Blocks
+---------------
 .. toctree::
-   :caption: Building Blocks
    :maxdepth: 1
    :numbered:
 
@@ -20,10 +20,10 @@ To learn how to use SiliconCompiler, see the :ref:`user guide`.
    Libraries <predef_modules/libs>
    Checklists <predef_modules/checklists>
 
-.. _api_refs:
 
+API References
+---------------
 .. toctree::
-   :caption: API References
    :maxdepth: 4
    :numbered:
 
@@ -33,8 +33,9 @@ To learn how to use SiliconCompiler, see the :ref:`user guide`.
    server_api
    floorplan_api
 
+Appendix
+--------
 .. toctree::
-   :caption: Appendix
    :maxdepth: 3
    :numbered:
 

diff --git a/docs/user_guide/index.rst b/docs/user_guide/index.rst
@@ -10,7 +10,7 @@ This guide provides an overview for users. You will also want to look at API Ref
    :caption: Getting Started
    :maxdepth: 1
 
-   What is SiliconCompiler? <introduction>
+   What is SiliconCompiler? <what_is_sc>
    Installation <installation>
    Quickstart guide <quickstart>
 

diff --git a/docs/user_guide/introduction.rst → docs/user_guide/what_is_sc.rst b/docs/user_guide/introduction.rst → docs/user_guide/what_is_sc.rst
@@ -23,16 +23,16 @@ The SiliconCompiler project is based on a standardized :ref:`Schema <SiliconComp
 
 To simplify flow development, the project incorporates a simple object oriented :ref:`Python API<Core API>`. The API includes abstracted set/get access to the Schema, a flowgraph based parallel programming model, and a suite of utility functions for compilation setup and metric tracking.
 
-.. image:: ../_images/sc_overview.png
+.. image:: /_images/sc_overview.png
    :scale: 90%
    :align: center
 
-The expansive data schema, standardized plug-in interfaces, and built-in dynamic module search functionality enables SiliconCompiler to scale effectively to a large number of tools and PDKs. The open source :ref:`building_blocks` sections in the reference manual serves as a good starting point for folks who want to add their own PDKs and tools.
+The expansive data schema, standardized plug-in interfaces, and built-in dynamic module search functionality enables SiliconCompiler to scale effectively to a large number of tools and PDKs. The reference manual serves as a good starting point for folks who want to add their own PDKs and tools.
 
 
 To further reduce design access barriers, the project also supports a :ref:`client-server <Remote Processing>` execution model that leverages the cloud to: 1) reduce tool installation barriers, 2) reduce the barrier to massively parallel elastic compute, and 3) address the NDA barrier for PDK and EDA tools.
 
-.. image:: ../_images/sc_arch.svg
+.. image:: /_images/sc_arch.svg
 
 Supported Technologies
 ----------------------

diff --git a/requirements.txt b/requirements.txt
@@ -40,8 +40,7 @@ cython
 #:docs
 Sphinx == 7.2.6
 pip-licenses == 4.3.4
-pydata-sphinx-theme==0.15.2
-sphinx-design == 0.5.0
+sphinx-rtd-theme == 2.0.0
 
 # Testing dependencies
 #:test