Skip to content

Commit fb767fb

Browse files
committed
Deployed 678ebd7 with MkDocs version: 1.2.3
1 parent 524491c commit fb767fb

4 files changed

Lines changed: 33 additions & 97 deletions

File tree

index.html

Lines changed: 12 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -397,19 +397,6 @@
397397
Features
398398
</a>
399399

400-
<nav class="md-nav" aria-label="Features">
401-
<ul class="md-nav__list">
402-
403-
<li class="md-nav__item">
404-
<a href="#python-handler" class="md-nav__link">
405-
Python handler
406-
</a>
407-
408-
</li>
409-
410-
</ul>
411-
</nav>
412-
413400
</li>
414401

415402
<li class="md-nav__item">
@@ -945,19 +932,6 @@
945932
Features
946933
</a>
947934

948-
<nav class="md-nav" aria-label="Features">
949-
<ul class="md-nav__list">
950-
951-
<li class="md-nav__item">
952-
<a href="#python-handler" class="md-nav__link">
953-
Python handler
954-
</a>
955-
956-
</li>
957-
958-
</ul>
959-
</nav>
960-
961935
</li>
962936

963937
<li class="md-nav__item">
@@ -1005,7 +979,8 @@ <h1 id="mkdocstrings">mkdocstrings<a class="headerlink" href="#mkdocstrings" tit
1005979
<a href="https://anaconda.org/conda-forge/mkdocstrings"><img alt="conda version" src="https://img.shields.io/conda/vn/conda-forge/mkdocstrings" /></a>
1006980
<a href="https://gitpod.io/#https://github.com/mkdocstrings/mkdocstrings"><img alt="gitpod" src="https://img.shields.io/badge/gitpod-workspace-blue.svg?style=flat" /></a>
1007981
<a href="https://gitter.im/mkdocstrings/community"><img alt="gitter" src="https://badges.gitter.im/join%20chat.svg" /></a></p>
1008-
<p>Automatic documentation from sources, for <a href="https://mkdocs.org/">MkDocs</a>.</p>
982+
<p>Automatic documentation from sources, for <a href="https://mkdocs.org/">MkDocs</a>.
983+
Come have a chat or ask questions on our <a href="https://gitter.im/mkdocstrings/community">Gitter channel</a>.</p>
1009984
<hr />
1010985
<p><strong><a href="#features">Features</a></strong> - <strong><a href="#python-handler">Python handler</a></strong> - <strong><a href="#requirements">Requirements</a></strong> - <strong><a href="#installation">Installation</a></strong> - <strong><a href="#quick-usage">Quick usage</a></strong></p>
1011986
<p><img alt="mkdocstrings_gif1" src="https://user-images.githubusercontent.com/3999221/77157604-fb807480-6aa1-11ea-99e0-d092371d4de0.gif" /></p>
@@ -1016,18 +991,18 @@ <h2 id="features">Features<a class="headerlink" href="#features" title="Permanen
1016991
just like <em>MkDocs</em>, <em>mkdocstrings</em> is written in Python but is language-agnostic.
1017992
It means you can use it with any programming language, as long as there is a
1018993
<a href="https://mkdocstrings.github.io/reference/handlers/base/"><strong>handler</strong></a> for it.
1019-
The <a href="https://mkdocstrings.github.io/handlers/python/">Python handler</a> is built-in.
1020-
<a href="https://mkdocstrings.github.io/handlers/overview/">Others</a> are external.
994+
We currently have <a href="https://mkdocstrings.github.io/handlers/overview/">handlers</a>
995+
for the <a href="https://mkdocstrings.github.io/crystal/">Crystal</a> and <a href="https://mkdocstrings.github.io/python/">Python</a> languages.
1021996
Maybe you'd like to add another one to the list? <img alt="😉" class="emojione" src="https://cdnjs.cloudflare.com/ajax/libs/emojione/2.2.7/assets/png/1f609.png" title=":wink:" /></p>
1022997
</li>
1023998
<li>
1024999
<p><a href="https://mkdocstrings.github.io/theming/"><strong>Multiple themes support:</strong></a>
10251000
each handler can offer multiple themes. Currently, we offer the
10261001
<img alt="⭐️" class="emojione" src="https://cdnjs.cloudflare.com/ajax/libs/emojione/2.2.7/assets/png/2b50.png" title=":star:" /> <a href="https://squidfunk.github.io/mkdocs-material/">Material theme</a> <img alt="⭐️" class="emojione" src="https://cdnjs.cloudflare.com/ajax/libs/emojione/2.2.7/assets/png/2b50.png" title=":star:" />
1027-
as well as basic support for the ReadTheDocs theme for the Python handler.</p>
1002+
as well as basic support for the ReadTheDocs and MkDocs themes for the Python handler.</p>
10281003
</li>
10291004
<li>
1030-
<p><a href="https://mkdocstrings.github.io/usage/#cross-references"><strong>Cross-links across pages:</strong></a>
1005+
<p><a href="https://mkdocstrings.github.io/usage/#cross-references"><strong>Cross-references across pages:</strong></a>
10311006
<em>mkdocstrings</em> makes it possible to reference headings in other Markdown files with the classic Markdown linking
10321007
syntax: <code>[identifier][]</code> or <code>[title][identifier]</code> -- and you don't need to remember which exact page this object was
10331008
on. This works for any heading that's produced by a <em>mkdocstrings</em> language handler, and you can opt to include
@@ -1036,6 +1011,12 @@ <h2 id="features">Features<a class="headerlink" href="#features" title="Permanen
10361011
<a href="https://mkdocstrings.github.io/usage/#cross-references-to-any-markdown-heading">opt in</a>.</p>
10371012
</li>
10381013
<li>
1014+
<p><a href="https://mkdocstrings.github.io/usage/#cross-references-to-other-projects-inventories"><strong>Cross-references across sites:</strong></a>
1015+
similarly to <a href="https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html">Sphinx's intersphinx extension</a>,
1016+
<em>mkdocstrings</em> can reference API items from other libraries, given they provide an inventory and you load
1017+
that inventory in your MkDocs configuration.</p>
1018+
</li>
1019+
<li>
10391020
<p><a href="https://mkdocstrings.github.io/usage/"><strong>Inline injection in Markdown:</strong></a>
10401021
instead of generating Markdown files, <em>mkdocstrings</em> allows you to inject
10411022
documentation anywhere in your Markdown contents. The syntax is simple: <code>::: identifier</code> followed by a 4-spaces
@@ -1057,51 +1038,6 @@ <h2 id="features">Features<a class="headerlink" href="#features" title="Permanen
10571038
you should be able to just drop the plugin in your configuration and enjoy your auto-generated docs.</p>
10581039
</li>
10591040
</ul>
1060-
<h3 id="python-handler">Python handler<a class="headerlink" href="#python-handler" title="Permanent link">¤</a></h3>
1061-
<p><img alt="mkdocstrings_gif2" src="https://user-images.githubusercontent.com/3999221/77157838-7184db80-6aa2-11ea-9f9a-fe77405202de.gif" /></p>
1062-
<ul>
1063-
<li>
1064-
<p><strong>Data collection from source code</strong>: collection of the object-tree and the docstrings is done by
1065-
<a href="https://github.com/pawamoy/pytkdocs"><code>pytkdocs</code></a>.</p>
1066-
</li>
1067-
<li>
1068-
<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 <a href="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
1102-
of the Python object.</p>
1103-
</li>
1104-
</ul>
11051041
<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">¤</a></h2>
11061042
<p>mkdocstrings requires Python 3.7 or above.</p>
11071043
<details>

