Parse sphinx output for source code and move to website

Summary: Pull Request resolved: #135

Reviewed By: danielrjiang

Differential Revision: D15155168

Pulled By: Balandat

fbshipit-source-id: 75c1c452ff35c9cf9f6fc9ba8229ee40d7c4c78a

Author: Balandat

scripts/parse_sphinx.py

@@ -25,28 +25,31 @@
 
 
 def parse_sphinx(input_dir, output_dir):
-    for fname in os.listdir(input_dir):
-        if fname.endswith(".html"):
-            with open(input_dir + fname, "r") as f:
-                soup = BeautifulSoup(f.read(), "html.parser")
-                doc = soup.find("div", {"class": "document"})
-                wrapped_doc = doc.wrap(soup.new_tag("div", **{"class": "sphinx"}))
-            # add js
-            if fname == "search.html":
-                out = js_scripts + search_js_scripts + str(wrapped_doc)
-            else:
-                out = js_scripts + str(wrapped_doc)
-            with open(output_dir + fname, "w") as fout:
-                fout.write(out)
+    for cur, _, files in os.walk(input_dir):
+        for fname in files:
+            if fname.endswith(".html"):
+                with open(os.path.join(cur, fname), "r") as f:
+                    soup = BeautifulSoup(f.read(), "html.parser")
+                    doc = soup.find("div", {"class": "document"})
+                    wrapped_doc = doc.wrap(soup.new_tag("div", **{"class": "sphinx"}))
+                # add js
+                if fname == "search.html":
+                    out = js_scripts + search_js_scripts + str(wrapped_doc)
+                else:
+                    out = js_scripts + str(wrapped_doc)
+                output_path = os.path.join(output_dir, os.path.relpath(cur, input_dir))
+                os.makedirs(output_path, exist_ok=True)
+                with open(os.path.join(output_path, fname), "w") as fout:
+                    fout.write(out)
 
-                # update reference in JS file
-                with open(input_dir + "_static/searchtools.js", "r") as js_file:
-                    js = js_file.read()
-                js = js.replace(
-                    "DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/'", "'_sphinx-sources/'"
-                )
-                with open(input_dir + "_static/searchtools.js", "w") as js_file:
-                    js_file.write(js)
+    # update reference in JS file
+    with open(os.path.join(input_dir, "_static/searchtools.js"), "r") as js_file:
+        js = js_file.read()
+    js = js.replace(
+        "DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/'", "'_sphinx-sources/'"
+    )
+    with open(os.path.join(input_dir, "_static/searchtools.js"), "w") as js_file:
+        js_file.write(js)
 
 
 if __name__ == "__main__":

sphinx/source/conf.py

@@ -88,8 +88,7 @@
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#
-# html_theme_options = {}
+html_theme_options = {}
 
 # 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,
@@ -141,7 +140,7 @@
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, "botorch.tex", "botorch Documentation", "Facebook, Inc.", "manual")
+    (master_doc, "botorch.tex", "BoTorch Documentation", "Facebook, Inc.", "manual")
 ]
 
 
@@ -161,9 +160,9 @@
     (
         master_doc,
         "botorch",
-        "botorch Documentation",
+        "BoTorch Documentation",
         author,
-        "botorch",
+        "BoTorch",
         "Bayesian Optimization in PyTorch.",
         "Miscellaneous",
     )