Skip to content

Conversation

@kurtmckee
Copy link

RTD builds are failing. [recent example]

This PR attempts to fix all of the anticipated issues, as well as resolve a number of warnings and info messages displayed when building the docs locally using sphinx-build -b html -n docs/source docs/_build:

WARNING: Invalid configuration value found: 'language = None'.
Update your configuration to a valid language code.
Falling back to 'en' (English).
Converting `source_suffix = '.rst'` to `source_suffix = {'.rst': 'restructuredtext'}`.
WARNING: py:exc reference target not found: seekpath.SupercellWarning [ref.exc]

Read the Docs builds are throwing the following error:

> Config validation error in `build.os`. Value `build` not found.

This commit attempts to address all of the anticipated failures.
This is the full text of the Sphinx warning:

```
WARNING: Invalid configuration value found: 'language = None'.
Update your configuration to a valid language code.
Falling back to 'en' (English).
```
The full text of the Sphinx info message is:

```
Converting `source_suffix = '.rst'` to `source_suffix = {'.rst': 'restructuredtext'}`.
```
Two warnings were thrown for the same underlying issue:

```
WARNING: py:exc reference target not found: seekpath.SupercellWarning [ref.exc]
```
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant