Skip to content

Commit

Permalink
[DOCS] Added .readthedocs.yaml file
Browse files Browse the repository at this point in the history
  • Loading branch information
francis-clairicia committed Nov 1, 2023
1 parent 941d7e8 commit 587f9b5
Show file tree
Hide file tree
Showing 3 changed files with 27 additions and 3 deletions.
18 changes: 18 additions & 0 deletions .readthedocs.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
version: 2

build:
os: ubuntu-22.04
tools:
python: "3.11"
jobs:
post_create_environment:
- pip install pdm
- pdm config python.use_venv false
- pdm config check_update false
post_install:
- pdm sync --no-self --dev --group=doc
pre_build:
- python -m sphinx -b linkcheck -D docs/source/ $READTHEDOCS_OUTPUT/linkcheck

sphinx:
configuration: docs/source/conf.py
11 changes: 8 additions & 3 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@
exclude_patterns = ["_include", "_extensions"]


# -- sphinx.ext.autodoc configuration -------------------------------------------
# -- sphinx.ext.autodoc configuration ----------------------------------------
# https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html

autoclass_content = "both"
Expand Down Expand Up @@ -92,7 +92,7 @@
}


# -- sphinx.ext.napoleon configuration -------------------------------------------
# -- sphinx.ext.napoleon configuration ---------------------------------------
# https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html

napoleon_numpy_docstring = False
Expand Down Expand Up @@ -131,9 +131,14 @@
html_theme = "sphinx_rtd_theme"
html_static_path = []

# -- sphinx-rtd-theme configuration -------------------------------------
# -- sphinx-rtd-theme configuration ------------------------------------------
# https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html

html_theme_options = {
"navigation_depth": -1, # Unlimited
}

# -- Options for the linkcheck builder ---------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-the-linkcheck-builder

linkcheck_timeout = 1
1 change: 1 addition & 0 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,7 @@ exclude = [
".github/",
".vscode/",
".bumpversion.cfg",
".readthedocs.yaml",
]

[tool.hatch.build.targets.wheel]
Expand Down

0 comments on commit 587f9b5

Please sign in to comment.