Skip to content

Commit a6083be

Browse files
committed
Deployed fc15a45 with MkDocs version: 1.1.2
1 parent 9166e39 commit a6083be

20 files changed

Lines changed: 414 additions & 118 deletions

File tree

changelog/index.html

Lines changed: 106 additions & 43 deletions
Large diffs are not rendered by default.

contributing/index.html

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -622,35 +622,32 @@ <h2 id="environment-setup">Environment setup<a class="headerlink" href="#environ
622622
<div class="highlight"><pre><span></span><code><span class="nb">cd</span> pytkdocs
623623
make setup
624624
</code></pre></div>
625-
626625
<div class="admonition note">
627626
<p class="admonition-title">Note</p>
628627
<p>If it fails for some reason,
629-
you'll need to install these tools manually:
630-
<a href="https://github.com/python-poetry/poetry">Poetry</a> and
631-
<a href="https://github.com/pyinvoke/invoke">Invoke</a>.</p>
632-
<p>You can install them with:</p>
628+
you'll need to install
629+
<a href="https://github.com/python-poetry/poetry">Poetry</a>
630+
manually.</p>
631+
<p>You can install it with:</p>
633632
<div class="highlight"><pre><span></span><code>python3 -m pip install --user pipx
634633
pipx install poetry
635-
pipx install invoke
636634
</code></pre></div>
637-
638635
<p>Now you can try running <code>make setup</code> again,
639636
or simply <code>poetry install</code>.</p>
640637
</div>
641638
<p>You now have the dependencies installed.</p>
642639
<p>You can run the application with <code>poetry run pytkdocs [ARGS...]</code>.</p>
643640
<p>Run <code>make help</code> to see all the available actions!</p>
644641
<h2 id="tasks">Tasks<a class="headerlink" href="#tasks" title="Permanent link">¤</a></h2>
645-
<p>This project uses <a href="https://github.com/pyinvoke/invoke">Invoke</a> to run tasks.
646-
A Makefile is also provided. The Makefile will try to run the task
642+
<p>This project uses <a href="https://github.com/pawamoy/duty">Duty</a> to run tasks.
643+
A Makefile is also provided. The Makefile will try to run certain tasks
647644
on multiple Python versions. If for some reason you don't want to run the task
648645
on multiple Python versions, you can do one of the following:</p>
649646
<ol>
650647
<li><code>export PYTHON_VERSIONS=</code>: this will run the task
651648
with only the current Python version</li>
652-
<li>run the task directly with <code>poetry run invoke TASK</code>,
653-
or <code>invoke TASK</code> if the environment was already activated
649+
<li>run the task directly with <code>poetry run duty TASK</code>,
650+
or <code>duty TASK</code> if the environment was already activated
654651
through <code>poetry shell</code></li>
655652
</ol>
656653
<p>The Makefile detects if the Poetry environment is activated,
@@ -685,7 +682,6 @@ <h2 id="commit-message-convention">Commit message convention<a class="headerlink
685682

686683
[Body]
687684
</code></pre></div>
688-
689685
<p>Scope and body are optional. Type can be:</p>
690686
<ul>
691687
<li><code>build</code>: About packaging, building wheels, etc.</li>
@@ -706,22 +702,18 @@ <h2 id="commit-message-convention">Commit message convention<a class="headerlink
706702
References: #10, #11.
707703
Fixes #15.
708704
</code></pre></div>
709-
710705
<h2 id="pull-requests-guidelines">Pull requests guidelines<a class="headerlink" href="#pull-requests-guidelines" title="Permanent link">¤</a></h2>
711706
<p>Link to any related issue in the Pull Request message.</p>
712707
<p>During review, we recommend using fixups:</p>
713708
<div class="highlight"><pre><span></span><code><span class="c1"># SHA is the SHA of the commit you want to fix</span>
714709
git commit --fixup<span class="o">=</span>SHA
715710
</code></pre></div>
716-
717711
<p>Once all the changes are approved, you can squash your commits:</p>
718712
<div class="highlight"><pre><span></span><code>git rebase -i --autosquash master
719713
</code></pre></div>
720-
721714
<p>And force-push:</p>
722715
<div class="highlight"><pre><span></span><code>git push -f
723716
</code></pre></div>
724-
725717
<p>If this seems all too complicated, you can push or force-push each new commit,
726718
and we will squash them ourselves if needed, before merging.</p>
727719

