You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
We currently have <ahref="https://mkdocstrings.github.io/handlers/overview/">handlers</a>
995
+
for the <ahref="https://mkdocstrings.github.io/crystal/">Crystal</a>and <ahref="https://mkdocstrings.github.io/python/">Python</a> languages.
1021
996
Maybe you'd like to add another one to the list? <imgalt="😉" class="emojione" src="https://cdnjs.cloudflare.com/ajax/libs/emojione/2.2.7/assets/png/1f609.png" title=":wink:" /></p>
<p><strong>Support for type annotations:</strong><code>pytkdocs</code> collects your type annotations and <em>mkdocstrings</em> uses them
1069
-
to display parameters types or return types.</p>
1070
-
</li>
1071
-
<li>
1072
-
<p><strong>Recursive documentation of Python objects:</strong> just use the module dotted-path as identifier, and you get the full
1073
-
module docs. You don't need to inject documentation for each class, function, etc.</p>
1074
-
</li>
1075
-
<li>
1076
-
<p><strong>Support for documented attributes:</strong> attributes (variables) followed by a docstring (triple-quoted string) will
1077
-
be recognized by <code>pytkdocs</code> in modules, classes and even in <code>__init__</code> methods.</p>
1078
-
</li>
1079
-
<li>
1080
-
<p><strong>Support for objects properties:</strong><code>pytkdocs</code> detects if a method is a <code>staticmethod</code>, a <code>classmethod</code>, etc.,
1081
-
it also detects if a property is read-only or writable, and more! These properties will be displayed
1082
-
next to the object signature by <em>mkdocstrings</em>.</p>
1083
-
</li>
1084
-
<li>
1085
-
<p><strong>Multiple docstring-styles support:</strong> almost complete support for Google-style, Numpy-style,
1086
-
and reStructuredText-style docstrings. <em>Notes: only RST </em><em>style</em><em> is supported, not the whole markup.
1087
-
Numpy-style requires an extra dependency from <code>pytkdocs</code>: <code>pytkdocs[numpy-style]</code>.</em></p>
1088
-
</li>
1089
-
<li>
1090
-
<p><strong>Admonition support in docstrings:</strong> blocks like <code>Note:</code> or <code>Warning:</code> will be transformed
1091
-
to their <ahref="https://squidfunk.github.io/mkdocs-material/reference/admonitions/">admonition</a> equivalent.
1092
-
<em>We do not support nested admonitions in docstrings!</em></p>
1093
-
</li>
1094
-
<li>
1095
-
<p><strong>Every object has a TOC entry:</strong> we render a heading for each object, meaning <em>MkDocs</em> picks them into the Table
1096
-
of Contents, which is nicely display by the Material theme. Thanks to <em>mkdocstrings</em> cross-reference ability,
1097
-
you can reference other objects within your docstrings, with the classic Markdown syntax:
1098
-
<code>[this object][package.module.object]</code> or directly with <code>[package.module.object][]</code></p>
1099
-
</li>
1100
-
<li>
1101
-
<p><strong>Source code display:</strong><em>mkdocstrings</em> can add a collapsible div containing the highlighted source code
0 commit comments