skip to navigation
skip to content

sphinxcontrib-versioning 2.2.1

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

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.
  • Python 2.7, 3.3, 3.4, and 3.5 supported on Windows (both 32 and 64 bit versions of Python).

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

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.2.1 - 2016-12-10

Added
  • Time value of html_last_updated_fmt will be the last git commit (authored) date.
Fixed

2.1.4 - 2016-09-03

Fixed

2.1.3 - 2016-08-24

Fixed
  • Stopped blocking users from overriding their layout.html. Using another approach to inserting the banner.

2.1.2 - 2016-08-24

Fixed
  • Cloning from push remote instead of origin. If HTML files are pushed to another repo other than origin it doesn’t make sense to clone from origin (previous files won’t be available).

2.1.1 - 2016-08-23

Added
  • Command line option: --push-remote
Fixed
  • Copy all remotes from the original repo to the temporarily cloned repo when pushing built docs to a remote. Carries over all remote URLs in case user defines a different URL for push vs fetch.

2.1.0 - 2016-08-22

Added
  • Option to enable warning banner in old/development versions. Similar to Jinja2’s documentation.
  • Command line options: --banner-greatest-tag --banner-recent-tag --show-banner --banner-main-ref
  • Jinja2 context functions: vhasdoc() vpathto()
  • Jinja2 context variables: scv_show_banner scv_banner_greatest_tag scv_banner_main_ref_is_branch scv_banner_main_ref_is_tag scv_banner_main_version scv_banner_recent_tag
Changed
Fixed
Removed
  • Jinja2 context variables: scv_root_ref_is_branch scv_root_ref_is_tag

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.
 
File Type Py Version Uploaded on Size
sphinxcontrib-versioning-2.2.1.tar.gz (md5) Source 2016-12-10 24KB