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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocstrings_sourcelink-0.3.2.tar.gz (15.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mkdocstrings_sourcelink-0.3.2-py3-none-any.whl (13.8 kB view details)

Uploaded Python 3

Release history Release notifications | RSS feed

This release

0.3.2 This release

2 files

0.3.1

2 files

0.3.0

2 files

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