credits/index.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -583,8 +583,8 @@ <h1 id="credits">Credits<a class="headerlink" href="#credits" title="Permanent l
583583
<h3 id="direct-dependencies">Direct dependencies<a class="headerlink" href="#direct-dependencies" title="Permanent link">¤</a></h3>
584584
<p><a href="https://github.com/myint/autoflake"><code>autoflake</code></a> |
585585
<a href="https://github.com/psf/black"><code>black</code></a> |
586-
<a href="https://github.com/nedbat/coveragepy"><code>coverage</code></a> |
587-
<a href="https://github.com/pawamoy/failprint"><code>failprint</code></a> |
586+
<a href="https://github.com/ericvsmith/dataclasses"><code>dataclasses</code></a> |
587+
<a href="https://github.com/pawamoy/duty"><code>duty</code></a> |
588588
<a href="https://github.com/peterjc/flake8-black"><code>flake8-black</code></a> |
589589
<a href="https://github.com/gforcada/flake8-builtins"><code>flake8-builtins</code></a> |
590590
<a href="https://pypi.org/project/flake8-pytest-style"><code>flake8-pytest-style</code></a> |
@@ -593,10 +593,10 @@ <h3 id="direct-dependencies">Direct dependencies<a class="headerlink" href="#dir
593593
<a href="None"><code>flakehell</code></a> |
594594
<a href="https://github.com/pawamoy/git-changelog"><code>git-changelog</code></a> |
595595
<a href="https://github.com/encode/httpx"><code>httpx</code></a> |
596-
<a href="http://docs.pyinvoke.org"><code>invoke</code></a> |
597596
<a href="https://ipython.org"><code>ipython</code></a> |
598597
<a href="https://github.com/timothycrosley/isort"><code>isort</code></a> |
599598
<a href="https://github.com/mattrobenolt/jinja2-cli"><code>jinja2-cli</code></a> |
599+
<a href="https://github.com/cmacmackin/markdown-include/"><code>markdown-include</code></a> |
600600
<a href="https://github.com/marshmallow-code/marshmallow"><code>marshmallow</code></a> |
601601
<a href="https://www.mkdocs.org"><code>mkdocs</code></a> |
602602
<a href="https://squidfunk.github.io/mkdocs-material/"><code>mkdocs-material</code></a> |
@@ -609,8 +609,8 @@ <h3 id="direct-dependencies">Direct dependencies<a class="headerlink" href="#dir
609609
<a href="http://pivotfinland.com/pytest-sugar/"><code>pytest-sugar</code></a> |
610610
<a href="https://github.com/pytest-dev/pytest-xdist"><code>pytest-xdist</code></a> |
611611
<a href="https://github.com/uiri/toml"><code>toml</code></a> |
612-
<a href="https://wemake-python-stylegui.de"><code>wemake-python-styleguide</code></a> |
613-
<a href="https://github.com/GrahamDumpleton/wrapt"><code>wrapt</code></a></p>
612+
<a href="https://github.com/python/typing/blob/master/typing_extensions/README.rst"><code>typing-extensions</code></a> |
613+
<a href="https://wemake-python-stylegui.de"><code>wemake-python-styleguide</code></a></p>
614614
<h3 id="indirect-dependencies">Indirect dependencies<a class="headerlink" href="#indirect-dependencies" title="Permanent link">¤</a></h3>
615615
<p><a href="https://github.com/gvalkov/python-ansimarkup"><code>ansimarkup</code></a> |
616616
<a href="https://github.com/pytest-dev/apipkg"><code>apipkg</code></a> |
@@ -628,13 +628,14 @@ <h3 id="indirect-dependencies">Indirect dependencies<a class="headerlink" href="
628628
<a href="https://palletsprojects.com/p/click/"><code>click</code></a> |
629629
<a href="https://github.com/tartley/colorama"><code>colorama</code></a> |
630630
<a href="http://github.com/MagicStack/contextvars"><code>contextvars</code></a> |
631+
<a href="https://github.com/nedbat/coveragepy"><code>coverage</code></a> |
631632
<a href="None"><code>darglint</code></a> |
632-
<a href="https://github.com/ericvsmith/dataclasses"><code>dataclasses</code></a> |
633633
<a href="https://github.com/micheles/decorator"><code>decorator</code></a> |
634634
<a href="http://docutils.sourceforge.net/"><code>docutils</code></a> |
635635
<a href="https://github.com/takluyver/entrypoints"><code>entrypoints</code></a> |
636636
<a href="https://github.com/myint/eradicate"><code>eradicate</code></a> |
637637
<a href="https://execnet.readthedocs.io/en/latest/"><code>execnet</code></a> |
638+
<a href="https://github.com/pawamoy/failprint"><code>failprint</code></a> |
638639
<a href="https://gitlab.com/pycqa/flake8"><code>flake8</code></a> |
639640
<a href="https://github.com/tylerwince/flake8-bandit"><code>flake8-bandit</code></a> |
640641
<a href="https://github.com/sobolevn/flake8-broken-line"><code>flake8-broken-line</code></a> |
@@ -657,7 +658,7 @@ <h3 id="indirect-dependencies">Indirect dependencies<a class="headerlink" href="
657658
<a href="https://github.com/encode/httpcore"><code>httpcore</code></a> |
658659
<a href="https://github.com/kjd/idna"><code>idna</code></a> |
659660
<a href="https://github.com/MagicStack/immutables"><code>immutables</code></a> |
660-
<a href="http://importlib-metadata.readthedocs.io/"><code>importlib-metadata</code></a> |
661+
<a href="https://github.com/python/importlib_metadata"><code>importlib-metadata</code></a> |
661662
<a href="http://github.com/RonnyPfannschmidt/iniconfig"><code>iniconfig</code></a> |
662663
<a href="http://ipython.org"><code>ipython-genutils</code></a> |
663664
<a href="https://github.com/davidhalter/jedi"><code>jedi</code></a> |
@@ -670,7 +671,6 @@ <h3 id="indirect-dependencies">Indirect dependencies<a class="headerlink" href="
670671
<a href="https://palletsprojects.com/p/markupsafe/"><code>MarkupSafe</code></a> |
671672
<a href="https://github.com/pycqa/mccabe"><code>mccabe</code></a> |
672673
<a href="https://github.com/facelessuser/mkdocs-material-extensions"><code>mkdocs-material-extensions</code></a> |
673-
<a href="https://github.com/more-itertools/more-itertools"><code>more-itertools</code></a> |
674674
<a href="https://github.com/python/mypy_extensions"><code>mypy-extensions</code></a> |
675675
<a href="http://nltk.org/"><code>nltk</code></a> |
676676
<a href="https://github.com/pypa/packaging"><code>packaging</code></a> |
@@ -708,9 +708,9 @@ <h3 id="indirect-dependencies">Indirect dependencies<a class="headerlink" href="
708708
<a href="https://github.com/tqdm/tqdm"><code>tqdm</code></a> |
709709
<a href="http://ipython.org"><code>traitlets</code></a> |
710710
<a href="https://github.com/python/typed_ast"><code>typed-ast</code></a> |
711-
<a href="https://github.com/python/typing/blob/master/typing_extensions/README.rst"><code>typing-extensions</code></a> |
712711
<a href="https://urllib3.readthedocs.io/"><code>urllib3</code></a> |
713712
<a href="https://github.com/jquast/wcwidth"><code>wcwidth</code></a> |
713+
<a href="https://github.com/GrahamDumpleton/wrapt"><code>wrapt</code></a> |
714714
<a href="https://github.com/jaraco/zipp"><code>zipp</code></a></p>
715715
<p><strong><a href="http://pawamoy.github.io/credits/">More credits from the author</a></strong></p>
716716

