Skip to content

Fix docs building #2464

@vfdev-5

Description

@vfdev-5

📚 Documentation

Following #2457 docs build is failing due to copying of orphaned defaults.rst file:

 Configuration error:
There is a programmable error in your configuration file:

Traceback (most recent call last):
  File "/opt/hostedtoolcache/Python/3.7.12/x64/lib/python3.7/site-packages/sphinx/config.py", line 328, in eval_config_file
    exec(code, namespace)
  File "/tmp/tmpy5n1diwnsphinxcontrib_versioning/f4ffa27253e329a9d29a679bcba4756f262bcc2d/docs/source/conf.py", line 74, in <module>
    shutil.copy(os.path.join(src_folder, "defaults.rst"), gen_folder)
  File "/opt/hostedtoolcache/Python/3.7.12/x64/lib/python3.7/shutil.py", line 248, in copy
    copyfile(src, dst, follow_symlinks=follow_symlinks)
  File "/opt/hostedtoolcache/Python/3.7.12/x64/lib/python3.7/shutil.py", line 120, in copyfile
    with open(src, 'rb') as fsrc:
FileNotFoundError: [Errno 2] No such file or directory: '/tmp/tmpy5n1diwnsphinxcontrib_versioning/f4ffa27253e329a9d29a679bcba4756f262bcc2d/docs/source/defaults.rst'

Process Process-2:
Traceback (most recent call last):
  File "/opt/hostedtoolcache/Python/3.7.12/x64/lib/python3.7/multiprocessing/process.py", line 297, in _bootstrap
    self.run()
  File "/opt/hostedtoolcache/Python/3.7.12/x64/lib/python3.7/multiprocessing/process.py", line 99, in run
    self._target(*self._args, **self._kwargs)
  File "/opt/hostedtoolcache/Python/3.7.12/x64/lib/python3.7/site-packages/sphinxcontrib/versioning/sphinx_.py", line 208, in _build
    raise SphinxError
sphinx.errors.SphinxError
=> sphinx-build failed for branch/tag: v0.4.8
Failure.

More details on how docs are built:

How everything is executed in the CI:

- name: Install docs deps
run: bash .github/workflows/install_docs_deps.sh
- name: Build docs
run: bash .github/workflows/build_docs.sh

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions