|
15 | 15 | # Defined relative to configuration directory which is where this file conf.py lives |
16 | 16 | sys.path.append(os.path.abspath("exts")) |
17 | 17 |
|
18 | | -# -------- Project information ---------------------------------------------------------- |
| 18 | +# -------- Project information -------------------------------------------------------# |
19 | 19 |
|
20 | 20 | project = "Robotics Toolbox for Python" |
21 | | -copyright = "2022, Jesse Haviland and Peter Corke" |
| 21 | +copyright = "2023, Jesse Haviland and Peter Corke" |
22 | 22 | author = "Jesse Haviland and Peter Corke" |
23 | 23 |
|
24 | 24 | # Parse version number out of setup.py |
25 | 25 | with open("../../setup.py", encoding="utf-8") as f: |
26 | 26 | setup_py = f.read() |
27 | 27 | m = re.search(r"version='([0-9\.]*)',", setup_py, re.MULTILINE) |
28 | 28 |
|
29 | | -# -------- General configuration -------------------------------------------------------- |
| 29 | +# -------- General configuration -----------------------------------------------------# |
30 | 30 |
|
31 | 31 | # Add any Sphinx extension module names here, as strings. They can be |
32 | 32 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
|
74 | 74 | ANSITable._color = False |
75 | 75 | """ |
76 | 76 |
|
77 | | -# -------- Options for HTML output ------------------------------------------------------ |
| 77 | +# -------- Options for HTML output ---------------------------------------------------# |
78 | 78 |
|
79 | 79 | html_theme = "sphinx_rtd_theme" |
80 | 80 |
|
|
102 | 102 | ] |
103 | 103 | default_role = "py:obj" |
104 | 104 |
|
105 | | -# -------- Options for LaTeX/PDF output ------------------------------------------------- |
| 105 | +# -------- Options for LaTeX/PDF output ----------------------------------------------# |
106 | 106 |
|
107 | 107 | latex_engine = "xelatex" |
108 | 108 |
|
|
114 | 114 | } |
115 | 115 |
|
116 | 116 | # Use RVC book notation for maths |
117 | | -# see https://stackoverflow.com/questions/9728292/creating-latex-math-macros-within-sphinx |
| 117 | +# see |
| 118 | +# https://stackoverflow.com/questions/9728292/creating-latex-math-macros-within-sphinx |
118 | 119 | mathjax3_config = { |
119 | 120 | "tex": { |
120 | 121 | "macros": { |
|
151 | 152 | } |
152 | 153 | } |
153 | 154 |
|
154 | | -# -------- Options InterSphinx ---------------------------------------------------------- |
| 155 | +# -------- Options InterSphinx -------------------------------------------------------# |
155 | 156 |
|
156 | 157 | intersphinx_mapping = { |
157 | 158 | "python": ("https://docs.python.org/3", None), |
|
161 | 162 | } |
162 | 163 |
|
163 | 164 |
|
164 | | -# -------- Options Napoleon ------------------------------------------------------------- |
| 165 | +# -------- Options Napoleon ----------------------------------------------------------# |
165 | 166 |
|
166 | 167 | # Include special members (like __membername__) with docstrings in |
167 | 168 | # the documentation |
168 | 169 | napoleon_include_special_with_doc = True |
169 | 170 |
|
170 | 171 | napoleon_custom_sections = ["Synopsis"] |
171 | 172 |
|
172 | | -# -------- Options AutoSummary ---------------------------------------------------------- |
| 173 | +# -------- Options AutoSummary -------------------------------------------------------# |
173 | 174 |
|
174 | 175 | # autodoc_default_flags = ["members"] |
175 | 176 | autosummary_generate = True |
0 commit comments