css/mkdocstrings.css

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
1+
/* Indentation. */
12
div.doc-contents:not(.first) {
23
padding-left: 25px;
34
border-left: 4px solid rgba(230, 230, 230);
45
margin-bottom: 80px;
56
}
67

8+
/* Don't capitalize names. */
79
h5.doc-heading {
810
text-transform: none !important;
911
}
1012

11-
h6.hidden-toc {
12-
margin: 0 !important;
13-
position: relative;
14-
top: -70px;
15-
}
16-
17-
h6.hidden-toc::before {
13+
/* Don't use vertical space on hidden ToC entries. */
14+
.hidden-toc::before {
1815
margin-top: 0 !important;
1916
padding-top: 0 !important;
2017
}
2118

22-
h6.hidden-toc a.headerlink {
19+
/* Don't show permalink of hidden ToC entries. */
20+
.hidden-toc a.headerlink {
2321
display: none;
2422
}
2523

24+
/* Avoid breaking parameters name, etc. in table cells. */
2625
td code {
2726
word-break: normal !important;
2827
}
2928

29+
/* For pieces of Markdown rendered in table cells. */
3030
td p {
3131
margin-top: 0 !important;
3232
margin-bottom: 0 !important;
33-
}
33+
}

index.html

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -642,7 +642,9 @@
642642
<h1 id="pytkdocs">pytkdocs<a class="headerlink" href="#pytkdocs" title="Permanent link">¤</a></h1>
643643
<p><a href="https://github.com/pawamoy/pytkdocs/actions?query=workflow%3Aci"><img alt="ci" src="https://github.com/pawamoy/pytkdocs/workflows/ci/badge.svg" /></a>
644644
<a href="https://pawamoy.github.io/pytkdocs/"><img alt="documentation" src="https://img.shields.io/badge/docs-mkdocs%20material-blue.svg?style=flat" /></a>
645-
<a href="https://pypi.org/project/pytkdocs/"><img alt="pypi version" src="https://img.shields.io/pypi/v/pytkdocs.svg" /></a></p>
645+
<a href="https://pypi.org/project/pytkdocs/"><img alt="pypi version" src="https://img.shields.io/pypi/v/pytkdocs.svg" /></a>
646+
<a href="https://anaconda.org/conda-forge/pytkdocs"><img alt="conda version" src="https://img.shields.io/conda/vn/conda-forge/pytkdocs" /></a>
647+
<a href="https://gitter.im/pytkdocs/community"><img alt="gitter" src="https://badges.gitter.im/join%20chat.svg" /></a></p>
646648
<p>Load Python objects documentation.</p>
647649
<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">¤</a></h2>
648650
<p><code>pytkdocs</code> requires Python 3.6 or above.</p>
@@ -674,6 +676,9 @@ <h2 id="installation">Installation<a class="headerlink" href="#installation" tit
674676

675677
pipx install --python python3.6 pytkdocs
676678
</code></pre></div></p>
679+
<p>With <code>conda</code>:
680+
<div class="highlight"><pre><span></span><code><span class="n">conda</span> <span class="n">install</span> <span class="o">-</span><span class="n">c</span> <span class="n">conda</span><span class="o">-</span><span class="n">forge</span> <span class="n">pytkdocs</span>
681+
</code></pre></div></p>
677682
<h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">¤</a></h2>
678683
<p><code>pytkdocs</code> accepts JSON on standard input and writes JSON on standard output.</p>
679684
<p>Input format:</p>
@@ -695,7 +700,6 @@ <h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">
695700
<span class="p">]</span>
696701
<span class="p">}</span>
697702
</code></pre></div>
698-
699703
<p>Output format:</p>
700704
<div class="highlight"><pre><span></span><code><span class="p">{</span>
701705
<span class="nt">&quot;loading_errors&quot;</span><span class="p">:</span> <span class="p">[</span>
@@ -771,7 +775,6 @@ <h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">
771775
<span class="p">]</span>
772776
<span class="p">}</span>
773777
</code></pre></div>
774-
775778
<h2 id="command-line">Command-line<a class="headerlink" href="#command-line" title="Permanent link">¤</a></h2>
776779
<p>Running <code>pytkdocs</code> without argument will read the whole standard input,
777780
and output the result once.</p>
@@ -812,17 +815,19 @@ <h2 id="configuration">Configuration<a class="headerlink" href="#configuration"
812815
<p><code>inherited_members</code>: true or false (default). When enabled, inherited members will be selected as well.</p>
813816
</li>
814817
<li>
815-
<p><code>docstring_style</code>: the docstring style to use when parsing the docstring. Only one parser available: <code>google</code>.</p>
818+
<p><code>docstring_style</code>: the docstring style to use when parsing the docstring. <code>google</code> and <code>restructured-text</code><sup>1</sup>.</p>
816819
</li>
817820
<li>
818821
<p><code>docstring_options</code>: options to pass to the docstring parser.</p>
819822
<ul>
820823
<li><code>google</code> accepts a <code>replace_admonitions</code> boolean option (default: true). When enabled, this option will
821824
replace titles of an indented block by their Markdown admonition equivalent:
822825
<code>AdmonitionType: Title</code> will become <code>!!! admonitiontype "Title"</code>.</li>
826+
<li><code>restructured-text</code> does not accept any options.</li>
823827
</ul>
824828
</li>
825829
</ul>
830+
<p><sup>1</sup>: reStructured Text parsing is in active development and is not feature complete yet.</p>
826831
<h3 id="details-on-new_path_syntax">Details on <code>new_path_syntax</code><a class="headerlink" href="#details-on-new_path_syntax" title="Permanent link">¤</a></h3>
827832
<p>Example:</p>
828833
<table>

