|
7 | 7 | # -- Path setup -------------------------------------------------------------- |
8 | 8 |
|
9 | 9 | # If extensions (or modules to document with autodoc) are in another directory, |
10 | | -# add these directories to sys.path here. If the directory is relative to the |
11 | | -# documentation root, use os.path.abspath to make it absolute, like shown here. |
| 10 | +# add these directories to sys.path here. |
12 | 11 |
|
13 | | -import os |
14 | 12 | import sys |
15 | | -sys.path.insert(0, os.path.abspath('../')) |
| 13 | + |
| 14 | +from pathlib import Path |
| 15 | + |
| 16 | +sys.path.insert(0, str(Path(__file__).parent.parent.resolve())) |
16 | 17 |
|
17 | 18 | # -- Project information ----------------------------------------------------- |
18 | 19 |
|
19 | | -project = 'diskmap' |
20 | | -copyright = '2025, Tomas Stolker' |
21 | | -author = 'Tomas Stolker' |
| 20 | +project = "diskmap" |
| 21 | +copyright = "2026, Tomas Stolker" |
| 22 | +author = "Tomas Stolker" |
22 | 23 |
|
23 | 24 | # -- General configuration --------------------------------------------------- |
24 | 25 |
|
25 | 26 | # Add any Sphinx extension module names here, as strings. They can be |
26 | | -# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
| 27 | +# extensions coming with Sphinx (named "sphinx.ext.*") or your custom |
27 | 28 | # ones. |
| 29 | + |
28 | 30 | extensions = [ |
29 | | - 'sphinx.ext.autodoc', |
30 | | - 'sphinx.ext.napoleon', |
31 | | - 'sphinx.ext.viewcode', |
32 | | - 'sphinx_automodapi.automodapi', |
33 | | - 'nbsphinx' |
| 31 | + "sphinx.ext.autodoc", |
| 32 | + "sphinx.ext.autosummary", |
| 33 | + "sphinx.ext.napoleon", |
| 34 | + "sphinx.ext.viewcode", |
| 35 | + "sphinx_automodapi.automodapi", |
| 36 | + "nbsphinx" |
34 | 37 | ] |
35 | 38 |
|
| 39 | +# List of patterns, relative to source directory, that match files and |
| 40 | +# directories to ignore when looking for source files. |
| 41 | +# This pattern also affects html_static_path and html_extra_path. |
| 42 | + |
| 43 | +exclude_patterns = ["_build", |
| 44 | + "Thumbs.db", |
| 45 | + ".DS_Store", |
| 46 | + ".ipynb_checkpoints/*"] |
| 47 | + |
36 | 48 | # Disable notebook timeout |
37 | 49 | nbsphinx_timeout = -1 |
38 | 50 |
|
39 | 51 | # Allow errors from notebooks |
40 | 52 | nbsphinx_allow_errors = True |
41 | 53 |
|
42 | | -autoclass_content = 'both' |
43 | | - |
44 | | -# Add any paths that contain templates here, relative to this directory. |
45 | | -templates_path = [] |
46 | | - |
47 | | -# List of patterns, relative to source directory, that match files and |
48 | | -# directories to ignore when looking for source files. |
49 | | -# This pattern also affects html_static_path and html_extra_path. |
50 | | -exclude_patterns = ['_build', |
51 | | - 'Thumbs.db', |
52 | | - '.DS_Store', |
53 | | - '.ipynb_checkpoints/*'] |
| 54 | +autoclass_content = "both" |
54 | 55 |
|
55 | 56 | # -- Options for HTML output ------------------------------------------------- |
56 | 57 |
|
57 | | -# The theme to use for HTML and HTML Help pages. See the documentation for |
58 | | -# a list of builtin themes. |
59 | | -# |
60 | | -html_theme = 'sphinx_book_theme' |
| 58 | +html_theme = "sphinxawesome_theme" |
61 | 59 |
|
62 | 60 | html_theme_options = { |
63 | | - 'path_to_docs': 'docs', |
64 | | - 'repository_url': 'https://github.com/tomasstolker/diskmap', |
65 | | - 'repository_branch': 'main', |
66 | | - 'launch_buttons': { |
67 | | - 'notebook_interface': 'jupyterlab', |
| 61 | + "show_breadcrumbs": True, |
| 62 | + "show_scrolltop": True, |
| 63 | + "show_prev_next": True, |
| 64 | + "main_nav_links": { |
| 65 | + "GitHub": "https://github.com/tomasstolker/diskmap", |
| 66 | + "PyPI": "https://pypi.org/project/diskmap/", |
68 | 67 | }, |
69 | | - 'use_edit_page_button': True, |
70 | | - 'use_issues_button': True, |
71 | | - 'use_repository_button': True, |
72 | | - 'use_download_button': True, |
73 | 68 | } |
74 | 69 |
|
75 | | -# Add any paths that contain custom static files (such as style sheets) here, |
76 | | -# relative to this directory. They are copied after the builtin static files, |
77 | | -# so a file named "default.css" will overwrite the builtin "default.css". |
78 | | -html_static_path = [] |
| 70 | +html_context = { |
| 71 | + "github_user": "tomasstolker", |
| 72 | + "github_repo": "diskmap", |
| 73 | + "github_version": "main", |
| 74 | + "doc_path": "docs", |
| 75 | +} |
79 | 76 |
|
80 | | -html_logo = 'logo.png' |
81 | | -html_search_language = 'en' |
| 77 | +html_static_path = [] |
82 | 78 |
|
83 | | -html_context = {'display_github': True, |
84 | | - 'github_user': 'tomasstolker', |
85 | | - 'github_repo': 'diskmap', |
86 | | - 'github_version': 'main/docs/'} |
| 79 | +html_logo = "logo.png" |
| 80 | +html_search_language = "en" |
0 commit comments