|
50 | 50 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
|
51 | 51 | # ones.
|
52 | 52 | extensions = [
|
53 |
| - 'sphinx.ext.autodoc', |
54 |
| - 'sphinx.ext.autosummary', |
55 |
| - 'sphinx.ext.doctest', |
56 |
| - 'sphinx.ext.intersphinx', |
57 |
| - 'sphinx.ext.todo', |
58 |
| - 'sphinx.ext.coverage', |
59 |
| - 'sphinx.ext.mathjax', |
60 |
| - 'sphinx.ext.viewcode', |
61 |
| - 'sphinx.ext.githubpages', |
62 |
| - 'sphinx.ext.napoleon', |
63 |
| - 'sphinx_gallery.gen_gallery', |
| 53 | + 'sphinx.ext.autodoc', |
| 54 | + 'sphinx.ext.autosummary', |
| 55 | + 'sphinx.ext.doctest', |
| 56 | + 'sphinx.ext.intersphinx', |
| 57 | + 'sphinx.ext.todo', |
| 58 | + 'sphinx.ext.coverage', |
| 59 | + 'sphinx.ext.mathjax', |
| 60 | + 'sphinx.ext.viewcode', |
| 61 | + 'sphinx.ext.githubpages', |
| 62 | + 'sphinx.ext.napoleon', |
| 63 | + 'sphinx_gallery.gen_gallery', |
64 | 64 | ]
|
65 | 65 |
|
66 | 66 | if run_intersphinx := False: # Example configuration for intersphinx: refer to the Python standard library.
|
67 | 67 | intersphinx_mapping = {
|
68 |
| - 'numpy' : ('https://numpy.org/doc/stable/', None), |
69 |
| - 'python' : ('https://docs.python.org/{.major}'.format(sys.version_info), None), |
70 |
| - 'matplotlib': ('https://matplotlib.org/stable/', None), |
71 |
| - 'mayavi' : ('http://docs.enthought.com/mayavi/mayavi', None), |
72 |
| - 'sklearn' : ('https://scikit-learn.org/stable', None), |
73 |
| - 'skimage' : ('https://scikit-image.org/docs/dev/', None), |
74 |
| - 'pyvista' : ('https://docs.pyvista.org/', None), |
75 |
| - 'sphinx' : ('https://www.sphinx-doc.org/en/master/', None), |
76 |
| - 'pandas' : ('https://pandas.pydata.org/pandas-docs/stable/', None), |
| 68 | + 'numpy' : ('https://numpy.org/doc/stable/', None), |
| 69 | + 'python' : ('https://docs.python.org/{.major}'.format(sys.version_info), None), |
| 70 | + 'matplotlib': ('https://matplotlib.org/stable/', None), |
| 71 | + 'mayavi' : ('http://docs.enthought.com/mayavi/mayavi', None), |
| 72 | + 'sklearn' : ('https://scikit-learn.org/stable', None), |
| 73 | + 'skimage' : ('https://scikit-image.org/docs/dev/', None), |
| 74 | + 'pyvista' : ('https://docs.pyvista.org/', None), |
| 75 | + 'sphinx' : ('https://www.sphinx-doc.org/en/master/', None), |
| 76 | + 'pandas' : ('https://pandas.pydata.org/pandas-docs/stable/', None), |
77 | 77 | }
|
78 | 78 |
|
79 | 79 | napoleon_google_docstring = True
|
80 | 80 |
|
81 | 81 | autodoc_default_options = {
|
82 |
| - 'autodoc_default_flags': ['members'], |
83 |
| - 'members' : None, |
84 |
| - 'member-order' : 'bysource', |
85 |
| - 'special-members' : '__init__', |
86 |
| - 'undoc-members' : True, |
87 |
| - 'exclude-members' : '__weakref__' |
| 82 | + 'autodoc_default_flags': ['members'], |
| 83 | + 'members' : None, |
| 84 | + 'member-order' : 'bysource', |
| 85 | + 'special-members' : '__init__', |
| 86 | + 'undoc-members' : True, |
| 87 | + 'exclude-members' : '__weakref__' |
88 | 88 | }
|
89 | 89 | autosummary_generate = True
|
90 | 90 | autosummary_imported_members = True
|
|
108 | 108 |
|
109 | 109 | with open(os.path.join(os.path.dirname(__file__), '../../AUTHORS.rst'), 'r') as f:
|
110 | 110 | author = f.read()
|
111 |
| - |
112 |
| -version = gempy.__version__ # The short X.Y version. |
| 111 | + |
| 112 | +version = gempy.__version__ |
113 | 113 | release = gempy.__version__ # The full version, including alpha/beta/rc tags.
|
114 | 114 | today_fmt = '%d %B %Y'
|
115 | 115 | language = 'en'
|
|
120 | 120 | # List of patterns, relative to source directory, that match files and
|
121 | 121 | # directories to ignore when looking for source files.
|
122 | 122 | # This patterns also effect to html_static_path and html_extra_path
|
123 |
| -exclude_patterns = ['_build', '**.ipynb_checkpoints', 'Thumbs.db', '.DS_Store', 'errors.txt', '../test' ] |
| 123 | +exclude_patterns = ['_build', '**.ipynb_checkpoints', 'Thumbs.db', '.DS_Store', 'errors.txt', '../test'] |
124 | 124 |
|
125 | 125 | # The name of the Pygments (syntax highlighting) style to use.
|
126 | 126 | pygments_style = 'sphinx'
|
|
133 | 133 |
|
134 | 134 | # * -- Sphinx Gallery Options
|
135 | 135 | sphinx_gallery_conf = {
|
136 |
| - # path to your examples scripts |
137 |
| - "examples_dirs" : [ |
138 |
| - "../../examples/tutorials", |
139 |
| - "../../examples/examples", |
140 |
| - # "../../examples/integrations", |
141 |
| - ], |
142 |
| - # path where to save gallery generated examples |
143 |
| - "gallery_dirs" : [ |
144 |
| - 'tutorials', |
145 |
| - "examples", |
146 |
| - # 'integrations' |
147 |
| - ], |
148 |
| - "filename_pattern": r"\.py", |
149 |
| - "download_all_examples" : False, # Remove the "Download all examples" button from the top level gallery |
150 |
| - "within_subsection_order": FileNameSortKey, # Sort gallery example by file name instead of number of lines (default) |
151 |
| - "backreferences_dir" : 'gen_modules/backreferences', # directory where function granular galleries are stored |
152 |
| - "doc_module" : ("gempy", "gempy_viewer", 'numpy', 'pandas', 'matplotlib'), # Modules for which function level galleries are created. In |
153 |
| - "image_scrapers" : ('pyvista', 'matplotlib'), |
154 |
| - 'first_notebook_cell' : ("%matplotlib inline\n" |
155 |
| - "from pyvista import set_plot_theme\n" |
156 |
| - "set_plot_theme('document')"), |
157 |
| - 'reference_url' : { |
158 |
| - 'gempy': None, # The module you locally document uses None |
159 |
| - 'numpy': 'https://numpy.org/doc/stable/' |
160 |
| - |
161 |
| - }, |
| 136 | + # path to your examples scripts |
| 137 | + "examples_dirs" : [ |
| 138 | + "../../examples/tutorials", |
| 139 | + "../../examples/examples", |
| 140 | + # "../../examples/integrations", |
| 141 | + ], |
| 142 | + # path where to save gallery generated examples |
| 143 | + "gallery_dirs" : [ |
| 144 | + 'tutorials', |
| 145 | + "examples", |
| 146 | + # 'integrations' |
| 147 | + ], |
| 148 | + "filename_pattern" : r"\.py", |
| 149 | + "download_all_examples" : False, # Remove the "Download all examples" button from the top level gallery |
| 150 | + "within_subsection_order": FileNameSortKey, # Sort gallery example by file name instead of number of lines (default) |
| 151 | + "backreferences_dir" : 'gen_modules/backreferences', # directory where function granular galleries are stored |
| 152 | + "doc_module" : ("gempy", "gempy_viewer", 'numpy', 'pandas', 'matplotlib'), # Modules for which function level galleries are created. In |
| 153 | + "image_scrapers" : ('pyvista', 'matplotlib'), |
| 154 | + 'first_notebook_cell' : ("%matplotlib inline\n" |
| 155 | + "from pyvista import set_plot_theme\n" |
| 156 | + "set_plot_theme('document')"), |
| 157 | + 'reference_url' : { |
| 158 | + 'gempy': None, # The module you locally document uses None |
| 159 | + 'numpy': 'https://numpy.org/doc/stable/' |
| 160 | + |
| 161 | + }, |
162 | 162 | }
|
163 | 163 |
|
164 | 164 | # endregion
|
|
171 | 171 |
|
172 | 172 | html_theme = 'alabaster'
|
173 | 173 | html_theme_options = {
|
174 |
| - 'github_user' : 'gempy-project', |
175 |
| - 'github_repo' : 'gempy', |
176 |
| - 'github_type' : 'star', |
177 |
| - 'logo' : 'logos/gempy.png', |
178 |
| - 'logo_name' : False, |
179 |
| - 'travis_button' : False, |
180 |
| - 'page_width' : '1200px', |
181 |
| - 'fixed_sidebar' : False, |
182 |
| - 'show_related' : True, |
183 |
| - 'sidebar_collapse': True, |
| 174 | + 'github_user' : 'gempy-project', |
| 175 | + 'github_repo' : 'gempy', |
| 176 | + 'github_type' : 'star', |
| 177 | + 'logo' : 'logos/gempy.png', |
| 178 | + 'logo_name' : False, |
| 179 | + 'travis_button' : False, |
| 180 | + 'page_width' : '1200px', |
| 181 | + 'fixed_sidebar' : False, |
| 182 | + 'show_related' : True, |
| 183 | + 'sidebar_collapse': True, |
184 | 184 | }
|
185 | 185 |
|
186 | 186 | # Custom sidebar templates, maps document names to template names.
|
|
0 commit comments