Skip to main content

A Sphinx extension to manage versioned documentation

Project description

sphinx_versioning

A Sphinx extension to manage versioned documentation.

Overview

sphinx-versioning is a Sphinx extension that manages versioned documentation, allowing users to maintain multiple versions of their documentation with ease. This plugin makes it simple to create, view, and navigate between different versions, providing an enhanced user experience.

Feature

  • Version Creation: Easily create new versions of your documentation with a command-line - interface.

  • Version Deletion: Manage your existing versions, including the ability to delete obsolete ones.

  • Version Navigation: Conveniently navigate between different versions through a drop-down menu.

Installation

pip install sphinx-versioning

Usage

Configuration in Sphinx

  1. In your Sphinx project's conf.py file, add 'sphinx_versioning' to the extensions list:
extensions = [
    ...
    'sphinx_versioning',
    ...
]
  1. Update your conf.py file to include the sphinx_versioning.html template in the html_sidebars configuration:
html_sidebars = {
    '**': [
        # ... other sidebars ...
        'sidebar/sphinx_versioning.html',
    ]
}
  1. If you haven't, set html static path as follow:
html_static_path = ['_static']

Command Line Interface

The sphinx-version command-line tool provides functionality to manage versions:

  • Create a New Version based based the current source file:
sphinx-version --version VERSION_NAME
  • sphinx-version --version VERSION_NAME -d
sphinx-version --version VERSION_NAME -d

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-versioning-0.0.2.tar.gz (4.3 kB view hashes)

Uploaded Source

Built Distribution

sphinx_versioning-0.0.2-py3-none-any.whl (5.0 kB view hashes)

Uploaded Python 3

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