reference/__init__/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -556,7 +556,7 @@
556556
<h1>__init__.py</h1>
557557

558558
<div class="doc doc-object doc-module">
559-
<h2 class="hidden-toc" href="#pytkdocs.__init__" id="pytkdocs.__init__" style="visibility: hidden; width: 0; height: 0;">
559+
<h2 class="hidden-toc" href="#pytkdocs.__init__" id="pytkdocs.__init__" style="visibility: hidden; position: absolute;">
560560
<a class="headerlink" href="#pytkdocs.__init__" title="Permanent link">¤</a></h2>
561561
<div class="doc doc-contents first">
562562
<p>pytkdocs package.</p>

reference/__main__/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -556,7 +556,7 @@
556556
<h1>__main__.py</h1>
557557

558558
<div class="doc doc-object doc-module">
559-
<h2 class="hidden-toc" href="#pytkdocs.__main__" id="pytkdocs.__main__" style="visibility: hidden; width: 0; height: 0;">
559+
<h2 class="hidden-toc" href="#pytkdocs.__main__" id="pytkdocs.__main__" style="visibility: hidden; position: absolute;">
560560
<a class="headerlink" href="#pytkdocs.__main__" title="Permanent link">¤</a></h2>
561561
<div class="doc doc-contents first">
562562
<p>Entry-point module, in case you use <code>python -m pytkdocs</code>.</p>

reference/cli/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -362,7 +362,7 @@
362362
</a>
363363
<h1>cli.py</h1>
364364
<div class="doc doc-object doc-module">
365-
<h2 class="hidden-toc" href="#pytkdocs.cli" id="pytkdocs.cli" style="visibility: hidden; width: 0; height: 0;">
365+
<h2 class="hidden-toc" href="#pytkdocs.cli" id="pytkdocs.cli" style="visibility: hidden; position: absolute;">
366366
<a class="headerlink" href="#pytkdocs.cli" title="Permanent link">¤</a></h2>
367367
<div class="doc doc-contents first">
368368
<p>Module that contains the command line application.</p>

0 commit comments

Comments
 (0)