Skip to main content

A Sphinx extension that inserts a git datestamp into the context as gitstamp, to make it available for template use in HTML versions of your Sphinx documentation.

PyPI version Downloads Code style: Black Parallel Safe

Installing

Directly install via pip by using:

pip install sphinx-gitstamp

Add sphinx_gitstamp to the extensions array in your Sphinx conf.py. For example:

extensions = ['sphinx_gitstamp']

To change the default time format of %b %d, %Y, set the value of gitstamp_fmt in conf.py to the desired time format. For example:

# Date format for git timestamps
gitstamp_fmt = "%Y-%m-%d %H:%M:%S %z"

Add gitstamp to the jinja template, for example:

{%- if gitstamp %} This page was last updated on {{ gitstamp }}. {%- endif %}

Contributing

Pull Requests welcome! See CONTRIBUTING for instructions on how best to contribute.

License

sphinx-gitstamp is made available under a BSD license; see LICENSE for details.

Originally based on the gitstamp generator in the cyrus-imapd project. This product includes software developed by Computing Services at Carnegie Mellon University (http://www.cmu.edu/computing/).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx-gitstamp-0.4.0.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sphinx_gitstamp-0.4.0-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file sphinx-gitstamp-0.4.0.tar.gz.

File metadata

  • Download URL: sphinx-gitstamp-0.4.0.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.26.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10

File hashes

Hashes for sphinx-gitstamp-0.4.0.tar.gz
Algorithm Hash digest
SHA256 ef88b78cba7a1507455f47bbbfc2f073529b3bb2029eef974dbd5357ff9afc49
MD5 519bead7cec598ae15f532a3bac0bf3e
BLAKE2b-256 35bc286392c851b0ce65163b4c4e5bb9bca3b6b33198f990ce9f3756797554a7

See more details on using hashes here.

File details

Details for the file sphinx_gitstamp-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: sphinx_gitstamp-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.26.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10

File hashes

Hashes for sphinx_gitstamp-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c0a32a0033ebeb1b65f6cd41e10a92c16ca4633dbab44e6841016369adab5160
MD5 eef7a1ce397df3815890a7e5f8dd6de0
BLAKE2b-256 5c7e4af3cf990b4cd5df43d764c9474a214537cf0ec5109ec2f6c64121d4ae46

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 files

0.3.3

1 file

0.3.2

1 file

0.3.1

1 file

0.3.0

1 file

0.2.0

1 file

0.1.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page