|
24 | 24 | import os |
25 | 25 | import sys |
26 | 26 |
|
27 | | -#sys.path.insert(0, os.path.abspath('../../pybpodapi')) |
28 | | -#sys.path.insert(0, os.path.abspath('../../')) |
29 | | - |
30 | | -import pybpodapi |
| 27 | +# sys.path.insert(0, os.path.abspath('../../pybpodapi')) |
| 28 | +# sys.path.insert(0, os.path.abspath('../../')) |
31 | 29 |
|
32 | 30 | # adds support for Markwdown |
33 | 31 | from recommonmark.parser import CommonMarkParser |
| 32 | + |
34 | 33 | source_parsers = { |
35 | | - '.md': CommonMarkParser, |
| 34 | + ".md": CommonMarkParser, |
36 | 35 | } |
37 | 36 |
|
38 | 37 |
|
|
46 | 45 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
47 | 46 | # ones. |
48 | 47 | extensions = [ |
49 | | - 'sphinx.ext.autodoc', |
50 | | - 'sphinx.ext.intersphinx', |
51 | | - 'sphinx.ext.todo', |
52 | | - 'sphinx.ext.viewcode', |
53 | | - 'sphinx.ext.inheritance_diagram'] |
| 48 | + "sphinx.ext.autodoc", |
| 49 | + "sphinx.ext.intersphinx", |
| 50 | + "sphinx.ext.todo", |
| 51 | + "sphinx.ext.viewcode", |
| 52 | + "sphinx.ext.inheritance_diagram", |
| 53 | +] |
54 | 54 |
|
55 | 55 |
|
56 | | -graphviz_output_format = 'svg' |
| 56 | +graphviz_output_format = "svg" |
57 | 57 |
|
58 | 58 | # Do not sort autodoc alphabetically, use source code appearance order. |
59 | | -autodoc_member_order= 'bysource' |
| 59 | +autodoc_member_order = "bysource" |
60 | 60 |
|
61 | 61 | # Both the class’ and the __init__ method’s docstring are concatenated and inserted. |
62 | | -autoclass_content = 'both' |
| 62 | +autoclass_content = "both" |
63 | 63 |
|
64 | 64 | # Add any paths that contain templates here, relative to this directory. |
65 | | -templates_path = ['_templates'] |
| 65 | +templates_path = ["_templates"] |
66 | 66 |
|
67 | 67 | # The suffix(es) of source filenames. |
68 | 68 | # You can specify multiple suffix as a list of string: |
69 | 69 | # |
70 | | -source_suffix = ['.rst', '.md'] |
| 70 | +source_suffix = [".rst", ".md"] |
71 | 71 |
|
72 | 72 | # The master toctree document. |
73 | | -master_doc = 'index' |
| 73 | +master_doc = "index" |
74 | 74 |
|
75 | 75 | # General information about the project. |
76 | | -project = 'pybpod-api' |
77 | | -copyright = '2017-2019, CF Scientific Software Platform' |
78 | | -author = 'Carlos Mão de Ferro' |
| 76 | +project = "pybpod-api" |
| 77 | +copyright = "2017-2019, Scientific Software Platform, Champalimaud Foundation" |
| 78 | +author = "Scientific Software Platform, Champalimaud Foundation" |
79 | 79 |
|
80 | 80 | # The version info for the project you're documenting, acts as replacement for |
81 | 81 | # |version| and |release|, also used in various other places throughout the |
82 | 82 | # built documents. |
83 | 83 | # |
84 | 84 | # The short X.Y version. |
85 | | -version = pybpodapi.__version__ |
86 | | -# The full version, including alpha/beta/rc tags. |
87 | | -release = pybpodapi.__version__ |
| 85 | +version = release = "1.8.2" |
88 | 86 |
|
89 | 87 | # The language for content autogenerated by Sphinx. Refer to documentation |
90 | 88 | # for a list of supported languages. |
|
99 | 97 | exclude_patterns = [] |
100 | 98 |
|
101 | 99 | # The name of the Pygments (syntax highlighting) style to use. |
102 | | -pygments_style = 'default' |
| 100 | +pygments_style = "default" |
103 | 101 |
|
104 | 102 | # If true, `todo` and `todoList` produce output, else they produce nothing. |
105 | 103 | todo_include_todos = True |
|
110 | 108 | # The theme to use for HTML and HTML Help pages. See the documentation for |
111 | 109 | # a list of builtin themes. |
112 | 110 | # |
113 | | -html_theme = 'sphinx_rtd_theme' |
| 111 | +html_theme = "sphinx_rtd_theme" |
114 | 112 |
|
115 | 113 | # Theme options are theme-specific and customize the look and feel of a theme |
116 | 114 | # further. For a list of options available for each theme, see the |
|
119 | 117 | # html_theme_options = {} |
120 | 118 | # toc tree depth on sidebar |
121 | 119 | html_theme_options = { |
122 | | - 'collapse_navigation': False, |
123 | | - 'display_version': True, |
124 | | - 'navigation_depth': 3 |
| 120 | + "collapse_navigation": False, |
| 121 | + "display_version": True, |
| 122 | + "navigation_depth": 3, |
125 | 123 | } |
126 | 124 |
|
127 | 125 | # Add any paths that contain custom static files (such as style sheets) here, |
128 | 126 | # relative to this directory. They are copied after the builtin static files, |
129 | 127 | # so a file named "default.css" will overwrite the builtin "default.css". |
130 | | -html_static_path = ['_images'] |
| 128 | +html_static_path = ["_images"] |
131 | 129 |
|
132 | 130 |
|
133 | 131 | # -- Options for HTMLHelp output ------------------------------------------ |
134 | 132 |
|
135 | 133 | # Output file base name for HTML help builder. |
136 | | -htmlhelp_basename = 'pybpodapidoc' |
| 134 | +htmlhelp_basename = "pybpodapidoc" |
137 | 135 |
|
138 | 136 |
|
139 | 137 | # -- Options for LaTeX output --------------------------------------------- |
140 | 138 |
|
141 | 139 | latex_elements = { |
142 | | - # The paper size ('letterpaper' or 'a4paper'). |
143 | | - # |
144 | | - # 'papersize': 'letterpaper', |
145 | | - |
146 | | - # The font size ('10pt', '11pt' or '12pt'). |
147 | | - # |
148 | | - # 'pointsize': '10pt', |
149 | | - |
150 | | - # Additional stuff for the LaTeX preamble. |
151 | | - # |
152 | | - # 'preamble': '', |
153 | | - |
154 | | - # Latex figure (float) alignment |
155 | | - # |
156 | | - # 'figure_align': 'htbp', |
| 140 | + # The paper size ('letterpaper' or 'a4paper'). |
| 141 | + # |
| 142 | + # 'papersize': 'letterpaper', |
| 143 | + # The font size ('10pt', '11pt' or '12pt'). |
| 144 | + # |
| 145 | + # 'pointsize': '10pt', |
| 146 | + # Additional stuff for the LaTeX preamble. |
| 147 | + # |
| 148 | + # 'preamble': '', |
| 149 | + # Latex figure (float) alignment |
| 150 | + # |
| 151 | + # 'figure_align': 'htbp', |
157 | 152 | } |
158 | 153 |
|
159 | 154 | # Grouping the document tree into LaTeX files. List of tuples |
160 | 155 | # (source start file, target name, title, |
161 | 156 | # author, documentclass [howto, manual, or own class]). |
162 | 157 | latex_documents = [ |
163 | | - (master_doc, 'pybpodapi.tex', 'pybpod-api Documentation', |
164 | | - 'Carlos Mão de Ferro', 'manual'), |
| 158 | + ( |
| 159 | + master_doc, |
| 160 | + "pybpodapi.tex", |
| 161 | + "pybpod-api Documentation", |
| 162 | + "Carlos Mão de Ferro", |
| 163 | + "manual", |
| 164 | + ), |
165 | 165 | ] |
166 | 166 |
|
167 | 167 |
|
168 | 168 | # -- Options for manual page output --------------------------------------- |
169 | 169 |
|
170 | 170 | # One entry per manual page. List of tuples |
171 | 171 | # (source start file, name, description, authors, manual section). |
172 | | -man_pages = [ |
173 | | - (master_doc, 'pybpodapi', 'pybpod-api Documentation', |
174 | | - [author], 1) |
175 | | -] |
| 172 | +man_pages = [(master_doc, "pybpodapi", "pybpod-api Documentation", [author], 1)] |
176 | 173 |
|
177 | 174 |
|
178 | 175 | # -- Options for Texinfo output ------------------------------------------- |
|
181 | 178 | # (source start file, target name, title, author, |
182 | 179 | # dir menu entry, description, category) |
183 | 180 | texinfo_documents = [ |
184 | | - (master_doc, 'pybpodapi', 'pybpod-api Documentation', |
185 | | - author, 'pybpodapi', 'One line description of project.', |
186 | | - 'Miscellaneous'), |
| 181 | + ( |
| 182 | + master_doc, |
| 183 | + "pybpodapi", |
| 184 | + "pybpod-api Documentation", |
| 185 | + author, |
| 186 | + "pybpodapi", |
| 187 | + "One line description of project.", |
| 188 | + "Miscellaneous", |
| 189 | + ), |
187 | 190 | ] |
188 | 191 |
|
189 | 192 |
|
190 | | - |
191 | 193 | # -- Options for Epub output ---------------------------------------------- |
192 | 194 |
|
193 | 195 | # Bibliographic Dublin Core info. |
|
206 | 208 | # epub_uid = '' |
207 | 209 |
|
208 | 210 | # A list of files that should not be packed into the epub file. |
209 | | -epub_exclude_files = ['search.html'] |
210 | | - |
| 211 | +epub_exclude_files = ["search.html"] |
211 | 212 |
|
212 | 213 |
|
213 | 214 | # Example configuration for intersphinx: refer to the Python standard library. |
214 | | -intersphinx_mapping = {'python': ('https://docs.python.org/3.5', None)} |
| 215 | +intersphinx_mapping = {"python": ("https://docs.python.org/3.5", None)} |
| 216 | + |
0 commit comments