Fix #522 add --module-first to sphinx.prepare (#523)

git ignore _build_html/
radiasoft · Sep 13, 2024 · c997fc4 · c997fc4
1 parent 6d23eb9
commit c997fc4
Show file tree

Hide file tree

Showing 3 changed files with 3 additions and 1 deletion.
diff --git a/.gitignore b/.gitignore
@@ -58,6 +58,7 @@ coverage.xml
 
 # Sphinx documentation
 docs/_build/
+_build_html/
 
 # PyBuilder
 target/
diff --git a/pykern/package_data/projex/dot-gitignore.jinja b/pykern/package_data/projex/dot-gitignore.jinja
@@ -62,6 +62,7 @@ coverage.xml
 
 # Sphinx documentation
 docs/_build/
+_build_html/
 
 # PyBuilder
 target/
diff --git a/pykern/pkcli/sphinx.py b/pykern/pkcli/sphinx.py
@@ -69,7 +69,7 @@ def _year(rv):
     v = _parse_metadata()
     pykern.pkio.write_text(d.join("conf.py"), _conf(v))
     pykern.pksubprocess.check_call_with_signals(
-        ("sphinx-apidoc", "--force", "-o", d.basename, v.name),
+        ("sphinx-apidoc", "--force", "--module-first", "-o", d.basename, v.name),
     )