# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-mkdocstrings
VERSION=		0.25.0
KEYWORDS=		python
VARIANTS=		v11 v12
SDESC[v11]=		Documentation from sources for MkDocs (3.11)
SDESC[v12]=		Documentation from sources for MkDocs (3.12)
HOMEPAGE=		https://mkdocstrings.github.io
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/bd/9c/c472b54763cf4e6ec4d1a1a3777af0e2e8c2d3be2fbdb70d0dd1daec27ba
DISTFILE[1]=		mkdocstrings-0.25.0-py3-none-any.whl:main
DF_INDEX=		1
SPKGS[v11]=		single
SPKGS[v12]=		single

OPTIONS_AVAILABLE=	PY311 PY312
OPTIONS_STANDARD=	none
VOPTS[v11]=		PY311=ON PY312=OFF
VOPTS[v12]=		PY311=OFF PY312=ON

DISTNAME=		mkdocstrings-0.25.0.dist-info

GENERATED=		yes

[PY311].RUN_DEPENDS_ON=			python-click:single:v11
					python-Jinja2:single:v11
					python-Markdown:single:v11
					python-MarkupSafe:single:v11
					python-mkdocs:single:v11
					python-mkdocs-autorefs:single:v11
					python-platformdirs:single:v11
					python-pymdown-extensions:single:v11
[PY311].USES_ON=			python:v11,wheel

[PY312].RUN_DEPENDS_ON=			python-click:single:v12
					python-Jinja2:single:v12
					python-Markdown:single:v12
					python-MarkupSafe:single:v12
					python-mkdocs:single:v12
					python-mkdocs-autorefs:single:v12
					python-platformdirs:single:v12
					python-pymdown-extensions:single:v12
[PY312].USES_ON=			python:v12,wheel

[FILE:2767:descriptions/desc.single]
# mkdocstrings

[ci]
[documentation]
[pypi version]
[conda version]
[gitpod]
[gitter]

Automatic documentation from sources, for [MkDocs].
Come have a chat or ask questions on our [Gitter channel].

---

**[Features]** - **[Requirements]** - **[Installation]** - **[Quick
usage]**

![mkdocstrings_gif1]

## Features

- [**Language-agnostic:**]
  just like *MkDocs*, *mkdocstrings* is written in Python but is
language-agnostic.
  It means you can use it with any programming language, as long as there
is a
  [**handler**] for it.
  We currently have [handlers]
  for the [Crystal], [Python],
  and [VBA] languages,
  as well as for [shell scripts/libraries].
  Maybe you'd like to add another one to the list? :wink:

- [**Multiple themes support:**]
  each handler can offer multiple themes. Currently, we offer the
  :star: [Material theme] :star:
  as well as basic support for the ReadTheDocs and MkDocs themes for the
Python handler.

- [**Cross-references across pages:**]
  *mkdocstrings* makes it possible to reference headings in other Markdown
files with the classic Markdown linking
  syntax: `[identifier][]` or `[title][identifier]` -- and you don't need
to remember which exact page this object was
  on. This works for any heading that's produced by a *mkdocstrings*
language handler, and you can opt to include
  *any* Markdown heading into the global referencing scheme.

    **Note**: in versions prior to 0.15 *all* Markdown headers were
included, but now you need to
    [opt in].

- [**Cross-references across sites:**]
  similarly to [Sphinx's intersphinx extension],
  *mkdocstrings* can reference API items from other libraries, given they
provide an inventory and you load
  that inventory in your MkDocs configuration.

- [**Inline injection in Markdown:**]
  instead of generating Markdown files, *mkdocstrings* allows you to inject
  documentation anywhere in your Markdown contents. The syntax is simple:
`::: identifier` followed by a 4-spaces
  indented YAML block. The identifier and YAML configuration will be passed
to the appropriate handler
  to collect and render documentation.

- [**Global and local configuration:**]
  each handler can be configured globally in `mkdocs.yml`, and locally for
each
  "autodoc" instruction.

- **Reasonable defaults:**
  you should be able to just drop the plugin in your configuration and
enjoy your auto-generated docs.

## Used by

*mkdocstrings* is used by well-known companies, projects and scientific
teams:
[Ansible],
[Apache],
[Google],
[Jitsi],
[Microsoft],
[Prefect],
[Pydantic],
[and more...]

## Installation

With `pip`:

`bash
pip install mkdocstrings
`

You can install support for specific languages using extras, for example:

```bash
pip install 'mkdocstrings[crystal,python]'


[FILE:115:distinfo]
df1b63f26675fcde8c1b77e7ea996cd2f93220b148e06455428f676f5dc838f1        29054 mkdocstrings-0.25.0-py3-none-any.whl