Skip to main content

Automatic source link generation for mkdocstrings.

Project description

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

Project details


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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page