Skip to content

Commit 1fb15c8

Browse files
authored
docs: create README.md
1 parent 7752bb0 commit 1fb15c8

File tree

1 file changed

+79
-0
lines changed

1 file changed

+79
-0
lines changed

README.md

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
<div align="center">
2+
3+
[![sphinx-reredirects](https://github.com/documatt/sphinx-reredirects/blob/main/hero.png?raw=true)](https://documatt.com/sphinx-reredirects)
4+
5+
# sphinx-reredirects
6+
7+
<!-- Major intro -->
8+
**The sphinx-reredirects is 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.**
9+
10+
<!-- Minor intro -->
11+
12+
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/.
13+
14+
<!-- Highlights in points -->
15+
<p>
16+
<em>
17+
Prevents 404 errors
18+
· Wildcard matching
19+
· Dynamic placeholders
20+
</em>
21+
<br />
22+
<em>
23+
Cross-domain redirects
24+
· Centralized configuration in <code>conf.py</code>
25+
</em>
26+
<br />
27+
<em>
28+
Easy to use
29+
· Works seamlessly with Sphinx
30+
</em>
31+
<br />
32+
<em>
33+
<a href="https://documatt.com/sphinx-reredirects">
34+
📚Documentation
35+
</a>
36+
</em>
37+
</p>
38+
39+
<!-- Badges -->
40+
41+
[![GitHub Repo stars](https://img.shields.io/github/stars/documatt/sphinx-reredirects?style=flat&logo=github&labelColor=097cba&color=163B36)](https://github.com/documatt/sphinx-reredirects)
42+
[![GitHub tests](https://github.com/documatt/sphinx-reredirects/actions/workflows/tests.yml/badge.svg)](https://github.com/documatt/sphinx-reredirects/actions/workflows/tests.yml)
43+
[![PyPI version](https://img.shields.io/pypi/v/sphinx-reredirects?labelColor=097cba&color=163B36)](https://pypi.org/project/sphinx-reredirects/)
44+
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sphinx-reredirects?labelColor=097cba&color=163B36)](https://pypi.org/project/sphinx-reredirects/)
45+
[![MIT licence](https://img.shields.io/badge/license-MIT-blue?labelColor=097cba&color=163B36)](https://raw.githubusercontent.com/documatt/sphinx-reredirects/refs/heads/main/LICENSE)
46+
</div>
47+
48+
<!-- Very short intro -->
49+
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`.
50+
51+
For example, if you rename document `start` to `intro`, and tell it to sphinx-reredirects, it will generate the HTML page `start.html` with `<meta http-equiv="refresh" content="0; url=intro.html">`.
52+
53+
The extension supports wildcards and moving to different domains, too.
54+
55+
<!-- Screenshot / video -->
56+
<div align="center">
57+
<img alt="" width="80%" src="https://github.com/documatt/sphinx-reredirects/blob/main/screenshot.png?raw=true">
58+
</div>
59+
60+
## Community
61+
62+
Connect with other fellows who are building with Sphinx. Share knowledge, get help,
63+
and contribute to the open-source project. Check out
64+
our [Documatt Community](https://documatt.com/community) page to see featured material and upcoming events.
65+
66+
Join our community here:
67+
68+
- 🌟 [Explore our GitHub](https://github.com/documatt)
69+
- 📥 [Subscribe to our newsletter](https://documatt.com/newsletter-signup/)
70+
- 🐦 [Follow us on X](https://x.com/documattcom)
71+
- 🕴️ [Follow us on LinkedIn](https://www.linkedin.com/company/documattcom)
72+
- 📺 [Subscribe to our YouTube channel](https://www.youtube.com/@Documatt)
73+
- 📚 [Read our blog posts](https://documatt.com/blog)
74+
75+
## Legal
76+
77+
sphinx-reredirects [MIT licensed](https://raw.githubusercontent.com/documatt/sphinx-reredirects/refs/heads/main/LICENSE).
78+
79+
Icon "route-alt-right" by [TabletIcons](https://tablericons.com/icon/route-alt-right).

0 commit comments

Comments
 (0)