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
Release files for yardang 0.10.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yardang-0.10.0.tar.gz | 45.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yardang-0.10.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 98.5 kB
Release files / yardang-0.10.0.tar.gz
| Download URL | yardang-0.10.0.tar.gz |
|---|---|
| Size | 45.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
709355dfc5a7a960500af3dc2c78447ddf2ca4d7c20bc70c4267fb8fc15b8571
|
|
BLAKE2b-256 checksum How to use checksums |
eb544714e0bd3ead4dceca997ccddd144ebdd1a94f0a2992a22794d0dfe2713a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / yardang-0.10.0-py3-none-any.whl
| Download URL | yardang-0.10.0-py3-none-any.whl |
|---|---|
| Size | 53.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8cae38fc12bee986441c81ee73ba4bfdbffe36c0870690170a4ebf00c5c4d60f
|
|
BLAKE2b-256 checksum How to use checksums |
33e857e7279d4f1cdbba0ad24e73ad04e8a8f3b23208e7da27400bd63219f997
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
