Integrate SlangPy docs into RTD site (#86)

This replaces the external links to the SlangPy User Guide in the readthedocs index file with references to the internal copy in the submodule. Also adds explicit include matching for the docs, to avoid wasting time building HTML files for docs that do not belong on the readthedocs site.

Author: aidanfnv

docs/__static/theme_overrides.css renamed to docs/_static/theme_overrides.css

@@ -26,4 +26,4 @@ https://github.com/readthedocs/sphinx_rtd_theme/issues/1301
 */
 .py.property {
     display: block !important;
-}
+}

docs/_templates/sidebar/page.html renamed to docs/_templates/page.html

@@ -63,7 +63,19 @@ def setup(app):
 intersphinx_disabled_domains = ['std']
 
 templates_path = ['_templates']
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'index.md']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'index.md',
+                    'external/slang/docs/stdlib-doc.md',
+                    'external/slang/external',
+]
+include_patterns = ['index.rst', '*.md',
+                    "external/slang/docs/user-guide/*.md",
+                    "external/stdlib-reference/index.md",
+                    "external/stdlib-reference/attributes/**",
+                    "external/stdlib-reference/global-decls/**",
+                    "external/stdlib-reference/interface/**",
+                    "external/stdlib-reference/types/**",
+                    "external/slangpy/docs/**",
+]
 
 # Configure myst-parser for markdown files
 myst_enable_extensions = [
@@ -83,6 +95,7 @@ def setup(app):
 
 html_theme = "furo"
 html_title = "Slang Documentation"
+html_static_path = ['_static']
 html_css_files = ["theme_overrides.css"]
 html_theme_options = {
     "light_css_variables": {

docs/conf.py

@@ -9,7 +9,7 @@ Slang Documentation
    User Guide <https://shader-slang.org/slang/user-guide/>
    Standard Modules Reference <external/stdlib-reference/index>
    Language Spec <https://github.com/shader-slang/spec>
-   SlangPy User Guide <https://slangpy.shader-slang.org/en/latest/>
+   SlangPy User Guide <external/slangpy/docs/index.rst>
    Feature Matureness <feature_matureness>
    Command Line Reference <https://github.com/shader-slang/slang/blob/master/docs/command-line-slangc-reference.md>
    Frequently Asked Questions <faq>