build: Use html_css_files and html_js_files

Author: jpmckinney

docs/_static/basic.css docs/_static/custom.cssdocs/_static/basic.css renamed to docs/_static/custom.css

@@ -1,5 +1,3 @@
-{% set css_files = css_files + ["_static/renderjson.css", "https://fonts.googleapis.com/css?family=Montserrat", "_static/basic.css"] %}
-{% set script_files = script_files + ["_static/renderjson.js", "_static/json-example-format.js"] %}
 {% extends "!layout.html" %}
 
 {% block developed_by %}

docs/_templates/layout.html

@@ -1,11 +1,8 @@
 # Configuration file for the Sphinx documentation builder.
 #
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
+# For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
-# -- Path setup --------------------------------------------------------------
-
 import csv
 import os
 from glob import glob
@@ -17,6 +14,7 @@
 from sphinx.locale import get_translation
 
 # -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = "Open Contracting for Infrastructure Data Standards Toolkit"
 copyright = "Open Contracting Partnership"
@@ -25,12 +23,9 @@
 version = "0.9"
 release = "0.9.5"
 
-
 # -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
 extensions = [
     "myst_parser",
     "sphinxcontrib.jsonschema",
@@ -39,28 +34,18 @@
     "sphinx_design",
 ]
 
-# Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "**/docson/[!p]**", "**/docson/package*.json"]
 
-
 # -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
 html_theme = "standard_theme"  # 'pydata_sphinx_theme'
 html_theme_path = [standard_theme.get_html_theme_path()]
 html_favicon = "_static/favicon-16x16.ico"
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static", "examples", "../mapping/sustainability.yaml"]
+html_css_files = ["renderjson.css", "https://fonts.googleapis.com/css?family=Montserrat", "custom.css"]
+html_js_files = ["renderjson.js", "json-example-format.js"]
 
 
 # -- Local configuration -----------------------------------------------------