-
Notifications
You must be signed in to change notification settings - Fork 8
/
mkdocs.yml
161 lines (152 loc) · 8.28 KB
/
mkdocs.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
---
site_name: "pyPoseidon"
use_directory_urls: false
repo_url: "https://github.com/ec-jrc/pyPoseidon"
theme:
name: "material"
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
primary: blue
accent: blue
toggle:
icon: material/lightbulb-outline
name: "Switch to dark mode"
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: blue
accent: blue
toggle:
icon: material/lightbulb
name: "Switch to light mode"
nav:
- Overview: index.md
- Installation: installation.md
- Structure: structure.md
- User Guide:
- "Meteo": meteo.md
- "Dem": dem.md
- "Boundary": boundary.md
- "Mesh": mesh.md
- "Model": model.md
- "Utilities": utils.md
- Development: development.md
- API:
- Main: api.md
- utils: api_utils.md
markdown_extensions:
- "admonition"
- "codehilite"
- "pymdownx.tilde"
- "pymdownx.details"
- "pymdownx.superfences"
- toc:
permalink: true
watch:
- "docs"
- "pyposeidon"
plugins:
- "search"
- "autorefs"
- mkdocstrings:
default_handler: python
handlers:
python:
options:
### General
# Whether to allow inspecting modules when visiting them is not possible. Default: True.
allow_inspection: True
# Show the base classes of a class. Default: True.
show_bases: True
# Show the source code of this object. Default: True.
show_source: True
# Pre-load modules that are not specified directly in autodoc instructions (::: identifier). It is useful when you want to render documentation for a particular member of an object, and this member is imported from another package than its parent.
# For an imported member to be rendered, you need to add it to the __all__ attribute of the importing module.
# The modules must be listed as an array of strings. Default: None.
preload_modules: null
### Headings
# The initial heading level to use. Default: 2.
heading_level: 3
# Show the heading of the object at the root of the documentation tree (i.e. the object referenced by the identifier after :::). Default: False.
show_root_heading: True
# If the root heading is not shown, at least add a ToC entry for it. Default: True.
show_root_toc_entry: True
# Show the full Python path for the root object heading. Default: True.
show_root_full_path: True
# Show the full Python path of the root members. Default: False.
show_root_members_full_path: False
# Show the full Python path of every object. Default: False.
show_object_full_path: False
# When grouped by categories, show a heading for each category. Default: False.
show_category_heading: False
# Show the symbol type in headings (e.g. mod, class, meth, func and attr). Default: False.
show_symbol_type_heading: False
# Show the symbol type in the Table of Contents (e.g. mod, class, method, func and attr). Default: False
show_symbol_type_toc: False
### Members
# A boolean, or an explicit list of inherited members to render. If true, select all inherited members, which can then be filtered with members. If false or empty list, do not select any inherited member. Default: False.
inherited_members: False
# A boolean, or an explicit list of members to render. If true, select all members without further filtering. If false or empty list, do not render members. If none, select all members and apply further filtering with filters and docstrings. Default: None.
members: null
# The members ordering to use. Options: alphabetical - order by the members names, source - order members as they appear in the source file. Default: "alphabetical".
members_order: "alphabetical"
# A list of filters applied to filter objects based on their name. A filter starting with ! will exclude matching objects instead of including them. The members option takes precedence over filters (filters will still be applied recursively to lower members in the hierarchy). Default: ["!^_[^_]"].
filters: ["!^_[^_]"]
# Group the object's children by categories: attributes, classes, functions, and modules. Default: True.
group_by_category: True
# When rendering a module, show its submodules recursively. Default: False.
show_submodules: False
# Whether to render summaries of modules, classes, functions (methods) and attributes.
summary: True
### Docstrings
# The docstring style to use: google, numpy, sphinx, or None. Default: "google".
docstring_style: "google"
# The options for the docstring parser. See parsers under griffe.docstrings.
# docstring_options:
# The style used to render docstring sections. Options: table, list, spacy. Default: "table".
docstring_section_style: "spacy"
# Whether to merge the __init__ method into the class' signature and docstring. Default: False.
merge_init_into_class: False
# Show the object heading even if it has no docstring or children with docstrings. Default: False.
show_if_no_docstring: False
# Whether to display the "Attributes" section in the object's docstring. Default: True.
show_docstring_attributes: True
# Whether to display the "Functions" or "Methods" sections in the object's docstring. Default: True.
show_docstring_functions: True
# Whether to display the "Classes" section in the object's docstring. Default: True.
show_docstring_classes: True
# Whether to display the "Modules" section in the object's docstring. Default: True.
show_docstring_modules: True
# Whether to display the textual block (including admonitions) in the object's docstring. Default: True.
show_docstring_description: True
# Whether to display the "Examples" section in the object's docstring. Default: True.
show_docstring_examples: True
# Whether to display the "Other Parameters" section in the object's docstring. Default: True.
show_docstring_other_parameters: True
# Whether to display the "Parameters" section in the object's docstring. Default: True.
show_docstring_parameters: True
# Whether to display the "Raises" section in the object's docstring. Default: True.
show_docstring_raises: True
# Whether to display the "Receives" section in the object's docstring. Default: True.
show_docstring_receives: True
# Whether to display the "Returns" section in the object's docstring. Default: True.
show_docstring_returns: True
# Whether to display the "Warns" section in the object's docstring. Default: True.
show_docstring_warns: True
# Whether to display the "Yields" section in the object's docstring. Default: True.
show_docstring_yields: True
### Signature/annotations
# The verbosity for annotations path: brief (recommended), or source (as written in the source). Default: "brief".
annotations_path: "full"
# Maximum line length when formatting code/signatures. Default: 60.
line_length: 88
# Show methods and functions signatures. Default: True.
show_signature: True
# Show the type annotations in methods and functions signatures. Default: False.
show_signature_annotations: True
# Whether to render cross-references for type annotations in signatures. Default: False.
signature_crossrefs: True
# Whether to put the whole signature in a code block below the heading. If Black is installed, the signature is also formatted using it. Default: False.
separate_signature: True
# Whether to unwrap Annotated types to show only the type without the annotations. Default: False.
unwrap_annotated: True