sphinx-build -b source build (dfm#202)

docs/conf.py

@@ -0,0 +1,38 @@
+project = 'TESS Atlas"'
+copyright = "2022, TESS Atlas community"
+author = "the TESS Atlas community"
+
+html_title = "TESS Atlas"
+html_logo = "_static/atlas_logo.png"
+html_favicon = "_static/atlas_logo.png"
+release = "1"
+extensions = [
+    "sphinx_togglebutton",
+    "sphinx_copybutton",
+    "myst_nb",
+    "jupyter_book",
+    "sphinx_comments",
+    "sphinx_external_toc",
+    "sphinx.ext.intersphinx",
+    "sphinx_design",
+    "sphinx_book_theme",
+]
+# nbsphinx_execute = 'never'
+jupyter_execute_notebooks = "off"
+exclude_patterns = []
+html_theme = "sphinx_book_theme"
+html_theme_options = dict(
+    repository_url="https://github.com/dfm/tess-atlas",
+    use_repository_button=True,
+    use_fullscreen_button=True,
+    use_download_button=True,
+    search_bar_text="Search the Atlas...",
+)
+html_static_path = ["_static"]
+language = None
+pygments_style = "sphinx"
+html_add_permalinks = "¶"
+html_sourcelink_suffix = ""
+numfig = True
+panels_add_bootstrap_css = False
+suppress_warnings = ["myst.domains"]

docs/index.rst

@@ -1,7 +1,7 @@
 TESS Atlas
 ============
 
-*TESS Atlas* contains fits for all the `TESS Objects of intrest <https://exofop.ipac.caltech.edu/tess/>`_ (TOIs).
+*TESS Atlas* contains fits for all the `TESS Objects of interest <https://exofop.ipac.caltech.edu/tess/>`_ (TOIs).
 Here we display the fits, along with the code to reproduce them and posterior samples files from our analysis.
 
 

setup.py

@@ -38,6 +38,8 @@
     "nbconvert~=5.6",
     "jupyter_client==6.1.12",  # pinned beacuse of nbconvert bug https://github.com/jupyter/nbconvert/pull/1549#issuecomment-818734169
     "jupyter-book",
+    "sphinx-book-theme",
+    "sphinx_design",
     "click~=7.1",
     "jupytext",
 ]

src/tess_atlas/webbuilder/build_pages.py

@@ -40,7 +40,9 @@ def make_book(outdir: str, notebooks_dir: str, rebuild: bool):
         notebook_regex=os.path.join(new_notebook_dir, "toi_*.ipynb"),
         path_to_menu_page=os.path.join(outdir, MENU_PAGE),
     )
-    subprocess.run(f"jupyter-book build {outdir}", shell=True, check=True)
+    subprocess.run(
+        f"sphinx-build -b {new_notebook_dir} {outdir}", shell=True, check=True
+    )
 
     print(f"TARing contents")
     subprocess.run(