search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

sitemap.xml

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,102 +2,102 @@
22
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
33
<url>
44
<loc>https://mkdocstrings.github.io/</loc>
5-
<lastmod>2022-02-06</lastmod>
5+
<lastmod>2022-02-07</lastmod>
66
<changefreq>daily</changefreq>
77
</url>
88
<url>
99
<loc>https://mkdocstrings.github.io/changelog/</loc>
10-
<lastmod>2022-02-06</lastmod>
10+
<lastmod>2022-02-07</lastmod>
1111
<changefreq>daily</changefreq>
1212
</url>
1313
<url>
1414
<loc>https://mkdocstrings.github.io/code_of_conduct/</loc>
15-
<lastmod>2022-02-06</lastmod>
15+
<lastmod>2022-02-07</lastmod>
1616
<changefreq>daily</changefreq>
1717
</url>
1818
<url>
1919
<loc>https://mkdocstrings.github.io/contributing/</loc>
20-
<lastmod>2022-02-06</lastmod>
20+
<lastmod>2022-02-07</lastmod>
2121
<changefreq>daily</changefreq>
2222
</url>
2323
<url>
2424
<loc>https://mkdocstrings.github.io/credits/</loc>
25-
<lastmod>2022-02-06</lastmod>
25+
<lastmod>2022-02-07</lastmod>
2626
<changefreq>daily</changefreq>
2727
</url>
2828
<url>
2929
<loc>https://mkdocstrings.github.io/license/</loc>
30-
<lastmod>2022-02-06</lastmod>
30+
<lastmod>2022-02-07</lastmod>
3131
<changefreq>daily</changefreq>
3232
</url>
3333
<url>
3434
<loc>https://mkdocstrings.github.io/theming/</loc>
35-
<lastmod>2022-02-06</lastmod>
35+
<lastmod>2022-02-07</lastmod>
3636
<changefreq>daily</changefreq>
3737
</url>
3838
<url>
3939
<loc>https://mkdocstrings.github.io/troubleshooting/</loc>
40-
<lastmod>2022-02-06</lastmod>
40+
<lastmod>2022-02-07</lastmod>
4141
<changefreq>daily</changefreq>
4242
</url>
4343
<url>
4444
<loc>https://mkdocstrings.github.io/usage/</loc>
45-
<lastmod>2022-02-06</lastmod>
45+
<lastmod>2022-02-07</lastmod>
4646
<changefreq>daily</changefreq>
4747
</url>
4848
<url>
4949
<loc>https://mkdocstrings.github.io/handlers/overview/</loc>
50-
<lastmod>2022-02-06</lastmod>
50+
<lastmod>2022-02-07</lastmod>
5151
<changefreq>daily</changefreq>
5252
</url>
5353
<url>
5454
<loc>None</loc>
55-
<lastmod>2022-02-06</lastmod>
55+
<lastmod>2022-02-07</lastmod>
5656
<changefreq>daily</changefreq>
5757
</url>
5858
<url>
5959
<loc>https://mkdocstrings.github.io/reference/extension/</loc>
60-
<lastmod>2022-02-06</lastmod>
60+
<lastmod>2022-02-07</lastmod>
6161
<changefreq>daily</changefreq>
6262
</url>
6363
<url>
6464
<loc>https://mkdocstrings.github.io/reference/inventory/</loc>
65-
<lastmod>2022-02-06</lastmod>
65+
<lastmod>2022-02-07</lastmod>
6666
<changefreq>daily</changefreq>
6767
</url>
6868
<url>
6969
<loc>https://mkdocstrings.github.io/reference/loggers/</loc>
70-
<lastmod>2022-02-06</lastmod>
70+
<lastmod>2022-02-07</lastmod>
7171
<changefreq>daily</changefreq>
7272
</url>
7373
<url>
7474
<loc>https://mkdocstrings.github.io/reference/plugin/</loc>
75-
<lastmod>2022-02-06</lastmod>
75+
<lastmod>2022-02-07</lastmod>
7676
<changefreq>daily</changefreq>
7777
</url>
7878
<url>
7979
<loc>https://mkdocstrings.github.io/reference/autorefs/plugin/</loc>
80-
<lastmod>2022-02-06</lastmod>
80+
<lastmod>2022-02-07</lastmod>
8181
<changefreq>daily</changefreq>
8282
</url>
8383
<url>
8484
<loc>https://mkdocstrings.github.io/reference/autorefs/references/</loc>
85-
<lastmod>2022-02-06</lastmod>
85+
<lastmod>2022-02-07</lastmod>
8686
<changefreq>daily</changefreq>
8787
</url>
8888
<url>
8989
<loc>https://mkdocstrings.github.io/reference/handlers/base/</loc>
90-
<lastmod>2022-02-06</lastmod>
90+
<lastmod>2022-02-07</lastmod>
9191
<changefreq>daily</changefreq>
9292
</url>
9393
<url>
9494
<loc>https://mkdocstrings.github.io/reference/handlers/rendering/</loc>
95-
<lastmod>2022-02-06</lastmod>
95+
<lastmod>2022-02-07</lastmod>
9696
<changefreq>daily</changefreq>
9797
</url>
9898
<url>
9999
<loc>https://mkdocstrings.github.io/coverage/</loc>
100-
<lastmod>2022-02-06</lastmod>
100+
<lastmod>2022-02-07</lastmod>
101101
<changefreq>daily</changefreq>
102102
</url>
103103
</urlset>

sitemap.xml.gz

0 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)