Tweak r doc build

clients/R/convert_docs.R

@@ -14,9 +14,11 @@ for (f in files) {
     # read .Rd file and convert to markdown
     rd <- rd2markdown::get_rd(file = file.path(".", "man", f))
     md <- rd2markdown::rd2markdown(rd, fragments = c())
+    # replaces the headers with more appropriate levels for embedding
+    md_indented <- gsub("(#+)", "\\1##", md)
 
     # write it to the docs folder
-    writeLines(md, file.path("..", "..", "docs", "languages", "_r", paste0(name,
-        ".md")))
+    writeLines(md_indented, file.path("..", "..", "docs", "languages", "_r",
+        paste0(name, ".md")))
 
 }

docs/conf.py

@@ -4,7 +4,6 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 import datetime
-import re
 
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
@@ -132,12 +131,13 @@
 import pathlib
 
 RUNNING_IN_CI = os.environ.get("CI") or os.environ.get("READTHEDOCS")
+BASE_DIR = pathlib.Path(__file__).parent.parent
 
 try:
     print("Building Julia doc")
     subprocess.run(
         ["julia", "--project=.", "./make.jl"],
-        cwd=pathlib.Path(__file__).parent.parent / "clients" / "julia" / "docs",
+        cwd=BASE_DIR / "clients" / "julia" / "docs",
         check=True,
     )
 except Exception as e:
@@ -151,16 +151,10 @@
     print("Building R doc")
     subprocess.run(
         ["Rscript", "convert_docs.R"],
-        cwd=pathlib.Path(__file__).parent.parent / "clients" / "R",
+        cwd=BASE_DIR / "clients" / "R",
         check=True,
     )
 
-    # replaces the headers with more appropriate levels for embedding
-    for f in (pathlib.Path(__file__).parent / "languages" / "_r").iterdir():
-        text = f.read_text()
-        text = re.sub(r"(#+) ", r"##\1 ", text)
-        f.write_text(text)
-
 except Exception as e:
     # fail loudly in Github Actions
     if RUNNING_IN_CI:
@@ -188,7 +182,7 @@
     yarn = os.getenv("YARN", "yarn").split()
     ret = subprocess.run(
         yarn + ["--silent", "doc"],
-        cwd=pathlib.Path(__file__).parent.parent / "clients" / "typescript",
+        cwd=BASE_DIR / "clients" / "typescript",
         check=True,
         capture_output=True,
         text=True,