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.

10 个版本 Python >=3.11
homepage
repository
安装
pip install sphinx-reredirects
poetry add sphinx-reredirects
pipenv install sphinx-reredirects
conda install sphinx-reredirects
描述

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:

sphinx-reredirects is MIT licensed.

Icon "route-alt-right" by TabletIcons.

分类
Framework :: Sphinx Framework :: Sphinx :: Extension Intended Audience :: Developers Operating System :: OS Independent Programming Language :: Python :: 3 Programming Language :: Python :: 3.11 Programming Language :: Python :: 3.12 Programming Language :: Python :: 3.13 Topic :: Documentation Topic :: Documentation :: Sphinx Topic :: Software Development :: Documentation Topic :: Utilities
版本列表
1.1.0 2025-12-22
1.0.0 2025-05-31
0.1.6 2025-03-22
0.1.5 2024-07-12
0.1.4 2024-06-21
0.1.3 2023-11-03
0.1.2 2023-05-18
0.1.1 2022-06-09
0.0.1 2021-04-26
0.0.0 2020-09-09