Bump mkdocstrings from 0.13.6 to 0.15.2

[dependabot]

Bumps mkdocstrings from 0.13.6 to 0.15.2.

Changelog

Sourced from mkdocstrings's changelog.

0.15.2 - 2021-06-09

Compare with 0.15.1

Packaging

• MkDocs default schema needs to be obtained differently now (b3e122b by Oleh Prypin). [PR #273](mkdocstrings/mkdocstrings#273)
• Compatibility with MkDocs 1.2: livereload isn't guaranteed now (36e8024 by Oleh Prypin). [PR #294](mkdocstrings/mkdocstrings#294)

0.15.1 - 2021-05-16

Compare with 0.15.0

Bug Fixes

• Prevent error during parallel installations (fac2c71 by Timothée Mazzucotelli).

Packaging

• Support the upcoming major Jinja and MarkupSafe releases (bb4f9de by Oleh Prypin). [PR #283](mkdocstrings/mkdocstrings#283)
• Accept a higher version of mkdocs-autorefs (c8de08e by Oleh Prypin). [PR #282](mkdocstrings/mkdocstrings#282)

0.15.0 - 2021-02-28

Compare with 0.14.0

Breaking Changes

The following items are possible breaking changes:

• Cross-linking to arbitrary headings now requires to opt-in to the autorefs plugin, which is installed as a dependency of mkdocstrings. See Cross-references to any Markdown heading.
• mkdocstrings now respects your configured code highlighting method, so if you are using the CodeHilite extension, the .highlight CSS class in the rendered HTML will become .codehilite. So make sure to adapt your extra CSS accordingly. Or just switch to using pymdownx.highlight, it's better supported by mkdocstrings anyway. See Syntax highlighting.
• Most of the CSS rules that mkdocstrings used to recommend for manual addition, now become mandatory (auto-injected into the site). This shouldn't break any of your styles, but you are welcome to remove the now-redundant lines that you had copied into extra_css, similarly to this diff.

Features

• Nicer-looking error outputs - no tracebacks from mkdocstrings (6baf720 by Oleh Prypin). [PR #230](mkdocstrings/mkdocstrings#230)
• Let handlers add CSS to the pages, do so for Python handler (05c7a3f by Oleh Prypin). [Issue #189](mkdocstrings/mkdocstrings#189), [PR #218](mkdocstrings/mkdocstrings#218)
• Allow linking to an object heading not only by its canonical identifier, but also by its possible aliases (4789950 by Oleh Prypin). [PR #217](mkdocstrings/mkdocstrings#217)

Bug Fixes

• Propagate the CSS class to inline highlighting as well (c7d80e6 by Oleh Prypin). [PR #245](mkdocstrings/mkdocstrings#245)
• Don't double-escape characters in highlighted headings (6357144 by Oleh Prypin). [Issue #228](mkdocstrings/mkdocstrings#228), [PR #241](mkdocstrings/mkdocstrings#241)

Code Refactoring

• Use the autorefs plugin from its new external location (e2d74ef by Oleh Prypin). [PR #235](mkdocstrings/mkdocstrings#235)
• Split out Markdown extensions from handlers to handlers.rendering (7533852 by Oleh Prypin). [PR #233](mkdocstrings/mkdocstrings#233)

... (truncated)

Commits

• 2b0f809 chore: Prepare release 0.15.2
• 36e8024 refactor: Compatibility with MkDocs 1.2: livereload isn't guaranteed now
• b3e122b chore: MkDocs default schema needs to be obtained differently now
• 07fb484 chore: Prepare release 0.15.1
• fac2c71 fix: Prevent error during parallel installations
• bb4f9de build: Support the upcoming major Jinja and MarkupSafe releases
• c8de08e chore: Also accept a higher version of mkdocs-autorefs
• 65732a2 chore: Prepare release 0.15.0
• fc9fe34 pkg: Accept pytkdocs v0.11
• d5a1e39 ci: Don't fail when checking docs on Python 3.6
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[cloudflare-pages]

Deploying with    Cloudflare Pages

Latest commit:	76d7eca
Status:	✅  Deploy successful!
Preview URL:	https://235b3ae0.opensafely-docs.pages.dev

View logs

[madwort]

seems that a template file in mkdocstring may need to be updated, will file a ticket there

[StevenMaude]

As mentioned in the related mkdocs upgrade PR, this fails due to:

  File "templates/python/material/parameters.html", line 14, in top-level template code
    <td>{{ parameter.description|convert_markdown }}</td>
TypeError: do_convert_markdown() missing 1 required positional argument: 'heading_level'

This really confused me because there's no such line in mkdocstrings source that I could find.

From looking in mkdocs.yml at the mkdocstrings configuration, I noticed that templates/python/material/parameters.html is actually a file we're including as an override. (The not-so-subtle clue is in the directory name: overrides). So the fix is to update that template file to pass heading_level in the do_convert_markdown() call.