Metadata-Version: 2.1
Name: sphinx-versioned-docs
Version: 1.1
Summary: Sphinx extension to build versionsed docs.
Home-page: https://github.com/devanshshukla99/sphinx-versioned-docs
Author: devanshshukla99
Author-email: devanshshukla99@outlook.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: Sphinx :: Extension
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.7
Requires-Dist: GitPython (>=3.1.31)
Requires-Dist: loguru (>=0.7.0)
Requires-Dist: setuptools (>=66.0.0)
Requires-Dist: sphinx (>=4.6.0)
Requires-Dist: typer (>=0.9.0)
Requires-Dist: rich
Provides-Extra: docs
Requires-Dist: sphinx-automodapi (>=0.13) ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'

=====================
sphinx-versioned-docs
=====================

|versions| |license|

|build| |CI themes| |docs| |status| |codestyle|

Sphinx extension that allows building versioned docs for self-hosting.
Supported on Linux and macOS.

It works by producing docs for all(specified) branches in separate folders and injects a readthedocs-like version selector menu/badge.

This project is a fork of `Smile-SA/sphinx-versions <https://github.com/Smile-SA/sphinx-versions>`_ with significant changes.

Get started using the `documentation`_

How to use
==========

.. code:: bash

    sphinx-versioned --help

.. code::

     Usage: sphinx-versioned [OPTIONS]

    ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ --chdir                            TEXT  Make this the current working directory before running. [default: None]             │
    │ --output      -O                   TEXT  Output directory [default: docs/_build]                                             │
    │ --git-root                         TEXT  Path to directory in the local repo. Default is CWD.                                │
    │ --local-conf                       TEXT  Path to conf.py for sphinx-versions to read config from. [default: docs/conf.py]    │
    │ --root-ref    -r                   TEXT  The branch/tag at the root of DESTINATION. Will also be in subdir. [default: main]  │
    │ --prebuild        --no-prebuild          Disables the pre-builds; halves the runtime [default: prebuild]                     │
    │ --branches    -b                   TEXT  Build docs for specific branches and tags [default: None]                           │
    │ --quite           --no-quite             No output from `sphinx` [default: quite]                                            │
    │ --help                                   Show this message and exit.                                                         │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

.. |versions| image:: https://img.shields.io/pypi/pyversions/sphinx-versioned-docs.svg?logo=python&logoColor=FBE072
    :target: https://pypi.org/project/sphinx-versioned-docs/
    :alt: Python versions supported

.. |status| image:: https://img.shields.io/pypi/status/sphinx-versioned-docs.svg
    :target: https://pypi.org/project/sphinx-versioned-docs/
    :alt: Package stability

.. |license| image:: https://img.shields.io/pypi/l/sphinx-versioned-docs 
    :target: https://pypi.org/project/sphinx-versioned-docs/
    :alt: License

.. |build| image:: https://github.com/devanshshukla99/sphinx-versioned-docs/actions/workflows/main.yml/badge.svg
    :alt: CI

.. |codestyle| image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black

.. |docs| image:: https://readthedocs.org/projects/sphinx-versioned-docs/badge/?version=latest
    :target: https://sphinx-versioned-docs.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. |CI themes| image:: https://github.com/devanshshukla99/sphinx-versioned-docs/actions/workflows/CI-themes.yml/badge.svg
    :alt: CI themes

.. _documentation: https://sphinx-versioned-docs.readthedocs.io/en/latest/


