Skip to main content

Sphinx extension that allows building versioned docs for self-hosting.

Project description

Sphinx extension that allows building versioned docs for self-hosting.

  • Python 2.7, 3.3, 3.4, and 3.5 supported on Linux and OS X.

📖 Full documentation: https://robpol86.github.io/sphinxcontrib-versioning

Build Status Coverage Status Latest Version

Quickstart

Install:

pip install sphinxcontrib-versioning

Usage:

sphinx-versioning --help
sphinx-versioning build --help
sphinx-versioning push --help

Changelog

This project adheres to Semantic Versioning.

2.0.0 - 2016-08-15

Added
  • --git-root command line option.

  • --whitelist-branches and --whitelist-tags command line options.

  • --local-conf and --no-local-conf command line options.

  • Load settings from conf.py file and command line arguments instead of just the latter.

Changed
  • Renamed command line option --prioritize to --priority.

  • Renamed command line option -S to -s.

  • --chdir, --no-colors, and --verbose must be specified before build/push and the other after.

  • --sort no longer takes a comma separated string. Now specify multiple times (like --grm-exclude).

  • Renamed --sort value “chrono” to “time”.

  • Reordered positional command line arguments. Moved REL_SOURCE before the destination arguments.

  • Renamed command line option -C to -N for consistency with sphinx-build.

Fixed

1.1.0 - 2016-08-07

Added
  • Exposing Jinja2 context variables: scv_is_branch scv_is_root_ref scv_is_tag scv_root_ref_is_branch scv_root_ref_is_tag scv_is_greatest_tag scv_is_recent_branch scv_is_recent_ref scv_is_recent_tag

Changed
  • Version links point to that version of the current page if it exists there.

Fixed

1.0.1 - 2016-08-02

Fixed

1.0.0 - 2016-07-23

  • Initial release.

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

sphinxcontrib-versioning-2.0.0.tar.gz (21.5 kB view hashes)

Uploaded Source

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