Automatic source link generation for mkdocstrings.
Project description
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:
- Generating API list
- Using templates and examples
- Importing existing markdown files like README.md
Installation
pip install mkdocstrings-sourcelink
Usage
The usage requires just three steps:
❯ python generate_docs.py❯ mkdocs.yml❯ mkdocs deploy
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mkdocstrings_sourcelink-0.3.0.tar.gz.
File metadata
- Download URL: mkdocstrings_sourcelink-0.3.0.tar.gz
- Upload date:
- Size: 15.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.7.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b45db1984e2fc6c09b957c7c078b764fd296b4c411a0a91a67bde95e3b77e3a6 |
|
| MD5 | 45886752427dae240d0a434e58636692 |
|
| BLAKE2b-256 | 1c2848864e1b02e52631bb25a01f7ba2d258e3494936448b1c7b234119adf797 |
File details
Details for the file mkdocstrings_sourcelink-0.3.0-py3-none-any.whl.
File metadata
- Download URL: mkdocstrings_sourcelink-0.3.0-py3-none-any.whl
- Upload date:
- Size: 13.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.7.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | fbdcad0a8051830dc82b501b5d9c46c2667e2d597dc0b59ffadfff081a2898e3 |
|
| MD5 | 748cfa539e653fcc66e53012f97cede5 |
|
| BLAKE2b-256 | e938e3cb6d757911e72160b238e2ba8aa35be74d766737ef0ae419ca1aeba7a9 |
