Skip to main content

The extension for Sphinx documentation projects that handle redirects for moved pages. It generates HTML pages with meta refresh redirects to the new page location to prevent 404 errors if you rename or move your documents.

Project description

Project hero image

sphinx-reredirects

The extension for Sphinx documentation projects that handle redirects for moved pages. It generates HTML pages with meta refresh redirects to the new page location to prevent 404 errors if you rename or move your documents.

The sphinx-reredirects started from the urge to manage redirects for all documents after moving our Tech writer at work blog to the new address at https://documatt.com/blog/.

Prevents 404 errors · Wildcard matching · Dynamic placeholders
Cross-domain redirects · Centralized configuration in conf.py
Easy to use · Works seamlessly with Sphinx
📚 Documentation · 📟 Source code

GitHub Repo stars GitHub tests PyPI version PyPI - Python Version MIT licence Nox

Good URLs are never changing URLs. But if you must, sphinx-reredirects helps you manage redirects with ease and from a single place in the project's conf.py.

For example, if you rename document start to intro, and tell it to sphinx-reredirects, it will generate the HTML page start.html with client-side redirect (requires no server-side configuration).

The extension supports wildcards and moving to different domains, too.

Terminal showing cat images.html ( content of generated redirect HTML file)

Community

Connect with other fellows who are building with Sphinx. Share knowledge, get help, and contribute to the open-source project. Check out our Documatt Community page to see featured material and upcoming events.

Join our community here:

Legal

sphinx-reredirects is MIT licensed.

Icon "route-alt-right" by TabletIcons.

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_reredirects-1.1.0.tar.gz (614.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_reredirects-1.1.0-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

Details for the file sphinx_reredirects-1.1.0.tar.gz.

File metadata

  • Download URL: sphinx_reredirects-1.1.0.tar.gz
  • Upload date:
  • Size: 614.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for sphinx_reredirects-1.1.0.tar.gz
Algorithm Hash digest
SHA256 fb9b195335ab14b43f8273287d0c7eeb637ba6c56c66581c11b47202f6718b29
MD5 1a9456ff9d89c292517b8acb199acb0c
BLAKE2b-256 1b8d0e39fe2740d7d71417edf9a6424aa80ca2c27c17fc21282cdc39f90d5a40

See more details on using hashes here.

File details

Details for the file sphinx_reredirects-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sphinx_reredirects-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4b5692273c72cd2d4d917f4c6f87d5919e4d6114a752d4be033f7f5f6310efd9
MD5 7d0a1874abf278239c0c18eb40d86eae
BLAKE2b-256 5181b5dd07067f3daac6d23687ec737b2d593740671ebcd145830c8f92d381c5

See more details on using hashes here.

Supported by

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