Skip to main content

Sphinx extension to create tags for documentation pages.

Project description

sphinx-tags sphinx-tags

A tiny Sphinx extension that implements blog-style tags for documentation.

🗣 If you use this extension in your project, please drop us a note in this discussion post

Installation

After activating a virtual environment manager such as venv or conda, use

python -m pip install sphinx-tags

or

conda install sphinx-tags -c conda-forge

Usage

Refer to the documentation for usage instructions.

Contributing

Feel free to submit issues or PRs - keep in mind this project is experimental!

Setup for development

After cloning this repo and activating a virtual environment manager such as venv or conda, use

python -m pip install -e ".[sphinx]"

To build the documentation locally, use

sphinx-build docs docs/_build/html

sphinx-tags uses pre-commit, and code is formatted according to black

Contribution guide

If you want to submit Pull requests to this repository, please follow the contribution guidelines.

Code of Conduct

All contributors and maintainers are expected to follow the PSF Code of Conduct.

Notes

This project is loosely based on this StackOverflow answer.

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

sphinx_tags-0.2.1.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

sphinx_tags-0.2.1-py2.py3-none-any.whl (6.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file sphinx_tags-0.2.1.tar.gz.

File metadata

  • Download URL: sphinx_tags-0.2.1.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for sphinx_tags-0.2.1.tar.gz
Algorithm Hash digest
SHA256 0265b2883889e878167b0b711d5359734f1d7408cbbd0417859989db8f4e3823
MD5 db98641b6ce39a8895238f6a8788cb1a
BLAKE2b-256 c0f17188fe692e9bf5a366ed7d8db975ba2ed5c0dfac5a55892f496c6304140f

See more details on using hashes here.

File details

Details for the file sphinx_tags-0.2.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for sphinx_tags-0.2.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 d1c1ce7fa9589e8c8e3c4c5d6e2ac27a151c1f82fe38388a59743a6bace16bc8
MD5 dc39858989c15f1771ef3eea5fe08925
BLAKE2b-256 31f92527a5f5c8ae78286286e1573baa2722bb317f90e5db4a82675d404fcb4b

See more details on using hashes here.

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