Skip to main content

Python Package GitHub branch checks state pre-commit.ci status codecov Code Style: Black Language grade: Python PyPI - Python Version PyPI

mkdocstrings-sourcelink

_

Automatic source link generation for mkdocstrings

Overview

mkdocstrings-sourcelink is a source link generator for mkdocstrings, which allows connecting the source code to a repository independent of the host (GitHub, GitLab, own Services).

The original idea of mkdocstrings-sourcelink was coming from keras-autodoc and used as inspiration. However, this implementation focuses on using straight mkdocstrings and not rephrase docstrings into the documentation. Furthermore, mkdocstrings-sourcelink also allows:

  1. Generating API list
  2. Using templates and examples
  3. Importing existing markdown files like README.md

Installation

pip install mkdocstrings-sourcelink

Usage

The usage requires just three steps:

  1. ❯ python generate_docs.py
  2. ❯ mkdocs.yml
  3. ❯ mkdocs deploy

Metadata

Release files for mkdocstrings-sourcelink 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mkdocstrings-sourcelink 0.3.2
File Size Uploaded Provenance Actions
mkdocstrings_sourcelink-0.3.2.tar.gz 15.7 kB Without provenance Details for mkdocstrings_sourcelink-0.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mkdocstrings-sourcelink 0.3.2
File Interpreter ABI Platform Actions
mkdocstrings_sourcelink-0.3.2-py3-none-any.whl Python 3 none any Details for mkdocstrings_sourcelink-0.3.2-py3-none-any.whl

Total release size: 29.4 kB

Security for mkdocstrings-sourcelink 0.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page