From 5f689c80161a6ce5df44412f14ba1dcb1dde7bd6 Mon Sep 17 00:00:00 2001 From: Loup-Garou911XD Date: Thu, 7 Mar 2024 19:01:48 +0530 Subject: [PATCH] Added dummy modules and modules under tools to generation --- src/assets/sphinx/template/conf.py | 3 ++- tools/batools/docs.py | 13 +++++++------ 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/src/assets/sphinx/template/conf.py b/src/assets/sphinx/template/conf.py index 5ea51981..dcc99cdf 100644 --- a/src/assets/sphinx/template/conf.py +++ b/src/assets/sphinx/template/conf.py @@ -20,7 +20,8 @@ sys.path.append(os.path.abspath(ballistica_root+assets_dirs['efro_tools'])) # -- Options for HTML output ------------------------------------------------- -html_theme = 'furo' # python_docs_theme, groundwork, furo +# for more themes visit https://sphinx-themes.org/ +html_theme = 'furo' # python_docs_theme, groundwork, furo # html_logo = ballistica_root + 'build/assets/ba_data/textures/logo_preview.png' # need a smaller img diff --git a/tools/batools/docs.py b/tools/batools/docs.py index 4f02a6f4..7f214383 100755 --- a/tools/batools/docs.py +++ b/tools/batools/docs.py @@ -243,18 +243,19 @@ def _run_sphinx() -> None: shutil.copytree(template_dir, sphinx_apidoc_out, dirs_exist_ok= True) starttime = time.monotonic() - - subprocess.run(['sphinx-apidoc', + + apidoc_cmd = ['sphinx-apidoc', '-f', # Force overwriting of any existing generated files. '-H', 'Bombsquad', # project '-A','Efroemling', # author '-V', str(version), # version '-R', str(buildnum), # release # '--templatedir', template_dir, - '-o', sphinx_apidoc_out, - assets_dirs['ba_data'], ], - check=True) - + '-o', sphinx_apidoc_out, + ] + subprocess.run(apidoc_cmd + [assets_dirs['ba_data']] , check=True) + subprocess.run(apidoc_cmd + [assets_dirs['dummy_modules']], check=True) + subprocess.run(apidoc_cmd + [assets_dirs['efro_tools']], check=True) subprocess.run( ['make', 'html'], check = True, cwd= sphinx_apidoc_out) shutil.copytree(sphinx_apidoc_out + '_build/html/', build_dir, dirs_exist_ok=True)