yardang
yardang is a Python library for generating Sphinx documentation easily, with minimal local configuration overhead.
yardang makes building Sphinx easy.
Configuration
Here is yardang's own configuration, in pyproject.toml
[tool.yardang]
root = "docs/src/home.md"
cname = "yardang.python-templates.dev"
pages = [
"docs/src/overview.md",
"docs/src/installation.md",
"docs/src/configuration.md",
]
use-autoapi = true
Installation
You can install from PyPI via pip:
pip install yardang
Or from conda-forge via conda:
conda install yardang -c conda-forge
GitHub Action
A convenient github action is provided to publish documentation automatically in CI.
name: Docs
on:
push:
branches: ["main"]
tags: ["v*"]
workflow_dispatch:
permissions:
contents: write
jobs:
docs:
runs-on: ubuntu-latest
steps:
- uses: actions-ext/yardang@main
with:
token: ${{ secrets.GITHUB_TOKEN }}
[!NOTE] This library was generated using copier from the Base Python Project Template repository.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yardang-0.7.1.tar.gz.
File metadata
- Download URL: yardang-0.7.1.tar.gz
- Upload date:
- Size: 40.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f91c75b5d591f20d0affc18cc4f0b8cc8b5d2d064f4b8b1814189bbba1e3aac2
|
|
| MD5 |
2f8ac8e2efdf9f2f68060c675082172d
|
|
| BLAKE2b-256 |
3aa9236458892db9d977d7e945e70b481f07377eb43a990629e175327ba3dd31
|
File details
Details for the file yardang-0.7.1-py3-none-any.whl.
File metadata
- Download URL: yardang-0.7.1-py3-none-any.whl
- Upload date:
- Size: 46.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e354d2079b6d297532653e0384161501335008947f1742aa3bf9458a5e5f9c60
|
|
| MD5 |
08e34bb5a0f37727c1b0c207ee481763
|
|
| BLAKE2b-256 |
0d9e0fe7668270a1f37dfa00568c1e0e184a5f610f741491b61fd8f4ed4719e1
|
