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.0.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

sphinx_tags-0.2.0-py2.py3-none-any.whl (6.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file sphinx-tags-0.2.0.tar.gz.

File metadata

  • Download URL: sphinx-tags-0.2.0.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.28.2

File hashes

Hashes for sphinx-tags-0.2.0.tar.gz
Algorithm Hash digest
SHA256 355fa0f6cf26704f0710047d2f7e8dfd9a5a79f6657f2df5014feecbf259ea04
MD5 abd0bbd1732f37658d2a029713bcf73b
BLAKE2b-256 16caceda81944041338e272a73e3ce8cbe604f314d36c87a3daaac01f97ee194

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for sphinx_tags-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a1200eeedbfef0cb66f27b403cab3101ed75c06e37075bb284cc9dd5e80e8d60
MD5 9a3231bf7a1371738f0a6c04340856fc
BLAKE2b-256 c1c4f3ae36073017087fc08dede91cf58c404478a4f1dd37e0440d59ec647693

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